Package org.apache.uima.adapter.vinci

Class CASTransportable

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.uima.adapter.vinci.CASTransportable

All Implemented Interfaces:

Transportable, ContentHandler, DTDHandler, EntityResolver, ErrorHandler

public class CASTransportable
extends DefaultHandler
implements Transportable

Field Summary

Fields

Modifier and Type	Field	Description
boolean	ignoreResponse
boolean	includeDocText
UimaContext	uimaContext

Constructor Summary

Constructors

Constructor	Description
CASTransportable(CAS cas, OutOfTypeSystemData outOfTypeSystemData, UimaContext uimaContext, boolean includeDocText)	This constructor is used on the client side, where we have a dedicated CAS instance for the request.
CASTransportable(CasPool casPool, OutOfTypeSystemData outOfTypeSystemData, UimaContext uimaContext, boolean includeDocText)	This constructor is used on the service side - a CAS Pool reference is provided.

Method Summary

Modifier and Type	Method	Description
void	characters(char[] ch, int start, int length)
void	cleanup()
void	endDocument()
void	endElement(String uri, String name, String qName)
protected void	finalize()
KeyValuePair	fromStream(InputStream is)	Read the object from the input stream.
CAS	getCas()	Gets the cas.
String	getCommand()	Gets the command.
VinciFrame	getExtraDataFrame()	Gets the extra data frame.
OutOfTypeSystemData	getOutOfTypeSystemData()	Gets the out of type system data.
void	setCommand(String command)	Sets the command.
void	startDocument()
void	startElement(String uri, String name, String qName, Attributes atts)
void	toStream(OutputStream os)	Serialize the CAS to the stream in XTalk format.
SAXException	wrapAsSAXException(IOException e)	Create a SAXException that wraps the given IOException.

Methods inherited from class org.xml.sax.helpers.DefaultHandler

endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.xml.sax.ContentHandler

declaration

Field Details

uimaContext

public UimaContext uimaContext

includeDocText

public boolean includeDocText

ignoreResponse

public boolean ignoreResponse

Constructor Details

CASTransportable

public CASTransportable(CasPool casPool,
 OutOfTypeSystemData outOfTypeSystemData,
 UimaContext uimaContext,
 boolean includeDocText)

This constructor is used on the service side - a CAS Pool reference is provided. We don't check a CAS out of the pool until we get a request.

Parameters:

casPool - the cas pool

outOfTypeSystemData - the out of type system data

uimaContext - the uima context

includeDocText - the include doc text

CASTransportable

public CASTransportable(CAS cas,
 OutOfTypeSystemData outOfTypeSystemData,
 UimaContext uimaContext,
 boolean includeDocText)

This constructor is used on the client side, where we have a dedicated CAS instance for the request.

Parameters:

cas - the cas

outOfTypeSystemData - the out of type system data

uimaContext - the uima context

includeDocText - the include doc text

Method Details

getExtraDataFrame

public VinciFrame getExtraDataFrame()

Gets the extra data frame.

Returns:

the extra data frame

getOutOfTypeSystemData

public OutOfTypeSystemData getOutOfTypeSystemData()

Gets the out of type system data.

Returns:

the out of type system data

getCommand

public String getCommand()

Gets the command.

Returns:

the command

setCommand

public void setCommand(String command)

Sets the command.

Parameters:

command - the new command

getCas

public CAS getCas()

Gets the cas.

Returns:

the cas

fromStream

public KeyValuePair fromStream(InputStream is)
                        throws IOException

Description copied from interface: Transportable

Read the object from the input stream.

Specified by:

fromStream in interface Transportable

Parameters:

is - The stream to read from.

Returns:

-

Throws:

IOException - -

toStream

public void toStream(OutputStream os)
              throws IOException

Serialize the CAS to the stream in XTalk format. After serialization is complete the cas is returned to the pool (if it was allocated from a pool.)

Specified by:

toStream in interface Transportable

Parameters:

os - the os

Throws:

IOException - Signals that an I/O exception has occurred.

cleanup

public void cleanup()

finalize

protected void finalize()

Overrides:

finalize in class Object

startElement

public void startElement(String uri,
 String name,
 String qName,
 Attributes atts)
                  throws SAXException

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class DefaultHandler

Throws:

SAXException

endElement

public void endElement(String uri,
 String name,
 String qName)
                throws SAXException

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class DefaultHandler

Throws:

SAXException

characters

public void characters(char[] ch,
 int start,
 int length)
                throws SAXException

Specified by:

characters in interface ContentHandler

Overrides:

characters in class DefaultHandler

Throws:

SAXException

startDocument

public void startDocument()
                   throws SAXException

Specified by:

startDocument in interface ContentHandler

Overrides:

startDocument in class DefaultHandler

Throws:

SAXException

endDocument

public void endDocument()
                 throws SAXException

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class DefaultHandler

Throws:

SAXException

wrapAsSAXException

public SAXException wrapAsSAXException(IOException e)

Create a SAXException that wraps the given IOException. The wrapping is done using the standard Java 1.4 mechanism, so that getCause() will work. Note that new SAXException(Exception) does NOT work.

Parameters:

e - an IOException to wrap

Returns:

a SAX exception for which getCause() will return e.