Main page -> Midware component reference -> TAppserver
Overview
TAppServer is the communication kernel for all MidWare application servers. This component handle all the communication work for the application server, keeping track of user connections and sessions. A complete application server is made of a TAppserver component, a TRequestBroker (Object Request Broker) component and a set of TServerObject descendent components.
Properties
| Banner |
|
The banner property is the text that is sent to the client when the connection has been established. Default value is 'Welcome to MidWare server'.
|
| ClientCount |
|
Gives the actual number of connected clients.
|
| ClientCountLabel |
|
If assigned, this property will be used by TAppServer component to display the number of client connected.
|
| ClientTimeout |
|
ClientTimeout gives the time in seconds before the server disconnect a client without activity.
|
| ClientWSocket |
|
ClientWSocket is a run-time read-only indexed property whose value is the reference to each connected client TClientWSocket component.
|
| ConnectCount |
|
ConnectCount gives the total number of connection received since server startup.
|
| DisplayMemo |
|
If assigned, this property will be used by TAppServer component to display messages during work.
|
| Handle |
|
The Handle property is the windows handle for the hidden window the component uses for internal messages
|
| Options |
|
Options are used by TAppServer to modify behaviour.
|
| Port |
|
The port property gives the port number or service name used by the server to listen for client connection.
|
| RequestBroker |
|
The server component receive client requests, data parameters and send replies to client.
|
| RequestCount |
|
RequestCount gives the total number of requests received since server startup.
|
| SrvWSocket |
|
SrvWSocket is the underlaying TWSocket component used to listen for for client connections.
|
| Timeoutlnterval |
|
The server periodically check for client timeout.
|
Methods
| DisconnectAll |
|
Disconnect every connected client. Do not confuse with the Stop method.
|
| Start |
|
The start procedure will start the server. The server will accept new client connections. See also Stop.
|
| Stop |
|
The Stop procedure will stop the server which will no more accept new clients, but will not disconnect already connected clients. See also Start.
|
Events
| OnAfterProcessRequest |
|
Occurs when a request has been processed.
|
| OnAfterSendReply |
|
Occurs just after a reply has been sent.
|
| OnBeforeProcessRequest |
|
The OnBeforeProcessRequest event is triggered just before anything is done with a request received from the client.
|
| OnBeforeSendReply |
|
The OnBeforeSendReply event is called when a reply is ready to be transmitted to the client.
|
| OnClientConnected |
|
This event is triggered when a client connect to the server.
|
| OnClientClosed |
|
Occurs when a client disconnect from the server.
|
| OnClientCommand |
|
Clients connects to the server to send commands (also called requests) and wait for server responses.
|
| OnClientTimeout |
|
When a client had no more activity during some time specified by the ClientTimeout property, it is automatically disconnected. If this occurs, the OnClientTimeout event is triggred.
|
| OnClientBgException |
|
Client communication is handled by a TWSocket descendent component which works in the background.
|
| OnDisplay |
|
Sometimes, the server can display some infos about his internal working.
|
| OnServerBgException |
|
The OnBgException event is triggered when an exception occurs in the background (occuring in an event handler called from the message pump).
|
How to
Midware Components Reference
