org.objectweb.joram.client.jms
Class ConnectionFactory

java.lang.Object
  org.objectweb.joram.client.jms.admin.AdministeredObject
      org.objectweb.joram.client.jms.ConnectionFactory

All Implemented Interfaces:

javax.jms.ConnectionFactory, javax.naming.Referenceable, java.io.Serializable, SoapObjectItf

Direct Known Subclasses:

LocalConnectionFactory, QueueConnectionFactory, SoapConnectionFactory, TcpConnectionFactory, TopicConnectionFactory

public abstract class ConnectionFactory

extends AdministeredObject

implements javax.jms.ConnectionFactory

Implements the javax.jms.ConnectionFactory interface.

See Also:

Serialized Form

Field Summary

protected FactoryParameters

params Object containing the factory's parameters.

Fields inherited from class org.objectweb.joram.client.jms.admin.AdministeredObject

id, instancesTable

Constructor Summary

ConnectionFactory()
Constructs an empty ConnectionFactory.

ConnectionFactory(java.lang.String host, int port)
Constructs a ConnectionFactory dedicated to a given server.

Method Summary

java.util.Hashtable	code() Codes a ConnectionFactory as a Hashtable for travelling through the SOAP protocol.
javax.jms.Connection	createConnection() API method.
abstract javax.jms.Connection	createConnection(java.lang.String name, java.lang.String password) API method, implemented according to the communication protocol.
java.lang.Object	decode(java.util.Hashtable h) Implements the decode abstract method defined in the fr.dyade.aaa.jndi2.soap.SoapObjectItf interface.
static java.lang.String	getDefaultLogin() Returns default login name for connection.
static java.lang.String	getDefaultPassword() Returns the default login password for connection.
FactoryParameters	getParameters() Returns the factory's configuration parameters.
javax.naming.Reference	getReference() Sets the naming reference of a connection factory.
java.lang.String	toString() Returns a string view of the connection factory.

Methods inherited from class org.objectweb.joram.client.jms.admin.AdministeredObject

getInstance

Methods inherited from class java.lang.Object

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

Field Detail

params

protected FactoryParameters params

Object containing the factory's parameters.

Constructor Detail

ConnectionFactory

public ConnectionFactory(java.lang.String host,
                         int port)

Constructs a ConnectionFactory dedicated to a given server.

Parameters:

host - Name or IP address of the server's host.

port - Server's listening port.

ConnectionFactory

public ConnectionFactory()

Constructs an empty ConnectionFactory.

Method Detail

toString

public java.lang.String toString()

Returns a string view of the connection factory.

createConnection

public abstract javax.jms.Connection createConnection(java.lang.String name,
                                                      java.lang.String password)
                                               throws javax.jms.JMSException

API method, implemented according to the communication protocol.

Specified by:

createConnection in interface javax.jms.ConnectionFactory

Throws:

JMSSecurityException - If the user identification is incorrect.

java.lang.IllegalStateException - If the server is not listening.

javax.jms.JMSException

getDefaultLogin

public static java.lang.String getDefaultLogin()

Returns default login name for connection. Default value "anonymous" can be adjusted by setting the JoramDfltLogin property.

getDefaultPassword

public static java.lang.String getDefaultPassword()

Returns the default login password for connection. Default value "anonymous" can be adjusted by setting the JoramDfltPassword property.

createConnection

public javax.jms.Connection createConnection()
                                      throws javax.jms.JMSException

API method.

Specified by:

createConnection in interface javax.jms.ConnectionFactory

Throws:

JMSSecurityException - If the default identification is incorrect.

java.lang.IllegalStateException - If the server is not listening.

javax.jms.JMSException

getParameters

public FactoryParameters getParameters()

Returns the factory's configuration parameters.

getReference

public javax.naming.Reference getReference()
                                    throws javax.naming.NamingException

Sets the naming reference of a connection factory.

Specified by:

getReference in interface javax.naming.Referenceable

Overrides:

getReference in class AdministeredObject

Throws:

javax.naming.NamingException

code

public java.util.Hashtable code()

Codes a ConnectionFactory as a Hashtable for travelling through the SOAP protocol.

Specified by:

code in interface SoapObjectItf

Overrides:

code in class AdministeredObject

decode

public java.lang.Object decode(java.util.Hashtable h)

Implements the decode abstract method defined in the fr.dyade.aaa.jndi2.soap.SoapObjectItf interface.

Actual implementation of the method is located in the tcp and soap sub classes.

Specified by:

decode in interface SoapObjectItf