de.danet.an.workflow.spis.ras
Class ResourceAssignmentServiceFactory

java.lang.Object
  de.danet.an.workflow.spis.ras.ResourceAssignmentServiceFactory

public abstract class ResourceAssignmentServiceFactory

extends java.lang.Object

Defines a factory API that enables the workflow component to obtain a resource assignment facility.

Constructor Summary

protected

ResourceAssignmentServiceFactory() Constructor.

Method Summary

static ResourceAssignmentServiceFactory	newInstance() Obtain a new instance of a ResourceAssignmentServiceFactory.
abstract ResourceAssignmentService	newResourceAssignmentService() Creates a new instance of a ResourceAssignmentService.

Methods inherited from class java.lang.Object

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

Constructor Detail

ResourceAssignmentServiceFactory

protected ResourceAssignmentServiceFactory()

Constructor. Must be overridden with a parameterless public constructor by derived class.

Method Detail

newInstance

public static ResourceAssignmentServiceFactory newInstance()
                                                    throws FactoryConfigurationError

Obtain a new instance of a ResourceAssignmentServiceFactory. This static method creates a new factory instance. The method uses the following ordered lookup procedure to determine the ResourceAssignmentServiceFactory implementation class to load:

• If an initial naming context is available, look for a a classname in java:comp/env/de.danet.an.workflow.spis.ras.ResourceAssignmentServiceFactory. The configuration for a class as resource assignment service thus looks like:

  <env-entry>
     <description>Configure the resource assignment factory</description>
     <env-entry-name>de.danet.an.workflow.spis.ras.ResourceAssignmentServiceFactory</env-entry-name>
     <env-entry-type>java.lang.String</env-entry-type>
     <env-entry-value>FactoryImplementationClass</env-entry-value>
   </env-entry>

  Note that this environment entry must be inserted in the ejb-jar.xml or web.xml for every EJB resp. servlet that calls the newInstance method of ResourceAssignmentServiceFactory.
• Use the services API (as detailed in the JAR specification), if available, to determine the classname. The Services API will look for a classname in the file META-INF/services/de.danet.an.workflow.spis.ras.ResourceAssignmentServiceFactory. in jars available to the runtime.

Returns:

an instance of the ResourceAssignmentServiceFactory.

Throws:

FactoryConfigurationError - if a factory instance can't be created.

newResourceAssignmentService

public abstract ResourceAssignmentService newResourceAssignmentService()
                                                                throws FactoryConfigurationError

Creates a new instance of a ResourceAssignmentService.

Returns:

the resource assignment service.

Throws:

FactoryConfigurationError - if not all required resources can be obtained.