Socket Communication

The Socket Cell implements a Matrix Communication Cell using TCP Sockets.

The Socket Cell provides a communication channel for transferring Matrix Messages over the Network. It encloses the Message to be transferred in a Network Message and delivers it to its destination. The Cell accepts Messages of Type : Matrix.Network.SendMessage It requires Handlers for Type : None

A Hashtable containing the list of Message type this Cell can process

MATRIX INTERNAL FUNCTION - Extracts the incoming messages from the Input Queue, processes them and replies with the generated return values

The Input Message to be processed

MATRIX INTERNAL FUNCTION - Extracts Messages from the response queue and retrieves the return values for synchronous Message transfers

The Response Message to be processed

MATRIX INTERNAL FUNCTION - Logs the Cell into the Matrix registry

This function registers the Cell and makes its services available to the rest of the Application. It runs the Start Function defined by the Cell in a new Thread to allow it to perform initialization operations True if successful

MATRIX INTERNAL FUNCTION - Removes the Cell from the Matrix Registry

True if successful

MATRIX INTERNAL FUNCTION - Accepts a Message and puts it into the Request queue for processing

The incoming Message

MATRIX INTERNAL FUNCTION - Accepts a Message for processing

The incoming Message Defines whether the Message a Request or a Reply True for Response Messages and False for Request Messages

Returns the GUID of the Cell instance

System.Guid holding the Cell's GUID

Determines if the Cell can process a particular MessageType

The MessageType being queried True if the Cell can accept Messages of the specified type False otherwise

Returns the names of all the MessageTypes that the Cell can process

A string array containing the names of all the MessageType the Cell can process

Sends an asyncronous Message to a local Cell

The name of the Message to be sent The arguments to be supplied to the Messsage Handler True if successful

Sends an asynchronous Message to either a local or remote Cell

The name of the Message to be sent The arguments to be supplied to the Messsage Handler The Address of remote Machine to which the Message is to be delivered. An address of "0" will deliver the messsage to the local machine True if successful

Sends a synchronous Message to a local Cell and blocks, waiting for the reply

The name of the Message to be sent The arguments to be supplied to the Messsage Handler An array of objects containing the reply to the request Message

Sends a synchronous Message to either a local or remote Cell and blocks, waiting for the reply

The name of the Message to be sent The arguments to be supplied to the Messsage Handler The Address of remote Machine to which the Message is to be delivered. An address of "0" will deliver the messsage to the local machine An array of objects containing the reply to the request Message

Sends a synchronous Message to either a local or remote Clone Cell and waits for the reply

The name of the Message to be sent The arguments to be supplied to the Messsage Handler The Address of remote Machine to which the Message is to be delivered. An address of "0" will deliver the messsage to the local machine The Clone cell to which the message is to be delivered An array of objects containing the reply to the request Message

Returns a Clone of the MessageHandler Cell for the specified Messagetype

The name of the Message for which a Message Handler is required A Clone of the Message Handler Cell if available Message Handler Cell not Found

Executive function for the Cell. Starts the TCP Server.

Constructor for the SocketComm class.

Processes incoming Messages and returns Response messages if any.

Executive Object containing the Message Call parameters ReturnObject contains the results of the Message processing or Null