org.exolab.jms.client.rmi
Class RmiJmsServerStub

java.lang.Object
  org.exolab.jms.client.rmi.RmiJmsServerStub

All Implemented Interfaces:

JmsServerStubIfc

public class RmiJmsServerStub
extends java.lang.Object
implements JmsServerStubIfc

This class is responsible for returning a reference to the remote JMS server.

Version:

$Revision: 1.15 $ $Date: 2003/08/07 13:32:54 $

Author:

Jim Alateras

Constructor Summary

RmiJmsServerStub(java.util.Hashtable environment)
The constructor instantiate server based on the environment variables passed in

Method Summary

JmsConnectionStubIfc	createConnection(java.lang.String id, java.lang.String username, java.lang.String password) Create a connection to the JMS Server.
RemoteJmsServerIfc	getDelegate() This class attempts to return a delegate remote stub to the RMI JMS Server.
javax.jms.ExceptionListener	getExceptionListener() Return a reference to the exception listener
void	setExceptionListener(javax.jms.ExceptionListener listener) Set the exception listener so that the client can be notified of client disconnection events.

Methods inherited from class java.lang.Object

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

Constructor Detail

RmiJmsServerStub

public RmiJmsServerStub(java.util.Hashtable environment)

The constructor instantiate server based on the environment variables passed in

Parameters:

environment - the environment

Method Detail

getDelegate

public RemoteJmsServerIfc getDelegate()
                               throws javax.jms.JMSException

This class attempts to return a delegate remote stub to the RMI JMS Server. If there are any problems creating or returning the singleton then throw JMSException

Returns:

remote reference to stub

Throws:

javax.jms.JMSException - if the stub cannot be obtained

createConnection

public JmsConnectionStubIfc createConnection(java.lang.String id,
                                             java.lang.String username,
                                             java.lang.String password)
                                      throws javax.jms.JMSException

Create a connection to the JMS Server. If one cannot be established then throw JMSException exception

Specified by:

createConnection in interface JmsServerStubIfc

Parameters:

id - identity of client

username - the client username

password - the client password

Returns:

created stub

Throws:

javax.jms.JMSException - if a connection cannot be established

setExceptionListener

public void setExceptionListener(javax.jms.ExceptionListener listener)

Description copied from interface: JmsServerStubIfc

Set the exception listener so that the client can be notified of client disconnection events.

Specified by:

setExceptionListener in interface JmsServerStubIfc

Parameters:

listener - the exception listener

getExceptionListener

public javax.jms.ExceptionListener getExceptionListener()

Return a reference to the exception listener

Parameters:

ExceptionListener -