Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.uima.collection
Class CasConsumer_ImplBase

    java.lang.Object
      org.apache.uima.resource.Resource_ImplBase
          org.apache.uima.resource.ConfigurableResource_ImplBase
              org.apache.uima.collection.CasConsumer_ImplBase

All Implemented Interfaces:
  CasObjectProcessor, CasProcessor, CasConsumer, ConfigurableResource, Resource

    public abstract class CasConsumer_ImplBase

extends ConfigurableResource_ImplBase
implements CasConsumer

Base class for CAS Consumers in UIMA SDK v1.x, which developers should extend with their own CAS Consumer implementation classes. As of v2.0, there is no difference in capability between CAS Consumers and ordinary Analysis Engines, except for the default setting of the XML parameters for multipleDeploymentAllowed and modifiesCas. We recommend for future work that users implement and use Analysis Engine components instead of CAS Consumers.

Field Summary

Fields inherited from interface org.apache.uima.resource.Resource
`PARAM_AGGREGATE_SOFA_MAPPINGS, PARAM_CONFIG_PARAM_SETTINGS, PARAM_PERFORMANCE_TUNING_SETTINGS, PARAM_RESOURCE_MANAGER, PARAM_UIMA_CONTEXT`

Constructor Summary
`CasConsumer_ImplBase()`

Method Summary
`void` | `batchProcessComplete(ProcessTrace arg0)` Completes the processing of a batch.
`void` | `collectionProcessComplete(ProcessTrace arg0)` Completes the processing of an entire collection.
`void` | `destroy()` Releases all resources held by this `Resource`.
`ProcessingResourceMetaData` | `getProcessingResourceMetaData()` Gets the metadata that describes this `CasProcesor`.
`void` | `initialize()` This method is called during initialization, and does nothing by default.
`boolean` | `initialize(ResourceSpecifier aSpecifier, Map aAdditionalParams)` Called by the framework to initialize this CAS Consumer.
`boolean` | `isReadOnly()` Returns true.
`boolean` | `isStateless()` Gets whether this is a stateless CAS Processor.
`void` | `processCas(CAS[] aCASes)` Processes multiple CASes.
`void` | `reconfigure()` Notifies this CAS Consumer that its configuration parameter settings have been changed.
`void` | `typeSystemInit(TypeSystem arg0)` Informs this CasConsumer that the CAS TypeSystem has changed.

Methods inherited from class org.apache.uima.resource.ConfigurableResource_ImplBase
`getConfigParameterValue, getConfigParameterValue, setConfigParameterValue, setConfigParameterValue`

Methods inherited from class org.apache.uima.resource.Resource_ImplBase
`getCasManager, getLogger, getMetaData, getResourceManager, getUimaContext, getUimaContextAdmin, setLogger, setMetaData`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Methods inherited from interface org.apache.uima.resource.ConfigurableResource
`getConfigParameterValue, getConfigParameterValue, setConfigParameterValue, setConfigParameterValue`

Methods inherited from interface org.apache.uima.resource.Resource
`getLogger, getMetaData, getResourceManager, getUimaContext, getUimaContextAdmin, setLogger`

Methods inherited from interface org.apache.uima.collection.base_cpm.CasObjectProcessor
`processCas`

Constructor Detail

### CasConsumer_ImplBase

    public CasConsumer_ImplBase()

Method Detail

### initialize

    public boolean initialize(ResourceSpecifier aSpecifier,
                              Map aAdditionalParams)
                       throws ResourceInitializationException

  Called by the framework to initialize this CAS Consumer. Subclasses should NOT override this method; instead they should override the zero-argument `initialize()` method and access metadata via the `getProcessingResourceMetaData()` method. This method is non-final only for legacy reasons.

  Specified by:
    `initialize` in interface `Resource`
  Overrides:
    `initialize` in class `Resource_ImplBase`
  Parameters:
    `aSpecifier` - specifies how to create a resource or locate an existing resource service.
    `aAdditionalParams` - a Map containing additional parameters. May be `null` if there are no parameters. Each class that implements this interface can decide what additional parameters it supports.
  Returns:
    true if and only if initialization completed successfully. Reutrns false if the given `ResourceSpecifier` is not of an appropriate type for this Resource. If the `ResourceSpecifier` is of an appropriate type but is invalid or if some other failure occurs, an exception should be thrown.
  Throws:
    `ResourceInitializationException` - if a failure occurs during initialization.
  See Also:
    `Resource.initialize(org.apache.uima.resource.ResourceSpecifier, java.util.Map)`

### initialize

    public void initialize()
                    throws ResourceInitializationException

  This method is called during initialization, and does nothing by default. Subclasses should override it to perform one-time startup logic.

  Throws:
    `ResourceInitializationException` - if a failure occurs during initialization.

