Package org.djutils.rmi

Class RMITest.Producer

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

org.djutils.rmi.RmiObject

org.djutils.rmi.RMITest.Producer

All Implemented Interfaces:

Serializable, Remote, RMITest.ProducerInterface

Enclosing class:

RMITest

public class RMITest.Producer
extends RmiObject
implements RMITest.ProducerInterface

Producer object.

See Also:

• Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

Constructor Summary

Constructors

Constructor	Description
Producer()	Register the producer on the localhost RMI registry at the default port.
Producer(String host, int port, String bindingKey)	Register this object in the RMI registry.
Producer(URL registryURL, String bindingKey)	Register this object in the RMI registry.

Method Summary

Modifier and Type	Method	Description
void	addListener(RMITest.ListenerInterface listener)	Add a listener to the producer.
protected void	fire(String payload)	Fire a message.

Methods inherited from class org.djutils.rmi.RmiObject

getRegistry, register

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

Producer

public Producer()
         throws RemoteException,
AlreadyBoundException

Register the producer on the localhost RMI registry at the default port.

Throws:

RemoteException - on network error

AlreadyBoundException - on error

Producer

public Producer(String host,
 int port,
 String bindingKey)
         throws RemoteException,
AlreadyBoundException

Register this object in the RMI registry.

Parameters:

host - String; the host where the RMI registry resides or will be created.

port - int; the port where the RMI registry can be found or will be created

bindingKey - the key under which this object will be bound in the RMI registry

Throws:

RemoteException - when there is a problem with the RMI registry

AlreadyBoundException - when there is already another object bound to the bindingKey

NullPointerException - when host, path, or bindingKey is null

IllegalArgumentException - when port < 0 or port > 65535

AccessException - when there is an attempt to create a registry on a remote host

Producer

public Producer(URL registryURL,
 String bindingKey)
         throws RemoteException,
AlreadyBoundException

Register this object in the RMI registry.

Parameters:

registryURL - URL; the URL of the registry, e.g., "http://localhost:1099"

bindingKey - String; the key under which this object will be bound in the RMI registry

Throws:

RemoteException - when there is a problem with the RMI registry

AlreadyBoundException - when there is already another object bound to the bindingKey

NullPointerException - when registryURL or bindingKey is null

AccessException - when there is an attempt to create a registry on a remote host

Method Details

addListener

public void addListener(RMITest.ListenerInterface listener)
                 throws RemoteException

Description copied from interface: RMITest.ProducerInterface

Add a listener to the producer.

Specified by:

addListener in interface RMITest.ProducerInterface

Parameters:

listener - the listener to add

Throws:

RemoteException - on network error

fire

protected void fire(String payload)
             throws RemoteException

Fire a message.

Parameters:

payload - String the payload to send to the listener

Throws:

RemoteException - on network error