edu.stanford.nlp.pipeline

Class AnnotationSerializer

java.lang.Object

edu.stanford.nlp.pipeline.AnnotationSerializer

Direct Known Subclasses:

CustomAnnotationSerializer

public abstract class AnnotationSerializer
extends Object

Constructor Summary

Constructors

Constructor and Description
AnnotationSerializer()

Method Summary

Methods

Modifier and Type	Method and Description
abstract Pair<Annotation,InputStream>	read(InputStream is) Read a single object from this stream.
abstract OutputStream	write(Annotation corpus, OutputStream os) Append a single object to this stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

AnnotationSerializer

public AnnotationSerializer()

Method Detail

write

public abstract OutputStream write(Annotation corpus,
                 OutputStream os)
                            throws IOException

Append a single object to this stream. Subsequent calls to append on the same stream must supply the returned output stream; furthermore, implementations of this function must be prepared to handle the same output stream being passed in as it returned on the previous write.

Parameters:

corpus - The document to serialize to the stream.

os - The output stream to serialize to.

Returns:

The output stream which should be closed when done writing, and which should be passed into subsequent calls to write() on this serializer.

Throws:

IOException - Thrown if the underlying output stream throws the exception.

read

public abstract Pair<Annotation,InputStream> read(InputStream is)
                                           throws IOException,
                                                  ClassNotFoundException,
                                                  ClassCastException

Read a single object from this stream. Subsequent calls to read on the same input stream must supply the returned input stream; furthermore, implementations of this function must be prepared to handle the same input stream being passed to it as it returned on the previous read.

Parameters:

is - The input stream to read a document from.

Returns:

A pair of the read document, and the implementation-specific input stream which it was actually read from. This stream should be passed to subsequent calls to read on the same stream, and should be closed when reading completes.

Throws:

IOException - Thrown if the underlying stream throws the exception.

ClassNotFoundException - Thrown if an object was read that does not exist in the classpath.

ClassCastException - Thrown if the signature of a class changed in way that was incompatible with the serialized document.