org.apache.oodt.commons

Class ExecServer

java.lang.Object

org.apache.oodt.commons.ExecServer

public class ExecServer
extends Object

Server execution program. This is an executable class that starts a JPL EDA server.

Author:

Kelly

Field Summary

Fields

Modifier and Type	Field and Description
static String	DISABLE_BINDING Name of the property that prevents binding of this object with the naming service.
static int	MILLIS
protected String	name Object key name.
static String	PRINT_IOR_PROPERTY Name of the property that prints the server's IOR or RMI handle.
static String	STATUS_FPI Status DTD formal public identifier.
static String	STATUS_URL Status DTD system identifier.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ExecServer(String name)
	ExecServer(String name, String className) Create a new executable server.

Method Summary

Modifier and Type	Method and Description
Object	callLocalServerManager(int port, String user, String password, String method, List params) Call the server manager on the local system.
byte[]	control(byte[] command) Control this server.
String	getName() Get my name.
Object	getServant() Return the servant for this executable server.
String	getServerClassName() Return the server's class name.
String	getServerStatus() Return status of this server.
static void	main(String[] argv) Start a server.
static void	runInitializers() Run all initializers.
int	setSystemProperty(String key, String value) Set a system property.
int	shutdown() Shut down and exit.

Methods inherited from class java.lang.Object

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

Field Detail

MILLIS

public static final int MILLIS

See Also:

Constant Field Values

name

protected String name

Object key name.

STATUS_FPI

public static final String STATUS_FPI

Status DTD formal public identifier.

See Also:

Constant Field Values

STATUS_URL

public static final String STATUS_URL

Status DTD system identifier.

See Also:

Constant Field Values

PRINT_IOR_PROPERTY

public static final String PRINT_IOR_PROPERTY

Name of the property that prints the server's IOR or RMI handle.

See Also:

Constant Field Values

DISABLE_BINDING

public static final String DISABLE_BINDING

Name of the property that prevents binding of this object with the naming service.

See Also:

Constant Field Values

Constructor Detail

ExecServer

protected ExecServer(String name)

ExecServer

public ExecServer(String name,
                  String className)
           throws ClassNotFoundException,
                  NoSuchMethodException,
                  InstantiationException,
                  IllegalAccessException,
                  InvocationTargetException,
                  DOMException,
                  UnknownHostException

Create a new executable server.

Parameters:

name - Name of the server

className - Name of class that implements the server.

Throws:

ClassNotFoundException - If the class for className can't be found.

NoSuchMethodException - If the constructor for className taking a single ExecServer can't be found.

InstantiationException - If the class for className is abstract or is an interface.

IllegalAccessException - If the class for className isn't public.

InvocationTargetException - If an exception occurs in the constructor for className.

DOMException - If the server's status document can't be created.

UnknownHostException - If the local host name can't be determined.

Method Detail

main

public static void main(String[] argv)

Start a server. The command-line should have two arguments:

1. The fully-qualified class name of the server to execute.
2. The object name of the server to register with the naming service.

Parameters:

argv - The command-line arguments

getName

public String getName()

Get my name.

Returns:

The name under which I'm registered in teh naming context.

getServant

public Object getServant()

Return the servant for this executable server.

Returns:

The servant.

control

public byte[] control(byte[] command)

Control this server.

Parameters:

command - Command to send to the server.

Returns:

Results of command.

getServerClassName

public String getServerClassName()

Return the server's class name.

Returns:

Its class name.

getServerStatus

public String getServerStatus()

Return status of this server.

Returns:

Its status.

setSystemProperty

public int setSystemProperty(String key,
                             String value)

Set a system property. This uses the property manager to notify property change listeners.

Parameters:

key - Property's name.

value - New value.

Returns:

Zero (return required for XML-RPC access).

callLocalServerManager

public Object callLocalServerManager(int port,
                                     String user,
                                     String password,
                                     String method,
                                     List params)
                              throws IOException,
                                     org.apache.xmlrpc.XmlRpcException

Call the server manager on the local system.

Parameters:

port - What port on the local system the server manager is listening.

user - User name to use for authentication.

password - Authenticator for user.

method - What method in the server manager to call.

params - Parameters to pass to the method named by method.

Returns:

The return value from the method named by method.

Throws:

Exception - If any error occurs.

IOException

org.apache.xmlrpc.XmlRpcException

shutdown

public int shutdown()

Shut down and exit.

Returns:

Zero.

runInitializers

public static void runInitializers()
                            throws EDAException

Run all initializers. This instantiates and calls the Initializer.initialize() method of each initializer specified by class name in a comma separated list of classes in the system properties. The property name is org.apache.oodt.commons.initializers, or if not defined, org.apache.oodt.commons.ExecServer.initializers, or if not defined, initializers. And if that one's not defined, then none are run.

Throws:

EDAException - if an error occurs.