ermi
Interface ERemote

All Known Subinterfaces:
ERegistry

public interface ERemote

The Remote interface serves to identify interfaces whose methods may be invoked from a non-local virtual machine. Any object that is a remote object must directly or indirectly implement this interface. Only those methods specified in a "remote interface", an interface that extends ermi.Remote are available remotely.
The current implementation of ermi does not support inheritance from other remote Interfaces.


Method Summary
 void close()
          Removes all subscriptions for this object and releases event service connection.
 ermi.ERemote copy()
          Returns a reference to a new stub instance of this remote object.
 java.util.Properties getERef()
          Returns a Property object containing the required information to connect to this remote object.
 void init()
          Connects to the event service and creates all subscriptions for this object.
 

Method Detail

getERef

public java.util.Properties getERef()
Returns a Property object containing the required information to connect to this remote object. The information contained in this file includes the event service location, event service factory class, and Object unique id for remote subscriptions.

Returns:
Reference Information for a remote object (connection and subscription information).

close

public void close()
           throws RemoteException
Removes all subscriptions for this object and releases event service connection.
It is highly recommended to call this method on object references that will no longer be used.

Throws:
RemoteException - - if the connection with the event service fails.

init

public void init()
          throws RemoteException
Connects to the event service and creates all subscriptions for this object.

Throws:
RemoteException - - if the connection with the event service fails.

copy

public ermi.ERemote copy()
                  throws RemoteException
Returns a reference to a new stub instance of this remote object. This is mainly used in the pass by reference calls to remote objects. This stub is later initialized (init) when is deserialized in the demanding endpoint.

It is mandatory to call this method when a remote server returns an object by reference. See the ERMI documentation for more information about this.

Throws:
RemoteException - - if the stub cannot be instantiated for any reason (explained in the RemoteException message).