org.exolab.jms.server
Interface ServerConnectionFactory

All Known Subinterfaces:

JmsServerStubIfc, ServerConnectionManager

public interface ServerConnectionFactory

Indicates the methods clients can call on the server-side implementation of the ConnectionFactory interface

Version:

$Revision: 1.1 $ $Date: 2005/03/18 04:07:02 $

Author:

Tim Anderson

Method Summary

ServerConnection

createConnection(java.lang.String clientID, java.lang.String userName, java.lang.String password) Creates a connection with the specified user identity.

Method Detail

createConnection

public ServerConnection createConnection(java.lang.String clientID,
                                         java.lang.String userName,
                                         java.lang.String password)
                                  throws javax.jms.JMSException

Creates a connection with the specified user identity.

The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

If clientID is specified, it indicates the pre-configured client identifier associated with the client ConnectionFactory object.

Parameters:

clientID - the pre-configured client identifier. May be null

userName - the caller's user name

password - the caller's password

Returns:

a newly created connection

Throws:

javax.jms.InvalidClientIDException - if the JMS client specifies an invalid or duplicate client ID.

javax.jms.JMSException - if the JMS provider fails to create the connection due to some internal error.

javax.jms.JMSSecurityException - if client authentication fails due to an invalid user name or password.