Midware TAppServer

From Overbyte
Jump to: navigation, search

Main page -> Midware component reference -> TAppserver

Overview

unit ApServer.pas

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 TClientWSocket 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 Occurs before a client request is processed, just after it has been received.
OnBeforeSendReply Occurs just before a reply is sent to the client.
OnClientConnected Occurs when a client connect to the server.
OnClientClosed Occurs when a client disconnect from the server.
OnClientCommand Occurs when a client's request is received, and before it is processed.
OnClientTimeout Occurs when a client is disconnected because of lack of activity.
OnClientBgException Occurs when an exception is triggered in the background by client socket.
OnDisplay Occurs when server need to display a message.
OnServerBgException Occurs when an exception in server socket occurs in the background.

How to


Midware Components Reference