ptolemy.distributed.rmi

Class DistributedServerRMIGeneric

java.lang.Object

ptolemy.distributed.rmi.DistributedServerRMIGeneric

All Implemented Interfaces:

java.util.EventListener, net.jini.discovery.DiscoveryListener, net.jini.lookup.ServiceIDListener

public class DistributedServerRMIGeneric
extends java.lang.Object
implements net.jini.lookup.ServiceIDListener, net.jini.discovery.DiscoveryListener

A distributed server to execute ptolemy actors in a distributed manner. It uses Jini as discovery protocol. It performs the following tasks:

• Prepares for discovery of a service locator.
• Loading of various settings as Unicast locators and service class.
• Discovers the service locator (unicast, multicast or both).
• Creates and exports the service proxy (that allows for RMI calls).
• Stays alive.

Since:

Ptolemy II 5.1

Version:

$Id$

Author:

Daniel Lazaro Cuadrado (kapokasa@kom.aau.dk)

Pt.AcceptedRating:

Red (cxh)

Pt.ProposedRating:

Red (kapokasa)

Constructor Summary

Constructors

Constructor and Description
DistributedServerRMIGeneric(java.lang.String configFileName) Construct a DistributedServerRMIGeneric with a configuration file.

Method Summary

Modifier and Type	Method and Description
void	discarded(net.jini.discovery.DiscoveryEvent evt) Called when one or more lookup service registrars has been discarded.
void	discovered(net.jini.discovery.DiscoveryEvent evt) Called when one or more lookup service registrars has been discovered.
static void	main(java.lang.String[] args) Create a new instance of this application, passing it the first command-line argument (configuration file).
void	serviceIDNotify(net.jini.core.lookup.ServiceID serviceID) Required by the ServiceIDListener interface.
void	tryRetrieveServiceId(java.io.File serviceIdFile) Try to load the service ID from file.

Methods inherited from class java.lang.Object

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

Constructor Detail

DistributedServerRMIGeneric

public DistributedServerRMIGeneric(java.lang.String configFileName)

Construct a DistributedServerRMIGeneric with a configuration file. It performs the following tasks:

• Prepares for discovery of a service locator.
• Loading of various settings as Unicast locators and service class.
• Discovers the service locator (unicast, multicast or both).
• Creates and exports the service proxy (that allows for RMI calls).
• Stays alive.

- Prepares for discovery of a service locator: - Loading of various settings as Unicast locators and service class. - Discovers the service locator (unicast, multicast or both). - Creates and exports the service proxy (that allows for RMI calls).

Parameters:

configFileName - The configuration file.

Method Detail

discarded

public void discarded(net.jini.discovery.DiscoveryEvent evt)

Called when one or more lookup service registrars has been discarded. The method should return quickly; e.g., it should not make remote calls.

Specified by:

discarded in interface net.jini.discovery.DiscoveryListener

Parameters:

evt - The event that describes the discovered registrars.

discovered

public void discovered(net.jini.discovery.DiscoveryEvent evt)

Called when one or more lookup service registrars has been discovered. The method should return quickly; e.g., it should not make remote calls.

Specified by:

discovered in interface net.jini.discovery.DiscoveryListener

Parameters:

evt - The event that describes the discovered registrars.

main

public static void main(java.lang.String[] args)

Create a new instance of this application, passing it the first command-line argument (configuration file). It stays alive.

Parameters:

args - The command-line arguments.

serviceIDNotify

public void serviceIDNotify(net.jini.core.lookup.ServiceID serviceID)

Required by the ServiceIDListener interface. Called when the JoinManager gets a valid ServiceID from a lookup service.

Specified by:

serviceIDNotify in interface net.jini.lookup.ServiceIDListener

Parameters:

serviceID - the service ID assigned by the lookup service.

tryRetrieveServiceId

public void tryRetrieveServiceId(java.io.File serviceIdFile)

Try to load the service ID from file. It isn't an error if we can't load it, because maybe this is the first time this service was run.

Parameters:

serviceIdFile - name of the file where the serviceID is stored.