org.qbroker.receiver

Class ServerListener

java.lang.Object

org.qbroker.receiver.Receiver

org.qbroker.receiver.ServerListener

All Implemented Interfaces:

MessageReceiver

public class ServerListener
extends Receiver

ServerListener listens to a ServerSocket and accepts socket connections from it. Once there is a new connection, it will check out a thread to handle the authentication on the socket. The thread reads the byte stream, converts them into an ObjectEvent and invokes authentcation method on it. If successful, it sends a response message back to the socket. Before the thread exits, it sets the socket to the event and adds the message to the output XQueue. ServerListener supports flow control and allows object control from its owner. It is fault tolerant with retry and idle options. The maximum number of client connections is determined by both Capacity and Partition of the XQueue. Backlog is the queue length of the server socket listener.

Author:

yannanlu@yahoo.com

Field Summary

Fields inherited from class org.qbroker.receiver.Receiver

capacity, displayMask, linkName, maxRetry, mode, operation, partition, pauseTime, propertyName, propertyValue, repeatPeriod, standbyTime, status, timeout, tolerance, uri, waitTime, xaMode

Fields inherited from interface org.qbroker.receiver.MessageReceiver

RCVR_CLOSED, RCVR_DISABLED, RCVR_PAUSE, RCVR_READY, RCVR_RETRYING, RCVR_RUNNING, RCVR_STANDBY, RCVR_STOPPED

Constructor Summary

Constructors

Constructor and Description
ServerListener(java.util.Map props)

Method Summary

Modifier and Type	Method and Description
void	close() closes all opened resources
protected void	finalize()
void	negotiate(java.util.HashMap client) It reads the first message from the socket, then packages and evalues the message for negotiations.
void	receive(XQueue xq, int baseTime) puts all the received JMS messages to the XQueue as the output.

Methods inherited from class org.qbroker.receiver.Receiver

getCapacity, getLinkName, getName, getOperation, getPartition, getStatus, getXAMode, isStopped, keepRunning, resetStatus, setStatus

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ServerListener

public ServerListener(java.util.Map props)

Method Detail

receive

public void receive(XQueue xq,
                    int baseTime)

Description copied from interface: MessageReceiver

puts all the received JMS messages to the XQueue as the output. In case of failure, it should keep retry with the sleepTime in milliseconds.

Specified by:

receive in interface MessageReceiver

Specified by:

receive in class Receiver

negotiate

public void negotiate(java.util.HashMap client)

It reads the first message from the socket, then packages and evalues the message for negotiations. It generates an ObjectMessage and copies over the properties of the incoming message. It puts the socket into the outgoing ObjectMessage and adds the message to the XQueue. The message flow downstream will pick up the socket and operates on it according to the message properties and the policies.
It is MT-Safe.

close

public void close()

Description copied from interface: MessageReceiver

closes all opened resources

Specified by:

close in interface MessageReceiver

Specified by:

close in class Receiver

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object