org.exolab.jms.client.net
Class JmsConnectionStubImpl

java.lang.Object
  |
  +--org.exolab.jms.client.net.JmsConnectionStubImpl

All Implemented Interfaces:

ServerConnection

public class JmsConnectionStubImpl

extends java.lang.Object

implements ServerConnection

Wraps a ServerConnection.

Version:

$Revision: 1.5 $ $Date: 2005/11/18 03:29:41 $

Author:

Jim Alateras

Constructor Summary

JmsConnectionStubImpl(ServerConnection connection, org.exolab.jms.net.orb.ORB orb, java.lang.String uri, java.lang.String principal, java.lang.String credentials)
Construct a new JmsConnectionStubImpl.

Method Summary

void	close() Closes the connection.
ServerSession	createSession(int acknowledgeMode, boolean transacted) Create a new session.
java.lang.String	getClientID() Returns the client identifier
long	getConnectionId() Returns the connection identifier
void	setClientID(java.lang.String clientID) Sets the client identifier for this connection.

Methods inherited from class java.lang.Object

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

Constructor Detail

JmsConnectionStubImpl

public JmsConnectionStubImpl(ServerConnection connection,
                             org.exolab.jms.net.orb.ORB orb,
                             java.lang.String uri,
                             java.lang.String principal,
                             java.lang.String credentials)

Construct a new JmsConnectionStubImpl.

Parameters:

connection - the connection to delegate calls to

orb - the ORB to export objects with

uri - the URI to export objects on

principal - the security principal. May be null

credentials - the security credentials. May be null

Method Detail

getConnectionId

public long getConnectionId()
                     throws javax.jms.JMSException

Returns the connection identifier

Specified by:

getConnectionId in interface ServerConnection

Returns:

the connection identifier

Throws:

javax.jms.JMSException - for any JMS error

getClientID

public java.lang.String getClientID()
                             throws javax.jms.JMSException

Returns the client identifier

Specified by:

getClientID in interface ServerConnection

Returns:

the client identifier

Throws:

javax.jms.JMSException - for any JMS error

setClientID

public void setClientID(java.lang.String clientID)
                 throws javax.jms.JMSException

Sets the client identifier for this connection.

Specified by:

setClientID in interface ServerConnection

Parameters:

clientID - the unique client identifier

Throws:

javax.jms.JMSException - if the JMS provider fails to set the client ID for this connection due to some internal error.

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

java.lang.IllegalStateException - if the JMS client attempts to set a connection's client ID at the wrong time or when it has been administratively configured.

createSession

public ServerSession createSession(int acknowledgeMode,
                                   boolean transacted)
                            throws javax.jms.JMSException

Create a new session.

Specified by:

createSession in interface ServerConnection

Parameters:

acknowledgeMode - indicates whether the consumer or the client will acknowledge any messages it receives; ignored if the session is transacted. Legal values are Session.AUTO_ACKNOWLEDGE, Session.CLIENT_ACKNOWLEDGE, and Session.DUPS_OK_ACKNOWLEDGE.

transacted - indicates whether the session is transacted

Returns:

a newly created session

Throws:

javax.jms.JMSException - for any JMS error

close

public void close()
           throws javax.jms.JMSException

Closes the connection.

Specified by:

close in interface ServerConnection

Throws:

javax.jms.JMSException - for any JMS error