Rio Project 4.2 API Documentation

org.rioproject.boot
Class ServiceStarter

java.lang.Object
  org.rioproject.boot.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.rioporject.boot:

•	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.rioproject.boot.service.starter. The following table describes the type of information logged as well as the levels of information logged.

org.rioproject.boot.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

Author:

Sun Microsystems, Inc.

Nested Class Summary

static class

ServiceStarter.ServiceReference Object returned by start(java.lang.String...)

Method Summary

static void	main(String[] args) The main method for the ServiceStarter application.
static List<ServiceStarter.ServiceReference>	start(String... args) Start services declared in a configuration.

Methods inherited from class java.lang.Object

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

Method Detail

start

public static List<ServiceStarter.ServiceReference> start(String... args)
                                                   throws Exception

Start services declared in a configuration. 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.rioproject.boot.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.

Returns:

An immutable list of ServiceReference objects, one for each transient service started. If there are no transient services started, a zero-length list is returned. A new list is allocated each time.

Throws:

Exception - If there are errors starting the services

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.rioproject.boot.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:

RioServiceDescriptor, RioActivatableServiceDescriptor, Configuration, ConfigurationProvider