org.objectweb.joram.client.jms.soap
Class SoapConnectionFactory

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

All Implemented Interfaces:

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

public class SoapConnectionFactory

extends ConnectionFactory

A SoapConnectionFactory instance is a factory of SOAP connections.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.objectweb.joram.client.jms.ConnectionFactory

params

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

id, instancesTable

Constructor Summary

SoapConnectionFactory()
Constructs an empty SoapConnectionFactory instance.

SoapConnectionFactory(java.lang.String host, int port, int timeout)
Constructs a SoapConnectionFactory instance.

Method Summary

static javax.jms.ConnectionFactory	create(int timeout) Admin method creating a javax.jms.ConnectionFactory instance for creating SOAP connections with the local server.
static javax.jms.ConnectionFactory	create(java.lang.String host, int port, int timeout) Admin method creating a javax.jms.ConnectionFactory instance for creating SOAP connections with a given server.
javax.jms.Connection	createConnection(java.lang.String name, java.lang.String password) Method inherited from the ConnectionFactory class.
java.lang.Object	decode(java.util.Hashtable h) Decodes a SoapConnectionFactory which travelled through the SOAP protocol.
javax.naming.Reference	getReference() Overrides this ConnectionFactory method for constructing the appropriate reference.

Methods inherited from class org.objectweb.joram.client.jms.ConnectionFactory

code, createConnection, getDefaultLogin, getDefaultPassword, getParameters, toString

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

Constructor Detail

SoapConnectionFactory

public SoapConnectionFactory(java.lang.String host,
                             int port,
                             int timeout)

Constructs a SoapConnectionFactory instance.

Parameters:

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

port - Server's listening port.

timeout - Duration in seconds during which a SOAP connection might be inactive before being considered as dead (0 for never).

SoapConnectionFactory

public SoapConnectionFactory()

Constructs an empty SoapConnectionFactory instance.

Method Detail

createConnection

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

Method inherited from the ConnectionFactory class.

Specified by:

createConnection in interface javax.jms.ConnectionFactory

Specified by:

createConnection in class ConnectionFactory

Throws:

JMSSecurityException - If the user identification is incorrect.

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

javax.jms.JMSException

getReference

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

Overrides this ConnectionFactory method for constructing the appropriate reference.

Specified by:

getReference in interface javax.naming.Referenceable

Overrides:

getReference in class ConnectionFactory

Throws:

javax.naming.NamingException

decode

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

Decodes a SoapConnectionFactory which travelled through the SOAP protocol.

Specified by:

decode in interface SoapObjectItf

Overrides:

decode in class ConnectionFactory

create

public static javax.jms.ConnectionFactory create(java.lang.String host,
                                                 int port,
                                                 int timeout)

Admin method creating a javax.jms.ConnectionFactory instance for creating SOAP connections with a given server.

Parameters:

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

port - Server's listening port.

timeout - Duration in seconds during which a SOAP connection might be inactive before being considered as dead (0 for never).

create

public static javax.jms.ConnectionFactory create(int timeout)
                                          throws java.net.ConnectException

Admin method creating a javax.jms.ConnectionFactory instance for creating SOAP connections with the local server.

Parameters:

timeout - Duration in seconds during which a SOAP connection might be inactive before being considered as dead (0 for never).

Throws:

ConnectException - If the admin connection is closed or broken.