org.apache.river.start

Class ServiceStarter

java.lang.Object

org.apache.river.start.ServiceStarter

public class ServiceStarter
extends Object

This class provides the main routine for starting shared groups, non-activatable services, and activatable services. The following implementation-specific items are discussed below:

• Configuring ServiceStarter
• Logging

Configuring ServiceStarter

This implementation of ServiceStarter supports the following configuration entries, with component org.apache.river.start:

•	loginContext
	Type:	LoginContext
	Default:	null
	Description:	If not null, specifies the JAAS login context to use for performing a JAAS login and supplying the Subject to use when running the service starter. If null, no JAAS login is performed.

•	serviceDescriptors
	Type:	ServiceDescriptor[]
	Default: no default
	Description:	Array of service descriptors to start.

Loggers and Logging Levels

The implementation uses the Logger, named org.apache.river.start.service.starter. The following table describes the type of information logged as well as the levels of information logged.

org.apache.river.start.service.starter

Level	Description
SEVERE	for problems that prevent service creation from proceeding
WARNING	for problems with service creation that don't prevent further processing
FINER	for high level service creation operation tracing
FINEST	for low level service creation operation tracing

Since:

2.0

Author:

Sun Microsystems, Inc.

Field Summary

Fields

Modifier and Type	Field and Description
static String	START_PACKAGE Component name for service starter configuration entries

Method Summary

Modifier and Type	Method and Description
static void	ensureSecurityManager() Utility routine that sets a security manager if one isn't already present.
static ActivationSystem	getActivationSystem(String host, int port, Configuration config) Utility routine that returns a "prepared" activation system proxy for a system at the given host and port.
static void	main(Configuration config) The main method for embidding the ServiceStarter application.
static void	main(String[] args) The main method for the ServiceStarter application.

Methods inherited from class java.lang.Object

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

Field Detail

START_PACKAGE

public static final String START_PACKAGE

Component name for service starter configuration entries

See Also:

Constant Field Values

Method Detail

ensureSecurityManager

public static void ensureSecurityManager()

Utility routine that sets a security manager if one isn't already present.

getActivationSystem

public static ActivationSystem getActivationSystem(String host,
                                                   int port,
                                                   Configuration config)
                                            throws ActivationException,
                                                   ConfigurationException

Utility routine that returns a "prepared" activation system proxy for a system at the given host and port.

Parameters:

host - The host of the desired activation system

port - The port of the desired activation system

config - The Configuration used to prepare the system proxy.

Returns:

A prepared activation system proxy

Throws:

ActivationException - If there was a problem communicating with the activation system.

ConfigurationException

See Also:

Configuration

main

public static void main(String[] args)

The main method for the ServiceStarter application. The args argument is passed directly to ConfigurationProvider.getInstance() in order to obtain a Configuration object. This configuration object is then queried for the org.apache.river.start.serviceDescriptors entry, which is assumed to be a ServiceDescriptor[]. The create() method is then called on each of the array elements.

Parameters:

args - String[] passed to ConfigurationProvider.getInstance() in order to obtain a Configuration object.

See Also:

ServiceDescriptor, SharedActivatableServiceDescriptor, SharedActivationGroupDescriptor, NonActivatableServiceDescriptor, Configuration, ConfigurationProvider

main

public static void main(Configuration config)

The main method for embidding the ServiceStarter application. The config argument is queried for the org.apache.river.start.serviceDescriptors entry, which is assumed to be a ServiceDescriptor[]. The create() method is then called on each of the array elements.

Parameters:

config - the Configuration object.

See Also:

ServiceDescriptor, SharedActivatableServiceDescriptor, SharedActivationGroupDescriptor, NonActivatableServiceDescriptor, Configuration