jrun.jms.core.client.rmi
Class RmiJmsConnectionStub

java.lang.Object
  |
  +--jrun.jms.core.client.rmi.RmiJmsConnectionStub

All Implemented Interfaces:

JmsConnectionStubIfc

public class RmiJmsConnectionStub

extends java.lang.Object

implements JmsConnectionStubIfc

This class is repsonsible for returning a reference to a remote JMS connection. If it cannot access get a remote connection then the constructor will fail with a JMSException //* @version $Revision: 1.9 $ $Date: 2001/10/12 07:55:31 $

Version:

$Revision: 1.13 $ $Date: 2002/02/13 22:45:13 $

Author:

Jim Alateras

Field Summary

protected RemoteJmsServerConnectionIfc	_delegate This is a reference to the remote connection stub that is constructed during object initialisation.
protected RmiJmsServerStub	_owner This is a reference to the server stub that created this connection
static int	MAX_RETRY
static int	RETRY_INTERVAL

Constructor Summary

RmiJmsConnectionStub(RemoteJmsServerConnectionIfc connection, int pingInterval, RmiJmsServerStub server)
Instantiate an instance of this class with the specified remote object.

Method Summary

void	close() Close the connection and deallocate any resources.
JmsSessionStubIfc	createSession(int ackMode, boolean transacted) Create a session for the specified client.
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

Field Detail

MAX_RETRY

public static final int MAX_RETRY

RETRY_INTERVAL

public static final int RETRY_INTERVAL

_delegate

protected RemoteJmsServerConnectionIfc _delegate

This is a reference to the remote connection stub that is constructed during object initialisation.

_owner

protected RmiJmsServerStub _owner

This is a reference to the server stub that created this connection

Constructor Detail

RmiJmsConnectionStub

public RmiJmsConnectionStub(RemoteJmsServerConnectionIfc connection,
                            int pingInterval,
                            RmiJmsServerStub server)
                     throws javax.jms.JMSException

Instantiate an instance of this class with the specified remote object. This object is a delegate for all other requests. If a null connection is specified then throw a JMSException exception

Parameters:

RemoteJmsServerConnectionIfc -

pingInterval - interval between client pings

server - the server creating the connection

Throws:

JMSException -

Method Detail

createSession

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

Description copied from interface: JmsConnectionStubIfc

Create a session for the specified client. If it fails then throw the JMSException exception

Specified by:

createSession in interface JmsConnectionStubIfc

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

Parameters:

ackMode - - the session ack mode

transacted - - true if it is a transacted session

Throws:

JMSException -

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 -