dermi
Interface ERemote

All Known Subinterfaces:

Activator, DOLRChannel, EInterceptor

All Known Implementing Classes:

ActivatorImpl, DOLRChannelImpl

public interface ERemote

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

Version:

1.2

Author:

Carles Pairot , Pedro Garcia

Method Summary

void	close() It removes all subscriptions for this object and releases the event service connection.
ERemote	copy() This method returns a reference to a new stub instance of this remote object.
java.util.Properties	getERef() This method returns a property object containing the required information to connect to this remote object.
void	init() It connects to the event service and creates all subscriptions for this object.

Method Detail

getERef

java.util.Properties getERef()

This method 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's unique ID for remote subscriptions.

Returns:

Properties Reference information for a remote object (connection and subscription information).

close

void close()
           throws RemoteException

It removes all subscriptions for this object and releases the 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

void init()
          throws RemoteException

It connects to the event service and creates all subscriptions for this object.

Throws:

RemoteException - If the connection with the event service fails.

copy

ERemote copy()
             throws RemoteException

This method 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 it is deserialized in the demanding endpoint.

It is mandatory to call this method when a remote server returns an object by reference.

Throws:

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