org.ogf.saga.bootstrap
Class ImplementationBootstrapLoader

java.lang.Object
  org.ogf.saga.bootstrap.ImplementationBootstrapLoader

public class ImplementationBootstrapLoader
extends Object

This class allows the user to have one or more SagaFactories, one for each Java Saga implementation that is to be used. A SagaFactory must be used to actually create Saga objects. All factory creation methods have an optional parameter, the classname of the Saga factory. When this parameter is not specified, a default Saga factory is used.

The classname of the default Saga factory is to be provided by the the environment variable (Java property) saga.factory.

The ImplementationBootstrapLoader instantiates exactly one instance of each Saga factory classname. A Saga factory must have a public parameter-less constructor.

Method Summary

static BufferFactory	getBufferFactory(String factoryName) Creates a buffer factory, using the specified SagaFactory.
static ContextFactory	getContextFactory(String factoryName) Creates a context factory, using the specified SagaFactory.
static FileFactory	getFileFactory(String factoryName) Creates a file factory, using the specified SagaFactory.
static ISNFactory	getISNFactory(String factoryName) Creates a ISN factory for the Information System Navigator, using the specified SagaFactory.
static JobFactory	getJobFactory(String factoryName) Creates a job factory, using the specified SagaFactory.
static LogicalFileFactory	getLogicalFileFactory(String factoryName) Creates a logical file factory, using the specified SagaFactory.
static MonitoringFactory	getMonitoringFactory(String factoryName) Creates a monitoring factory, using the specified SagaFactory.
static NSFactory	getNamespaceFactory(String factoryName) Creates a namespace factory, using the specified SagaFactory.
static RPCFactory	getRPCFactory(String factoryName) Creates an RPC factory, using the specified SagaFactory.
static SDFactory	getSDFactory(String factoryName) Creates a SD factory for Service Discovery, using the specified SagaFactory.
static SessionFactory	getSessionFactory(String factoryName) Creates a session factory, using the specified SagaFactory.
static StreamFactory	getStreamFactory(String factoryName) Creates a stream factory, using the specified SagaFactory.
static TaskFactory	getTaskFactory(String factoryName) Creates a task factory, using the specified SagaFactory.
static URLFactory	getURLFactory(String factoryName) Creates an URL factory, using the specified SagaFactory.

Methods inherited from class java.lang.Object

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

Method Detail

getBufferFactory

public static BufferFactory getBufferFactory(String factoryName)
                                      throws NoSuccessException

Creates a buffer factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a buffer factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

getContextFactory

public static ContextFactory getContextFactory(String factoryName)
                                        throws NoSuccessException

Creates a context factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a context factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

getSessionFactory

public static SessionFactory getSessionFactory(String factoryName)
                                        throws NoSuccessException

Creates a session factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a session factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

getFileFactory

public static FileFactory getFileFactory(String factoryName)
                                  throws NoSuccessException

Creates a file factory, using the specified SagaFactory. This method annot throw NotImplemented, because the IOVec constructor cannot (according to the SAGA specs).

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a file factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

getJobFactory

public static JobFactory getJobFactory(String factoryName)
                                throws NotImplementedException,
                                       NoSuccessException

Creates a job factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a job factory.

Throws:

NotImplementedException - is thrown when jobs are not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

getLogicalFileFactory

public static LogicalFileFactory getLogicalFileFactory(String factoryName)
                                                throws NotImplementedException,
                                                       NoSuccessException

Creates a logical file factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a logical file factory.

Throws:

NotImplementedException - is thrown when logical files are not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

getMonitoringFactory

public static MonitoringFactory getMonitoringFactory(String factoryName)
                                              throws NotImplementedException,
                                                     NoSuccessException

Creates a monitoring factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a monitoring factory.

Throws:

NotImplementedException - is thrown when monitoring is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

getNamespaceFactory

public static NSFactory getNamespaceFactory(String factoryName)
                                     throws NotImplementedException,
                                            NoSuccessException

Creates a namespace factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a namespace factory.

Throws:

NotImplementedException - is thrown when namespace is not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

getRPCFactory

public static RPCFactory getRPCFactory(String factoryName)
                                throws NoSuccessException,
                                       NotImplementedException

Creates an RPC factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

an RPC factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

NotImplementedException

NotImplementedException - is thrown when RPC is not implemented.

getStreamFactory

public static StreamFactory getStreamFactory(String factoryName)
                                      throws NotImplementedException,
                                             NoSuccessException

Creates a stream factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a stream factory.

Throws:

NotImplementedException - is thrown when streams are not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

getTaskFactory

public static TaskFactory getTaskFactory(String factoryName)
                                  throws NotImplementedException,
                                         NoSuccessException

Creates a task factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a task factory.

Throws:

NotImplementedException - is thrown when tasks are not implemented.

NoSuccessException - is thrown when the Saga factory could not be created.

getURLFactory

public static URLFactory getURLFactory(String factoryName)
                                throws NoSuccessException

Creates an URL factory, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

an URL factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

getSDFactory

public static SDFactory getSDFactory(String factoryName)
                              throws NotImplementedException,
                                     NoSuccessException

Creates a SD factory for Service Discovery, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

a SD factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

NotImplementedException - is thrown when SD is not implemented.

getISNFactory

public static ISNFactory getISNFactory(String factoryName)
                                throws NotImplementedException,
                                       NoSuccessException

Creates a ISN factory for the Information System Navigator, using the specified SagaFactory.

Parameters:

factoryName - classname of the Saga factory to be used, or null.

Returns:

an ISN factory.

Throws:

NoSuccessException - is thrown when the Saga factory could not be created.

NotImplementedException - is thrown when ISN is not implemented.