jrun.jms.core.client.mipc
Class IpcJmsConnectionStub

java.lang.Object
  |
  +--jrun.jms.core.client.mipc.IpcJmsConnectionStub

All Implemented Interfaces:

JmsConnectionStubIfc

public class IpcJmsConnectionStub

extends java.lang.Object

implements JmsConnectionStubIfc

Used to create OpenJmsSessions to the server. It gets the new Session Id assigned by the server and returns a IpcJmsSessionStub.

Version:

$Revision: 1.5 $ $Date: 2001/10/24 00:12:47 $

Author:

Jim Mourikis

See Also:

org.exolab.jms.client.mipc.IpcJmsServerStub, org.exolab.jms.client.mipc.IpcJmsSessionStub, org.exolab.core.ipc.Client

Constructor Summary

IpcJmsConnectionStub(IpcIfc connection, java.lang.String clientId, java.lang.String connectionId)
Instantiate an instance of this class with the specified id's.

Method Summary

void	close() Close the connection and deallocate any resources.
JmsSessionStubIfc	createSession(int ackMode, boolean transacted) Send a session connection message.
void	destroy() Release all local resources used by this object.
java.lang.String	getConnectionId() Retrieve the identity of this conection.

Methods inherited from class java.lang.Object

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

Constructor Detail

IpcJmsConnectionStub

public IpcJmsConnectionStub(IpcIfc connection,
                            java.lang.String clientId,
                            java.lang.String connectionId)
                     throws javax.jms.JMSException

Instantiate an instance of this class with the specified id's. These id's are used when creating sessions.

Parameters:

connection - The ipc connection to the server.

clientId - This clients unique id.

connectionId - This objects connection identifier.

Throws:

JMSException - If the connection has failed.

Method Detail

createSession

public JmsSessionStubIfc createSession(int ackMode,
                                       boolean transacted)
                                throws javax.jms.JMSException

Send a session connection message. Create a new IpcJmsSessionStub if this createSession request was successfull.

Specified by:

createSession in interface JmsConnectionStubIfc

Parameters:

ackMode - - the ack mode for the session

transacted - - true if the session is transacted

Returns:

JmsSessionStubIfc The Session interface.

Throws:

JMSException - On failure to create a session.

close

public void close()
           throws javax.jms.JMSException

Description copied from interface: JmsConnectionStubIfc

Close the connection and deallocate any resources. If this method does not complete successfully then throw the JMSException exception

Specified by:

close in interface JmsConnectionStubIfc

Following copied from interface: jrun.jms.core.client.JmsConnectionStubIfc

Throws:

JMSException -

getConnectionId

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

Description copied from interface: JmsConnectionStubIfc

Retrieve the identity of this conection. If this method does not complete successfully then throw JMSException.

Specified by:

getConnectionId in interface JmsConnectionStubIfc

Following copied from interface: jrun.jms.core.client.JmsConnectionStubIfc

Returns:

String

destroy

public void destroy()

Description copied from interface: JmsConnectionStubIfc

Release all local resources used by this object.

Specified by:

destroy in interface JmsConnectionStubIfc

Following copied from interface: jrun.jms.core.client.JmsConnectionStubIfc

Throws:

JMSException -