jade.core
Interface IMTPManager


public interface IMTPManager

Author:
Giovanni Caire - Telecom Italia Lab

Field Summary
static java.lang.String SERVICE_MANAGER_NAME
           
 
Method Summary
 Service.Slice createSliceProxy(java.lang.String serviceName, java.lang.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.
 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(java.lang.String addr)
          Retrieve a proxy to the PlatformManager listening at a given address
 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(java.lang.String addr)
           
 void unexportPlatformManager(PlatformManager sm)
          Stops making the platform Service Manager available through this IMTP.
 

Field Detail

SERVICE_MANAGER_NAME

static final java.lang.String SERVICE_MANAGER_NAME
See Also:
Constant Field Values
Method Detail

initialize

void initialize(Profile p)
                throws IMTPException
Initialize this IMTPManager

Throws:
IMTPException

shutDown

void shutDown()
Release all resources of this IMTPManager


getLocalNode

Node getLocalNode()
                  throws IMTPException
Access the node that represents the local JVM.

Returns:
A Node object, representing the local node of this platform.
Throws:
IMTPException - If something goes wrong in the underlying network transport.

exportPlatformManager

void exportPlatformManager(PlatformManager mgr)
                           throws IMTPException
Makes the platform Service Manager available through this IMTP.

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

void unexportPlatformManager(PlatformManager sm)
                             throws IMTPException
Stops making the platform Service Manager available through this IMTP.

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

getPlatformManagerProxy

PlatformManager getPlatformManagerProxy()
                                        throws IMTPException
Retrieve a proxy to the PlatformManager specified in the local Profile

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

getPlatformManagerProxy

PlatformManager getPlatformManagerProxy(java.lang.String addr)
                                        throws IMTPException
Retrieve a proxy to the PlatformManager listening at a given address

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

reconnected

void reconnected(PlatformManager pm)
Inform the local IMTPManager that this node is now connected to the given PlatformManager


createSliceProxy

Service.Slice createSliceProxy(java.lang.String serviceName,
                               java.lang.Class itf,
                               Node where)
                               throws IMTPException
Builds a proxy object for a remote service slice.

Parameters:
itfs - The array of all the interfaces that have to be implemented by the returned proxy. The first element of the array must be an interface derived from Service.Slice.
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

getLocalAddresses

List getLocalAddresses()
                       throws IMTPException
Return the the List of TransportAddress where this IMTP is waiting for intra-platform remote calls.

Throws:
IMTPException

stringToAddr

TransportAddress stringToAddr(java.lang.String addr)
                              throws IMTPException
Throws:
IMTPException