Package org.apache.uima.adapter.vinci
Class VinciAnalysisEngineService_impl
java.lang.Object
org.apache.vinci.transport.VinciServableAdapter
org.apache.uima.adapter.vinci.VinciAnalysisEngineService_impl
- All Implemented Interfaces:
TransportableFactory,VinciServable
Main class for a Vinci Analysis Engine service. This class can also be used to deploy CAS
Consumers as Vinci services.
The main method takes one argument - the path to the service deployment descriptor.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescription(package private) static classClass that handles service shutdowns (including Ctrl-C). -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate VinciServerThe server.private booleanThe debug.private DescriptorThe descriptor.private AnalysisEngineThe m AE.private CasPoolThe m cas pool.private intThe service instance id. -
Constructor Summary
ConstructorsConstructorDescriptionVinciAnalysisEngineService_impl(String serviceConfigPath) Instantiate Analysis Engine service from a given descriptor.VinciAnalysisEngineService_impl(String serviceConfigPath, boolean debug) Instantiate Analysis Engine service from a given descriptor - possibly in debug mode.VinciAnalysisEngineService_impl(String serviceConfigPath, boolean debug, String instanceId) Instantiate Analysis Engine from a given descriptor, debug mode, and instance Id. -
Method Summary
Modifier and TypeMethodDescriptionprivate TransportableAnalyzes a given document by a AnalysisEngine.eval(Transportable doc) Main method called by the Vinci Service Layer.Gets the descriptor.private FrameExtracts AE metadata.static voidThe main method.Make transportable.private static voidRedirects all logger output for this JVM to the given output stream.protected voidstart()Starts this service and associates a ShutdownHook to handle gracefull shutdown.voidstop()Terminate this service.Methods inherited from class org.apache.vinci.transport.VinciServableAdapter
cleanExit
-
Field Details
-
_server
The server. -
mAE
The m AE. -
mCasPool
The m cas pool. -
descriptor
The descriptor. -
debug
private boolean debugThe debug. -
serviceInstanceId
private int serviceInstanceIdThe service instance id.
-
-
Constructor Details
-
VinciAnalysisEngineService_impl
public VinciAnalysisEngineService_impl(String serviceConfigPath, boolean debug, String instanceId) throws Exception Instantiate Analysis Engine from a given descriptor, debug mode, and instance Id.- Parameters:
serviceConfigPath- descriptor locationdebug- the debuginstanceId- the instance id- Throws:
Exception- passthru
-
VinciAnalysisEngineService_impl
Instantiate Analysis Engine service from a given descriptor - possibly in debug mode.- Parameters:
serviceConfigPath- descriptor locationdebug- the debug- Throws:
Exception- the exception
-
VinciAnalysisEngineService_impl
Instantiate Analysis Engine service from a given descriptor.- Parameters:
serviceConfigPath- descriptor location- Throws:
Exception- the exception
-
-
Method Details
-
getMetaData
Extracts AE metadata.- Returns:
- Frame containing extracted meta data
- Throws:
Exception- the exception
-
getDescriptor
Gets the descriptor.- Returns:
- the descriptor
-
analyze
Analyzes a given document by a AnalysisEngine. When completed this method returns a VinciFrame containing XCAS translated into a set of Vinci subFrames. Each subframe containing one annotation with all its attributes.- Parameters:
ct- the ct- Returns:
- VinciFrame containing XCAS translated into a set of Vinci subframes.
- Throws:
Exception- if there is an error during processing
-
eval
Main method called by the Vinci Service Layer. All requests coming in from clients go through this method. Each request comes in as a VinciFrame and is expected to contain a valid VINCI:COMMAND. Currently, two such operations are supported: 1) Annotate - triggers document analysis 2) GetData - triggers return of the AE meta data ( descriptor)- Specified by:
evalin interfaceVinciServable- Specified by:
evalin classVinciServableAdapter- Parameters:
doc-Transportable- a VinciFrame containing client request- Returns:
Transportable- a VinciFrame containg result of performing the service- Throws:
ServiceException- the service exception
-
start
protected void start()Starts this service and associates a ShutdownHook to handle gracefull shutdown. -
stop
public void stop()Terminate this service. -
main
The main method.- Parameters:
args- the arguments
-
redirectLoggerOutput
Redirects all logger output for this JVM to the given output stream.- Parameters:
out- the out
-
makeTransportable
Make transportable.- Specified by:
makeTransportablein interfaceTransportableFactory- Overrides:
makeTransportablein classVinciServableAdapter- Returns:
- the transportable
- See Also:
-