Package jade.imtp.rmi

Class RMIIMTPManager

java.lang.Object

jade.imtp.rmi.RMIIMTPManager

All Implemented Interfaces:

IMTPManager

public class RMIIMTPManager
extends Object
implements IMTPManager

Author:

Giovanni Caire - Telecom Italia Lab, Giovanni Rimassa - FRAMeTech s.r.l.

Field Summary

Fields

Modifier and Type	Field	Description
static String	ENABLE_RMI_LOG	This constant is the name of the property whose boolean value indicates whether or not RMI logs have to be enabled (default false)
static String	LOCAL_NODE_PORT	This constant is the name of the property whose value contains the TCP port where the local RMI Node is to be exported.
static String	LOCAL_SERVICE_MANAGER_PORT	This constant is the name of the property whose value contains the TCP port where a local Service Manager is to be exported (when using JADE fault-tolerant deployment).

Fields inherited from interface jade.core.IMTPManager

SERVICE_MANAGER_NAME

Constructor Summary

Constructors

Constructor	Description
RMIIMTPManager()

Method Summary

Modifier and Type	Method	Description
boolean	compareAddresses(String addr1, String addr2)
Service.Slice	createSliceProxy(String serviceName, Class itf, Node where)	Builds a proxy object for a remote service slice.
void	exportPlatformManager(PlatformManager mgr)	Makes the platform Service Manager available through this IMTP.
RMIClientSocketFactory	getClientSocketFactory()	Creates the client socket factory, which will be used to instantiate a UnicastRemoteObject.
List	getLocalAddresses()	Return the the List of TransportAddress where this IMTP is waiting for intra-platform remote calls.
Node	getLocalNode()	Access the node that represents the local JVM.
PlatformManager	getPlatformManagerProxy()	Retrieve a proxy to the PlatformManager specified in the local Profile
PlatformManager	getPlatformManagerProxy(String addr)	Retrieve a proxy to the PlatformManager listening at a given address
RMIServerSocketFactory	getServerSocketFactory()	Creates the server socket factory, which will be used to instantiate a UnicastRemoteObject.
void	initialize(Profile p)	Initialize this IMTPManager
void	reconnected(PlatformManager pm)	Inform the local IMTPManager that this node is now connected to the given PlatformManager
void	shutDown()	Release all resources of this IMTPManager
TransportAddress	stringToAddr(String url)
void	unexportPlatformManager(PlatformManager mgr)	Stops making the platform Service Manager available through this IMTP.

Methods inherited from class java.lang.Object

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

Field Detail

LOCAL_SERVICE_MANAGER_PORT

public static final String LOCAL_SERVICE_MANAGER_PORT

This constant is the name of the property whose value contains the TCP port where a local Service Manager is to be exported (when using JADE fault-tolerant deployment).

See Also:

Constant Field Values

LOCAL_NODE_PORT

public static final String LOCAL_NODE_PORT

This constant is the name of the property whose value contains the TCP port where the local RMI Node is to be exported.

See Also:

Constant Field Values

ENABLE_RMI_LOG

public static final String ENABLE_RMI_LOG

This constant is the name of the property whose boolean value indicates whether or not RMI logs have to be enabled (default false)

See Also:

Constant Field Values

Constructor Detail

RMIIMTPManager

public RMIIMTPManager()

Method Detail

initialize

public void initialize(Profile p)
                throws IMTPException

Description copied from interface: IMTPManager

Initialize this IMTPManager

Specified by:

initialize in interface IMTPManager

Throws:

IMTPException

exportPlatformManager

public void exportPlatformManager(PlatformManager mgr)
                           throws IMTPException

Description copied from interface: IMTPManager

Makes the platform Service Manager available through this IMTP.

Specified by:

exportPlatformManager in interface IMTPManager

Parameters:

mgr - The ServiceManager implementation that is to be made available across the network.

Throws:

IMTPException - If something goes wrong in the underlying network transport.

unexportPlatformManager

public void unexportPlatformManager(PlatformManager mgr)
                             throws IMTPException

Description copied from interface: IMTPManager

Stops making the platform Service Manager available through this IMTP.

Specified by:

unexportPlatformManager in interface IMTPManager

Throws:

IMTPException - If something goes wrong in the underlying network transport.

getPlatformManagerProxy

public PlatformManager getPlatformManagerProxy()
                                        throws IMTPException

Description copied from interface: IMTPManager

Retrieve a proxy to the PlatformManager specified in the local Profile

Specified by:

getPlatformManagerProxy in interface IMTPManager

Throws:

IMTPException - If something goes wrong in the underlying network transport.

getPlatformManagerProxy

public PlatformManager getPlatformManagerProxy(String addr)
                                        throws IMTPException

Description copied from interface: IMTPManager

Retrieve a proxy to the PlatformManager listening at a given address

Specified by:

getPlatformManagerProxy in interface IMTPManager

Throws:

IMTPException - If something goes wrong in the underlying network transport.

reconnected

public void reconnected(PlatformManager pm)

Description copied from interface: IMTPManager

Inform the local IMTPManager that this node is now connected to the given PlatformManager

Specified by:

reconnected in interface IMTPManager

createSliceProxy

public Service.Slice createSliceProxy(String serviceName,
                                      Class itf,
                                      Node where)
                               throws IMTPException

Description copied from interface: IMTPManager

Builds a proxy object for a remote service slice.

Specified by:

createSliceProxy in interface IMTPManager

Returns:

A proxy object that can be safely casted to any of the interfaces in the itfs array.

Throws:

IMTPException - If something goes wrong in the underlying network transport.

See Also:

Service

getLocalNode

public Node getLocalNode()
                  throws IMTPException

Description copied from interface: IMTPManager

Access the node that represents the local JVM.

Specified by:

getLocalNode in interface IMTPManager

Returns:

A Node object, representing the local node of this platform.

Throws:

IMTPException - If something goes wrong in the underlying network transport.

shutDown

public void shutDown()

Description copied from interface: IMTPManager

Release all resources of this IMTPManager

Specified by:

shutDown in interface IMTPManager

getLocalAddresses

public List getLocalAddresses()
                       throws IMTPException

Description copied from interface: IMTPManager

Return the the List of TransportAddress where this IMTP is waiting for intra-platform remote calls.

Specified by:

getLocalAddresses in interface IMTPManager

Throws:

IMTPException

compareAddresses

public boolean compareAddresses(String addr1,
                                String addr2)
                         throws IMTPException

Throws:

IMTPException

getClientSocketFactory

public RMIClientSocketFactory getClientSocketFactory()

Creates the client socket factory, which will be used to instantiate a UnicastRemoteObject.

Returns:

The client socket factory.

getServerSocketFactory

public RMIServerSocketFactory getServerSocketFactory()

Creates the server socket factory, which will be used to instantiate a UnicastRemoteObject.

Returns:

The server socket factory.

stringToAddr

public TransportAddress stringToAddr(String url)
                              throws IMTPException

Specified by:

stringToAddr in interface IMTPManager

Throws:

IMTPException