weblogic.jms.extensions
Interface ServerSessionPoolListener

All Superinterfaces:

MessageListener

public interface ServerSessionPoolListener
extends MessageListener

Listener interface for MessageListeners used by a ServerSessionPool.

initialize

void initialize(Serializable userData)
                throws JMSException

MessageListeners for a ServerSessionPool are instantiated by the ServerSessionPool (not the client). Client cannot pass parameters into the constructor and access them from the onMessage routine.

This interface allows clients to pass a single parameter to the MessageListener. Specifically, a client must call the createServerSessionPool method from their ServerSessionPoolFactory and pass in the clientData. The clientData must implement the Serializable interface.

Once the ServerSessionPool is created, it checks to see if the MessageListener is a ServerSessionPoolListener. If it is, then the ServerSessionPool calls the intialize method for the listener to pass in the clientData .

The client implementation of the initialize method typically saves a reference to the data for use by the onMessage method.

Parameters:

userData - reference to clientData (can be null)

Throws:

JMSException - if an error occurs.