org.exolab.jms.client.mipc
Class IpcJmsConnectionStub

java.lang.Object
  |
  +--org.exolab.jms.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.8 $ $Date: 2003/08/07 13:32:52 $

Author:

Jim Mourikis

See Also:

IpcJmsServerStub, IpcJmsSessionStub, Client

Constructor Summary

IpcJmsConnectionStub(IpcJmsServerStub server, org.exolab.core.ipc.IpcIfc connection, java.lang.String clientId, java.lang.String connectionId, org.exolab.jms.client.mipc.IpcJmsMessageListener listener)
Construct a new IpcJmsConnectionStub

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(IpcJmsServerStub server,
                            org.exolab.core.ipc.IpcIfc connection,
                            java.lang.String clientId,
                            java.lang.String connectionId,
                            org.exolab.jms.client.mipc.IpcJmsMessageListener listener)

Construct a new IpcJmsConnectionStub

Parameters:

server - the owner of this instance

connection - the connection to the server.

clientId - this client's unique id.

connectionId - this object's connection identifier.

listener - the listener for managing session MessageListeners

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:

javax.jms.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.

Specified by:

close in interface JmsConnectionStubIfc

Following copied from interface: org.exolab.jms.client.JmsConnectionStubIfc

Throws:

javax.jms.JMSException - for any JMS error

getConnectionId

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

Description copied from interface: JmsConnectionStubIfc

Retrieve the identity of this conection.

Specified by:

getConnectionId in interface JmsConnectionStubIfc

Following copied from interface: org.exolab.jms.client.JmsConnectionStubIfc

Returns:

the identity of this conection

Throws:

javax.jms.JMSException - for any JMS error

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: org.exolab.jms.client.JmsConnectionStubIfc

Throws:

javax.jms.JMSException - for any JMS error