org.apache.uima.resource
Interface ResourceCreationSpecifier

All Superinterfaces:
Cloneable, MetaDataObject, ResourceSpecifier, Serializable, XMLizable
All Known Subinterfaces:
AnalysisEngineDescription, CasConsumerDescription, CasInitializerDescription, CollectionReaderDescription, FlowControllerDescription, TaeDescription

public interface ResourceCreationSpecifier
extends ResourceSpecifier

A ResourceCreationSpecifier is the supertype of AnalysisEngineDescription, CasConsumerDescription, CollectionReaderDescription, and CasInitializerDescription.

All Resource Creation Specifiers must the following:

The following are optional:


Method Summary
 void doFullValidation()
          Does full validation of this specifier.
 void doFullValidation(ResourceManager aResourceManager)
          Does full validation of this specifier.
 ExternalResourceDependency[] getExternalResourceDependencies()
          Retrieves descriptions of this Analysis Engine's dependencies on external resources.
 ExternalResourceDependency getExternalResourceDependency(String aKey)
          Gets the external resource dependency with the given key.
 String getFrameworkImplementation()
          Gets the name of the AE framework implementation within which the CasConsumer executes.
 String getImplementationName()
          Retrieves the name of the CasConsumer implementation.
 ResourceMetaData getMetaData()
          Retrieves the ResourceMetaData to assign to the newly constructed Resource.
 ResourceManagerConfiguration getResourceManagerConfiguration()
          Retrieves the Resource Manager configuration, which declares the resources that satisfy the dependencies defined by getExternalResourceDependencies().
 void setExternalResourceDependencies(ExternalResourceDependency[] aDependencies)
          Sets the descriptions of this AnalysisEngine's dependencies on external resources.
 void setFrameworkImplementation(String aFrameworkImplementation)
          Sets the name of the AE framework implementation within which the CasConsumer executes.
 void setImplementationName(String aImplementationName)
          Sets the name of the CasConsumer implementation.
 void setMetaData(ResourceMetaData aMetaData)
          Sets the MetaData for this ResourceCreationSpecifier.
 void setResourceManagerConfiguration(ResourceManagerConfiguration aResourceManagerConfiguration)
          Sets the Resource Manager configuration, which declares the resources that satisfy the dependencies defined by getExternalResourceDependencies().
 void validate()
          Checks that this specifier is valid.
 void validate(ResourceManager aResourceManager)
          Checks that this specifier is valid.
 
Methods inherited from interface org.apache.uima.resource.metadata.MetaDataObject
clone, equals, getAttributeValue, getSourceUrl, getSourceUrlString, isModifiable, listAttributes, setAttributeValue, setSourceUrl
 
Methods inherited from interface org.apache.uima.util.XMLizable
buildFromXMLElement, buildFromXMLElement, toXML, toXML, toXML, toXML
 

Method Detail

getFrameworkImplementation

String getFrameworkImplementation()
Gets the name of the AE framework implementation within which the CasConsumer executes. The framework name for this implementation is given by Constants.JAVA_FRAMEWORK_NAME..

Returns:
the framework implementation name

setFrameworkImplementation

void setFrameworkImplementation(String aFrameworkImplementation)
Sets the name of the AE framework implementation within which the CasConsumer executes. The framework name for this implementation is given by Constants.JAVA_FRAMEWORK_NAME..

Parameters:
aFrameworkImplementation - the framework implementation name

getImplementationName

String getImplementationName()
Retrieves the name of the CasConsumer implementation. This must be a fully qualified Java class name.

Returns:
the implementation name of the CasConsumer

setImplementationName

void setImplementationName(String aImplementationName)
Sets the name of the CasConsumer implementation. This must be a fully qualified Java class name.

Parameters:
aImplementationName - the implementation name of the CasConsumer

getMetaData

ResourceMetaData getMetaData()
Retrieves the ResourceMetaData to assign to the newly constructed Resource.

Returns:
the metadata for the new resource. This will always be modifiable.

setMetaData

void setMetaData(ResourceMetaData aMetaData)
Sets the MetaData for this ResourceCreationSpecifier.

Parameters:
aMetaData - metadata to assign

getExternalResourceDependencies

ExternalResourceDependency[] getExternalResourceDependencies()
Retrieves descriptions of this Analysis Engine's dependencies on external resources. Each required external resource is assigned a String identifier. This is the identifier that Annotators can use to locate the Resource (using the AnnotatorContext.getResourceObject(String) method).

Returns:
an array of ExternalResourceDependency objects that describe this AnalysisEngine's resource dependencies.

setExternalResourceDependencies

void setExternalResourceDependencies(ExternalResourceDependency[] aDependencies)
Sets the descriptions of this AnalysisEngine's dependencies on external resources.

Parameters:
aDependencies - an array of ExternalResourceDependency objects that describe this AnalysisEngine's resource dependencies.

getExternalResourceDependency

ExternalResourceDependency getExternalResourceDependency(String aKey)
Gets the external resource dependency with the given key.

Parameters:
aKey - the key of the exteranl resource dependency to get
Returns:
the resource dependency with the specified key, null if none.

getResourceManagerConfiguration

ResourceManagerConfiguration getResourceManagerConfiguration()
Retrieves the Resource Manager configuration, which declares the resources that satisfy the dependencies defined by getExternalResourceDependencies().

Returns:
the Resource Manager configuration that describes how external resource dependencies are bound to actual resources.

setResourceManagerConfiguration

void setResourceManagerConfiguration(ResourceManagerConfiguration aResourceManagerConfiguration)
Sets the Resource Manager configuration, which declares the resources that satisfy the dependencies defined by getExternalResourceDependencies().

Parameters:
aResourceManagerConfiguration - the Resource Manager configuration that describes how external resource dependencies are bound to actual resources.

validate

void validate()
              throws ResourceInitializationException,
                     ResourceConfigurationException
Checks that this specifier is valid. An exception is thrown if it is not valid. This only does fairly lightweight checking. To do a more complete but more expensive check, use doFullValidation().

Throws:
ResourceInitializationException - if aDesc is invalid
ResourceConfigurationException - if the configuration parameter settings in aDesc are invalid

validate

void validate(ResourceManager aResourceManager)
              throws ResourceInitializationException,
                     ResourceConfigurationException
Checks that this specifier is valid. An exception is thrown if it is not valid. This only does fairly lightweight checking. To do a more complete but more expensive check, use doFullValidation().

Parameters:
aResourceManager - a ResourceManager instance to use to resolve imports by name.
Throws:
ResourceInitializationException - if aDesc is invalid
ResourceConfigurationException - if the configuration parameter settings in aDesc are invalid

doFullValidation

void doFullValidation()
                      throws ResourceInitializationException
Does full validation of this specifier. This essentially performs all operations necessary to instantiate a Resource except that it does not actually instantiate the implementation class. If appropriate, this method will also attempt to create a CAS based on the descriptor, in order to do full type system verification. If any operations fail, an exception will be thrown.

Throws:
ResourceInitializationException - if validation failed

doFullValidation

void doFullValidation(ResourceManager aResourceManager)
                      throws ResourceInitializationException
Does full validation of this specifier. This essentially performs all operations necessary to instantiate a Resource except that it does not actually instantiate the implementation class. If appropriate, this method will also attempt to create a CAS based on the descriptor, in order to do full type system verification. If any operations fail, an exception will be thrown.

Parameters:
aResourceManager - a ResourceManager instance to use to load annotator classes, external resource classes, and resolve imports by name.
Throws:
ResourceInitializationException - if validation failed


Copyright © 2007 The Apache Software Foundation. All Rights Reserved.