Joram ${version}

org.objectweb.joram.client.connector
Class OutboundConnection

java.lang.Object
  extended byorg.objectweb.joram.client.connector.OutboundConnection
All Implemented Interfaces:
javax.jms.Connection
Direct Known Subclasses:
OutboundQueueConnection, OutboundTopicConnection

public class OutboundConnection
extends java.lang.Object
implements javax.jms.Connection

An OutboundConnection instance is a handler for a physical connection to an underlying JORAM server, allowing a component to transparently use this physical connection possibly within a transaction (local or global).


Method Summary
 void cleanup()
          close all session.
 void close()
          Requests to close the physical connection.
 boolean cnxEquals(java.lang.Object obj)
          returns true if the parameter is a Connection instance sharing the same proxy identifier and connection key.
 javax.jms.ConnectionConsumer createConnectionConsumer(javax.jms.Destination destination, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
          Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.
 javax.jms.ConnectionConsumer createDurableConnectionConsumer(javax.jms.Topic topic, java.lang.String subscriptionName, java.lang.String messageSelector, javax.jms.ServerSessionPool sessionPool, int maxMessages)
          Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.
 javax.jms.Session createSession(boolean transacted, int acknowledgeMode)
          Returns the unique authorized JMS session per connection wrapped in an OutboundSession instance.
 java.lang.String getClientID()
          Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.
 javax.jms.ExceptionListener getExceptionListener()
          Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.
 javax.jms.ConnectionMetaData getMetaData()
          Delegates the call to the wrapped JMS connection.
 void setClientID(java.lang.String clientID)
          Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.
 void setExceptionListener(javax.jms.ExceptionListener listener)
          Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.
 void start()
          Delegates the call to the wrapped JMS connection.
 void stop()
          Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Method Detail

setClientID

public void setClientID(java.lang.String clientID)
                 throws javax.jms.JMSException
Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.

Specified by:
setClientID in interface javax.jms.Connection
Throws:
javax.jms.JMSException

setExceptionListener

public void setExceptionListener(javax.jms.ExceptionListener listener)
                          throws javax.jms.JMSException
Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.

Specified by:
setExceptionListener in interface javax.jms.Connection
Throws:
javax.jms.JMSException

createSession

public javax.jms.Session createSession(boolean transacted,
                                       int acknowledgeMode)
                                throws javax.jms.JMSException
Returns the unique authorized JMS session per connection wrapped in an OutboundSession instance.

Specified by:
createSession in interface javax.jms.Connection
Throws:
javax.jms.IllegalStateException - If the handle is invalid.
javax.jms.JMSException - Generic exception.

getClientID

public java.lang.String getClientID()
                             throws javax.jms.JMSException
Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.

Specified by:
getClientID in interface javax.jms.Connection
Throws:
javax.jms.JMSException

getMetaData

public javax.jms.ConnectionMetaData getMetaData()
                                         throws javax.jms.JMSException
Delegates the call to the wrapped JMS connection.

Specified by:
getMetaData in interface javax.jms.Connection
Throws:
javax.jms.IllegalStateException - If the handle is invalid.
javax.jms.JMSException - Generic exception.

getExceptionListener

public javax.jms.ExceptionListener getExceptionListener()
                                                 throws javax.jms.JMSException
Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.

Specified by:
getExceptionListener in interface javax.jms.Connection
Throws:
javax.jms.JMSException

start

public void start()
           throws javax.jms.JMSException
Delegates the call to the wrapped JMS connection.

Specified by:
start in interface javax.jms.Connection
Throws:
javax.jms.IllegalStateException - If the handle is invalid.
javax.jms.JMSException - Generic exception.

stop

public void stop()
          throws javax.jms.JMSException
Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.

Specified by:
stop in interface javax.jms.Connection
Throws:
javax.jms.JMSException

createConnectionConsumer

public javax.jms.ConnectionConsumer createConnectionConsumer(javax.jms.Destination destination,
                                                             java.lang.String messageSelector,
                                                             javax.jms.ServerSessionPool sessionPool,
                                                             int maxMessages)
                                                      throws javax.jms.JMSException
Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.

Specified by:
createConnectionConsumer in interface javax.jms.Connection
Throws:
javax.jms.JMSException

createDurableConnectionConsumer

public javax.jms.ConnectionConsumer createDurableConnectionConsumer(javax.jms.Topic topic,
                                                                    java.lang.String subscriptionName,
                                                                    java.lang.String messageSelector,
                                                                    javax.jms.ServerSessionPool sessionPool,
                                                                    int maxMessages)
                                                             throws javax.jms.JMSException
Forbidden call on an application or component's outbound connection, throws a IllegalStateException instance.

Specified by:
createDurableConnectionConsumer in interface javax.jms.Connection
Throws:
javax.jms.JMSException

close

public void close()
           throws javax.jms.JMSException
Requests to close the physical connection.

Specified by:
close in interface javax.jms.Connection
Throws:
javax.jms.IllegalStateException - If the handle is invalid.
javax.jms.JMSException - Generic exception.

cnxEquals

public boolean cnxEquals(java.lang.Object obj)
returns true if the parameter is a Connection instance sharing the same proxy identifier and connection key.


cleanup

public void cleanup()
close all session.


toString

public java.lang.String toString()

Joram ${version}

Copyright ? 2005 Scalagent - All rights reserved