public abstract class AnalysisEngineProcessorAdapter extends AnalysisEngineImplBase implements TextAnalysisEngine, CasConsumer
LOG_RESOURCE_BUNDLE, PARAM_VERIFICATION_MODE
MDC_ANNOTATOR_CONTEXT_NAME, MDC_ANNOTATOR_IMPL_NAME, MDC_CAS_ID, MDC_ROOT_CONTEXT_ID, PARAM_CONFIG_PARAM_SETTINGS, PARAM_MBEAN_NAME_PREFIX, PARAM_MBEAN_SERVER, PARAM_NUM_SIMULTANEOUS_REQUESTS, PARAM_RESOURCE_MANAGER, PARAM_THROTTLE_EXCESSIVE_ANNOTATOR_LOGGING, PARAM_TIMEOUT_PERIOD
PARAM_AGGREGATE_SOFA_MAPPINGS, PARAM_CONFIG_MANAGER, PARAM_EXTERNAL_OVERRIDE_SETTINGS, PARAM_PERFORMANCE_TUNING_SETTINGS, PARAM_UIMA_CONTEXT
Constructor and Description |
---|
AnalysisEngineProcessorAdapter() |
Modifier and Type | Method and Description |
---|---|
void |
batchProcessComplete()
Notifies this AnalysisEngine that processing of a batch has completed.
|
void |
collectionProcessComplete()
Notifies this AnalysisEngine that processing of an entire collection has completed.
|
void |
destroy()
Releases all resources held by this
Resource . |
Object |
getConfigParameterValue(String aParamName)
Looks up the value of a configuration parameter.
|
Object |
getConfigParameterValue(String aGroupName,
String aParamName)
Looks up the value of a configuration parameter in a group.
|
ResourceMetaData |
getMetaData()
Gets the metadata that describes this
Resource . |
protected String |
getResourceName()
Gets the name of this resource, for use in logging and trace messages.
|
protected AnalysisEngineProcessorStub |
getStub()
Gets the stub to be used to communicate with the remote service.
|
CasIterator |
processAndOutputNewCASes(CAS aCAS)
Processes a CAS, possibly producing multiple CASes as a result.
|
void |
reconfigure()
Instructs this Resource to re-read its configuration parameter settings.
|
void |
setConfigParameterValue(String aParamName,
Object aValue)
Sets the value of a configuration parameter.
|
void |
setConfigParameterValue(String aGroupName,
String aParamName,
Object aValue)
Sets the value of a configuration parameter in a group.
|
protected void |
setStub(AnalysisEngineProcessorStub aStub)
Sets the stub to be used to actual implementation.
|
batchProcessComplete, buildProcessTraceFromMBeanStats, buildProcessTraceFromMBeanStats, callInitializeMethod, callProcessMethod, collectionProcessComplete, createResultSpecification, createResultSpecification, enterBatchProcessComplete, enterCollectionProcessComplete, enterProcess, exitBatchProcessComplete, exitCollectionProcessComplete, exitProcess, finalize, getAnalysisEngineMetaData, getCurrentConfigParameterSettings, getFeatureNamesForType, getManagementInterface, getMBean, getMBeanNamePrefix, getMBeanServer, getPerformanceTuningSettings, getProcessingResourceMetaData, initialize, isProcessTraceEnabled, isReadOnly, isStateless, newCAS, newJCas, normalizeIsoLangCodes, process, process, process, process, process, process, process, processAndOutputNewCASes, processCas, processCas, resetResultSpecificationToDefault, setMetaData, setPerformanceTuningSettings, setResultSpecification, typeSystemInit
getCasManager, getLogger, getRelativePathResolver, getResourceManager, getUimaContext, getUimaContextAdmin, loadUserClass, loadUserClassOrThrow, setContextHolder, setContextHolderX, setLogger, withContextHolder
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
createResultSpecification, createResultSpecification, getAnalysisEngineMetaData, getFeatureNamesForType, getLogger, getManagementInterface, getPerformanceTuningSettings, getResourceManager, initialize, newCAS, newJCas, process, process, process, process, process, process, process, processAndOutputNewCASes, setLogger, setResultSpecification
getUimaContext, getUimaContextAdmin
processCas, processCas, typeSystemInit
batchProcessComplete, collectionProcessComplete, getProcessingResourceMetaData, isReadOnly, isStateless
isReadOnly
protected void setStub(AnalysisEngineProcessorStub aStub)
initialize
method.aStub
- the stub for the remote serviceprotected AnalysisEngineProcessorStub getStub()
public ResourceMetaData getMetaData()
Resource
Resource
.getMetaData
in interface Resource
getMetaData
in class Resource_ImplBase
Resource.getMetaData()
public void destroy()
Resource
Resource
.destroy
in interface Resource
destroy
in class Resource_ImplBase
Resource.destroy()
public CasIterator processAndOutputNewCASes(CAS aCAS) throws AnalysisEngineProcessException
AnalysisEngine
CasIterator
interface to step through the output CASes.
If this Analysis Engine does not produce output CASes, then the CasIterator
will
return no elements. You can check if an AnalysisEngine is capable of producing output CASes by
checking the
OperationalProperties.getOutputsNewCASes()
operational property
(getAnalysisEngineMetaData().getOperationalProperties().getOutputsNewCASes()
).
Once this method is called, the AnalysisEngine "owns" aCAS
until such time as the
CasIterator.hasNext()
method returns false. That is, the caller should not attempt to
modify or access the input CAS until it has read all of the elements from the CasIterator. If
the caller wants to abort the processing before having read all of the output CASes, it may
call CasIterator.release()
, which will stop further processing from occurring, and
ownership of aCAS
will revert to the caller.
processAndOutputNewCASes
in interface AnalysisEngine
processAndOutputNewCASes
in class AnalysisEngineImplBase
aCAS
- the CAS to be processedAnalysisEngineProcessException
- if a failure occurs during processingpublic void reconfigure() throws ResourceConfigurationException
ConfigurableResource
reconfigure
in interface AnalysisEngine
reconfigure
in interface ConfigurableResource
reconfigure
in class ConfigurableResource_ImplBase
ResourceConfigurationException
- if the configuration is not validConfigurableResource.reconfigure()
public Object getConfigParameterValue(String aGroupName, String aParamName)
ConfigurableResource
This method returns null
if the parameter is optional and has not been assigned a
value. (For mandatory parameters, an exception is thrown during initialization if no value has
been assigned.) This method also returns null
if there is no declared
configuration parameter with the specified name.
getConfigParameterValue
in interface ConfigurableResource
getConfigParameterValue
in class ConfigurableResource_ImplBase
aGroupName
- the name of a configuration group. If the group name is null
, this method
will return the same value as getParameterValue(String)
.aParamName
- the name of a parameter in the groupaGroupName
with name
aParamName
,,null
is either the parameter does not exist or it
has not been assigned a value.ConfigurableResource.getConfigParameterValue(java.lang.String,
java.lang.String)
public Object getConfigParameterValue(String aParamName)
ConfigurableResource
This method returns null
if the parameter is optional and has not been assigned a
value. (For mandatory parameters, an exception is thrown during initialization if no value has
been assigned.) This method also returns null
if there is no declared
configuration parameter with the specified name.
getConfigParameterValue
in interface ConfigurableResource
getConfigParameterValue
in class ConfigurableResource_ImplBase
aParamName
- the name of a parameter that is not in any groupaParamName
, null
is
either the parameter does not exist or it has not been assigned a value.ConfigurableResource.getConfigParameterValue(java.lang.String)
public void setConfigParameterValue(String aParamName, Object aValue)
ConfigurableResource
ConfigurableResource.reconfigure()
is called.setConfigParameterValue
in interface ConfigurableResource
setConfigParameterValue
in class ConfigurableResource_ImplBase
aParamName
- the name of a parameter that is not in any groupaValue
- the value to assign to the parameterConfigurableResource.setConfigParameterValue(java.lang.String,
java.lang.Object)
public void setConfigParameterValue(String aGroupName, String aParamName, Object aValue)
ConfigurableResource
ConfigurableResource.reconfigure()
is called.setConfigParameterValue
in interface ConfigurableResource
setConfigParameterValue
in class ConfigurableResource_ImplBase
aGroupName
- the name of a configuration group. If this parameter is null
, this method
will have the same effect as setParameterValue(String,Object)
.aParamName
- the name of a parameter in the groupaValue
- the value to assign to the parameter.ConfigurableResource.setConfigParameterValue(java.lang.String,
java.lang.String, java.lang.Object)
public void batchProcessComplete() throws AnalysisEngineProcessException
AnalysisEngine
batchProcessComplete
in interface AnalysisEngine
batchProcessComplete
in class AnalysisEngineImplBase
AnalysisEngineProcessException
- if an exception occurs during processingpublic void collectionProcessComplete() throws AnalysisEngineProcessException
AnalysisEngine
If this AnalysisEngine is an aggregate, this method will call the collectionProcessComplete
method of all components of that aggregate. If the aggregate descriptor declares a
fixedFlow
or capabilityLanguageFlow
, then the components'
collectionProcessComplete methods will be called in the order specified by that flow element.
Once all components in the flow have been called, any components not declared in the flow will
be called, in arbitrary order. If there is no fixedFlow
or
capabilityLanguageFlow
, then all components in the aggregate will be called in
arbitrary order.
collectionProcessComplete
in interface AnalysisEngine
collectionProcessComplete
in class AnalysisEngineImplBase
AnalysisEngineProcessException
- if an exception occurs during processingprotected String getResourceName()
Copyright © 2006–2022 The Apache Software Foundation. All rights reserved.