### destroy

    public void destroy()

  Description copied from interface: `Resource`
  Releases all resources held by this `Resource`.

  Specified by:
    `destroy` in interface `Resource`
  Overrides:
    `destroy` in class `Resource_ImplBase`
  See Also:
    `Resource.destroy()`

### typeSystemInit

    public void typeSystemInit(TypeSystem arg0)
                        throws ResourceInitializationException

  Description copied from interface: `CasObjectProcessor`
  Informs this CasConsumer that the CAS TypeSystem has changed. The CPM calls this method prior to initiating collection processing, and will call it again whenever the CAS TypeSystem changes.

  In this method, the CasConsumer should use the `TypeSystem` to resolve the names of Type and Features to the actual `Type` and `Feature` objects, which can then be used during processing.

  Specified by:
    `typeSystemInit` in interface `CasObjectProcessor`
  Throws:
    `ResourceInitializationException`
  See Also:
    `CasObjectProcessor.typeSystemInit(org.apache.uima.cas.TypeSystem)`

### processCas

    public void processCas(CAS[] aCASes)
                    throws ResourceProcessException

  Description copied from interface: `CasObjectProcessor`
  Processes multiple CASes.

  Specified by:
    `processCas` in interface `CasObjectProcessor`
  Parameters:
    `aCASes` - an array of CASes to be processed. Additional information may be added to these CASes (if this CAS processor is not `read-only`).
  Throws:
    `ResourceProcessException` - if processing fails for any of the CASes
  See Also:
    `CasObjectProcessor.processCas(org.apache.uima.cas.CAS[])`

### isStateless

    public boolean isStateless()

  Description copied from interface: `CasProcessor`
  Gets whether this is a stateless CAS Processor. Stateless CAS Processors do not maintain any data between calls to their process methods.

  Specified by:
    `isStateless` in interface `CasProcessor`
  Returns:
    true if this CAS processor is stateless, false if it is stateful.
  See Also:
    `CasProcessor.isStateless()`

### isReadOnly

    public final boolean isReadOnly()

  Returns true. By contract, CAS Consumers must be read only.

  Specified by:
    `isReadOnly` in interface `CasProcessor`
  Specified by:
    `isReadOnly` in interface `CasConsumer`
  Returns:
    true if this CAS processor does not modify the CAS, false if it does.
  See Also:
    `CasProcessor.isReadOnly()`

### getProcessingResourceMetaData

    public ProcessingResourceMetaData getProcessingResourceMetaData()

  Description copied from interface: `CasProcessor`
  Gets the metadata that describes this `CasProcesor`.

  Specified by:
    `getProcessingResourceMetaData` in interface `CasProcessor`
  Returns:
    an object containing all metadata for this CasProcessor
  See Also:
    `CasProcessor.getProcessingResourceMetaData()`

### batchProcessComplete

    public void batchProcessComplete(ProcessTrace arg0)
                              throws ResourceProcessException,
                                     IOException

  Description copied from interface: `CasProcessor`
  Completes the processing of a batch. A collection may be divided into one or more batches - it is up to the CollectionProcessingManager or the application to determine the number and size of batches.

  Specified by:
    `batchProcessComplete` in interface `CasProcessor`
  Parameters:
    `arg0` - an object that records information, such as timing, about this method's execution.
  Throws:
    `ResourceProcessException` - if an exception occurs during processing
    `IOException` - if an I/O failure occurs
  See Also:
    `CasProcessor.batchProcessComplete(org.apache.uima.util.ProcessTrace)`

### collectionProcessComplete

    public void collectionProcessComplete(ProcessTrace arg0)
                                   throws ResourceProcessException,
                                          IOException

  Description copied from interface: `CasProcessor`
  Completes the processing of an entire collection.

  Specified by:
    `collectionProcessComplete` in interface `CasProcessor`
  Parameters:
    `arg0` - an object that records information, such as timing, about this method's execution.
  Throws:
    `ResourceProcessException` - if an exception occurs during processing
    `IOException` - if an I/O failure occurs
  See Also:
    `CasProcessor.collectionProcessComplete(org.apache.uima.util.ProcessTrace)`

### reconfigure

    public void reconfigure()
                     throws ResourceConfigurationException

  Notifies this CAS Consumer that its configuration parameter settings have been changed. By default this method just calls `destroy()` followed by `initialize()`. CAS Consumers that have expensive initialization that does not need to be redone whenever configuration parameters change may wish to override this method to provide a more efficient implementation.

  Specified by:
    `reconfigure` in interface `ConfigurableResource`
  Overrides:
    `reconfigure` in class `ConfigurableResource_ImplBase`
  Throws:
    `ResourceConfigurationException` - if the configuration is not valid
  See Also:
    `ConfigurableResource_ImplBase.reconfigure()`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

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