agilermi.configuration

Interface StubRetriever

public interface StubRetriever

This interface defines objects that are useful to get RMI stubs. This interface should not be implemented by the developer. The developer should obtain instances of this interface through the RMIRegistry.getStubRetriever() method. Instances of this interface are usually connected to a RMIRegistry instance that they use to retrieve stubs. Instances of this interface can be sent over RMI and they are always replaced with the instance connected to the local RMIRegistry on the receiver machine.

Author:

Salvatore Giampa'

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getStub(java.lang.String address, int port, java.lang.String objectId) Same of the RMIRegistry.getStub(String, int, String) method.
java.lang.Object	getStub(java.lang.String address, int port, java.lang.String objectId, java.lang.Class<?>... stubInterfaces) Same of the RMIRegistry.getStub(String, int, String, Class...)

Method Detail

getStub

java.lang.Object getStub(java.lang.String address,
                         int port,
                         java.lang.String objectId)
                  throws java.io.IOException,
                         java.lang.InterruptedException

Same of the RMIRegistry.getStub(String, int, String) method.

Parameters:

address - the host address

port - the host port

objectId - the object identifier

Returns:

A dynamic proxy object that represents the remote instance. It is an instance for the specified stub interface

Throws:

java.net.UnknownHostException - if the host cannot be resolved

java.io.IOException - if an I/O error occurs

java.lang.InterruptedException - if the current thread is iterrupted during operation

getStub

java.lang.Object getStub(java.lang.String address,
                         int port,
                         java.lang.String objectId,
                         java.lang.Class<?>... stubInterfaces)
                  throws java.io.IOException

Same of the RMIRegistry.getStub(String, int, String, Class...) method.

Parameters:

address - the host address

port - the host port

objectId - the remote object identifier

stubInterfaces - the interfaces implemented by the stub

Returns:

the stub object

Throws:

java.net.UnknownHostException - if the host address cannot be resolved

java.io.IOException - if I/O errors occur