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

public class VinciAnalysisEngineService_impl
extends VinciServableAdapter

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 Classes

Modifier and Type	Class	Description
(package private) static class	VinciAnalysisEngineService_impl.ShutdownHook	Class that handles service shutdowns (including Ctrl-C).

Field Summary

Fields

Modifier and Type	Field	Description
private VinciServer	_server	The server.
private boolean	debug	The debug.
private Descriptor	descriptor	The descriptor.
private AnalysisEngine	mAE	The m AE.
private CasPool	mCasPool	The m cas pool.
private int	serviceInstanceId	The service instance id.

Constructor Summary

Constructors

Constructor	Description
VinciAnalysisEngineService_impl(java.lang.String serviceConfigPath)	Instantiate Analysis Engine service from a given descriptor.
VinciAnalysisEngineService_impl(java.lang.String serviceConfigPath, boolean debug)	Instantiate Analysis Engine service from a given descriptor - possibly in debug mode.
VinciAnalysisEngineService_impl(java.lang.String serviceConfigPath, boolean debug, java.lang.String instanceId)	Instantiate Analysis Engine from a given descriptor, debug mode, and instance Id.

Method Summary

Modifier and Type	Method	Description
private Transportable	analyze(CASTransportable ct)	Analyzes a given document by a AnalysisEngine.
Transportable	eval(Transportable doc)	Main method called by the Vinci Service Layer.
Descriptor	getDescriptor()	Gets the descriptor.
private Frame	getMetaData()	Extracts AE metadata.
static void	main(java.lang.String[] args)	The main method.
Transportable	makeTransportable()	Make transportable.
private static void	redirectLoggerOutput(java.io.OutputStream out)	Redirects all logger output for this JVM to the given output stream.
protected void	start()	Starts this service and associates a ShutdownHook to handle gracefull shutdown.
void	stop()	Terminate this service.

Methods inherited from class org.apache.vinci.transport.VinciServableAdapter

cleanExit

Methods inherited from class java.lang.Object

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

Field Detail

_server

private VinciServer _server

The server.

mAE

private AnalysisEngine mAE

The m AE.

mCasPool

private CasPool mCasPool

The m cas pool.

descriptor

private Descriptor descriptor

The descriptor.

debug

private boolean debug

The debug.

serviceInstanceId

private int serviceInstanceId

The service instance id.

Constructor Detail

VinciAnalysisEngineService_impl

public VinciAnalysisEngineService_impl(java.lang.String serviceConfigPath,
                                       boolean debug,
                                       java.lang.String instanceId)
                                throws java.lang.Exception

Instantiate Analysis Engine from a given descriptor, debug mode, and instance Id.

Parameters:

serviceConfigPath - descriptor location

debug - the debug

instanceId - the instance id

Throws:

java.lang.Exception - passthru

VinciAnalysisEngineService_impl

public VinciAnalysisEngineService_impl(java.lang.String serviceConfigPath,
                                       boolean debug)
                                throws java.lang.Exception

Instantiate Analysis Engine service from a given descriptor - possibly in debug mode.

Parameters:

serviceConfigPath - descriptor location

debug - the debug

Throws:

java.lang.Exception - the exception

VinciAnalysisEngineService_impl

public VinciAnalysisEngineService_impl(java.lang.String serviceConfigPath)
                                throws java.lang.Exception

Instantiate Analysis Engine service from a given descriptor.

Parameters:

serviceConfigPath - descriptor location

Throws:

java.lang.Exception - the exception

Method Detail

getMetaData

private Frame getMetaData()
                   throws java.lang.Exception

Extracts AE metadata.

Returns:

Frame containing extracted meta data

Throws:

java.lang.Exception - the exception

getDescriptor

public Descriptor getDescriptor()

Gets the descriptor.

Returns:

the descriptor

analyze

private Transportable analyze(CASTransportable ct)
                       throws java.lang.Exception

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:

java.lang.Exception - if there is an error during processing

eval

public Transportable eval(Transportable doc)
                   throws ServiceException

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:

eval in interface VinciServable

Specified by:

eval in class VinciServableAdapter

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

public static void main(java.lang.String[] args)

The main method.

Parameters:

args - the arguments

redirectLoggerOutput

private static void redirectLoggerOutput(java.io.OutputStream out)

Redirects all logger output for this JVM to the given output stream.

Parameters:

out - the out

makeTransportable

public Transportable makeTransportable()

Make transportable.

Specified by:

makeTransportable in interface TransportableFactory

Overrides:

makeTransportable in class VinciServableAdapter

Returns:

the transportable

See Also:

TransportableFactory.makeTransportable()