com.ls.lars.communication
Class RMIConnector
java.lang.Object
|
+--java.rmi.server.RemoteObject
|
+--java.rmi.server.RemoteServer
|
+--java.rmi.server.UnicastRemoteObject
|
+--com.ls.lars.communication.RMIConnector
- All Implemented Interfaces:
- IRMIConnector, Remote, Serializable
- public class RMIConnector
- extends UnicastRemoteObject
- implements IRMIConnector
This Class is running on the platform and builds the connection between a
remote agent and the platform using RMI. The function included in this class will be
called remote from the remote agent.
- Version:
- $Revision: 1.7 $
- Author:
- Last modified by $Author: ODrugan $
- See Also:
- Serialized Form
Constructor Summary |
RMIConnector(com.ls.lars.communication.RMIMessenger rmiMessenger)
Sets the message router to the local message router from the platform |
Method Summary |
void |
closeConnection()
closes the remote connection that the remote object can unbind itself from rmi registry |
void |
pushMessageToRemoteSide(Message message)
Transfers a message to the remote side. |
void |
securityCheck(String clientIpAddress,
String clientAgentName)
checks the permission to connect for the specified agent from the given IP address |
void |
setCallbackReference(IRMIConnector reference)
The object referenze of a RMI object is set thus callbacks can be done. |
void |
verifyConnectionStatus()
This method will be called by the 'remote' side in order to verify the
current connection status
Note: This method returns nothing, as the success of this method
depends on the fact whether or not the caller catches a RemoteException. |
RMIConnector
public RMIConnector(com.ls.lars.communication.RMIMessenger rmiMessenger)
throws RemoteException
- Sets the message router to the local message router from the platform
- Parameters:
rmiMessenger
- - Throws:
RemoteException
- if remote method invocation fails
securityCheck
public void securityCheck(String clientIpAddress,
String clientAgentName)
throws ConnectionException
- checks the permission to connect for the specified agent from the given IP address
- Specified by:
securityCheck
in interface IRMIConnector
- Parameters:
clientIpAddress
- ip address of the agentclientAgentName
- name of the agent- Throws:
ConnectionException
- If the security check fails
setCallbackReference
public void setCallbackReference(IRMIConnector reference)
throws RemoteException
- The object referenze of a RMI object is set thus callbacks can be done.
- Specified by:
setCallbackReference
in interface IRMIConnector
- Parameters:
reference
- object reference used with callbacks- Throws:
RemoteException
- If remote method invocation fails
pushMessageToRemoteSide
public void pushMessageToRemoteSide(Message message)
throws RemoteException
- Transfers a message to the remote side.
- Specified by:
pushMessageToRemoteSide
in interface IRMIConnector
- Parameters:
message
- message to be sent- Throws:
RemoteException
- If remote method invocation fails
closeConnection
public void closeConnection()
- closes the remote connection that the remote object can unbind itself from rmi registry
- Specified by:
closeConnection
in interface IRMIConnector
- Following copied from interface:
com.ls.lars.communication.IRMIConnector
- Throws:
RemoteException
- if remote method invocation fails
verifyConnectionStatus
public void verifyConnectionStatus()
throws RemoteException
- This method will be called by the 'remote' side in order to verify the
current connection status
Note: This method returns nothing, as the success of this method
depends on the fact whether or not the caller catches a RemoteException.
- Specified by:
verifyConnectionStatus
in interface IRMIConnector
- Throws:
RemoteException
- If the the verification fails