gate.jape

Class Batch

java.lang.Object

gate.jape.Batch

All Implemented Interfaces:

JapeConstants, Benchmarkable, Serializable

public class Batch
extends Object
implements JapeConstants, Benchmarkable

Batch processing of JAPE transducers against documents or collections. Construction will parse or deserialise a transducer as required.

See Also:

Serialized Form

Field Summary

Fields inherited from interface gate.jape.JapeConstants

ALL_STYLE, APPELT_STYLE, BRILL_STYLE, DEFAULT_PRIORITY, FIRST_STYLE, INDENT_PADDING, KLEENE_PLUS, KLEENE_QUERY, KLEENE_STAR, MULTI_SPAN_BINDING, NO_BINDING, NO_KLEENE_OP, ONCE_STYLE, SINGLE_SPAN_BINDING

Constructor Summary

Constructors

Constructor and Description
Batch(URL url, String encoding) Create a fully initialised instance.
Batch(URL url, String encoding, StatusListener sListener)

Method Summary

Methods

Modifier and Type	Method and Description
void	addProgressListener(ProgressListener l)
void	addStatusListener(StatusListener l)
void	finalize()
protected void	fireProcessFinished()
protected void	fireProgressChanged(int e)
protected void	fireStatusChanged(String e)
String	getBenchmarkId() Returns the benchmark ID of this resource.
FeatureMap	getFeatures()
Transducer	getTransducer() Get the transducer.
void	interrupt() Notifies this PR that it should stop its execution as soon as possible.
boolean	isEnableDebugging()
protected void	linkListeners() Creates inner listeners that forward events from the transducer object to our own listeners.
void	removeProgressListener(ProgressListener l)
void	removeStatusListener(StatusListener l)
void	runControllerExecutionAbortedBlock(ActionContext ac, Controller c, Throwable t, Ontology o)
void	runControllerExecutionFinishedBlock(ActionContext ac, Controller c, Ontology o)
void	runControllerExecutionStartedBlock(ActionContext ac, Controller c, Ontology o)
void	setActionContext(ActionContext ac)
void	setBenchmarkId(String benchmarkId) This method sets the benchmarkID for this resource.
void	setEnableDebugging(boolean enableDebugging)
void	setFeatures(FeatureMap newFeatures)
void	setOntology(Ontology ontology) Sets the ontology to be used by the transducers
void	transduce(Corpus coll) Process the given collection.
void	transduce(Document doc) Process a single document.
void	transduce(Document doc, AnnotationSet inputAS, AnnotationSet outputAS) Process a single document.

Methods inherited from class java.lang.Object

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

Constructor Detail

Batch

public Batch(URL url,
     String encoding)
      throws JapeException

Create a fully initialised instance.

japeFileName: the name of a .jape or .ser transducer file. This may be an absolute path, or may a .jar that lives somewhere on the classpath.

Throws:

JapeException

Batch

public Batch(URL url,
     String encoding,
     StatusListener sListener)
      throws JapeException

Throws:

JapeException

Method Detail

setActionContext

public void setActionContext(ActionContext ac)

finalize

public void finalize()
              throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable

linkListeners

protected void linkListeners()

Creates inner listeners that forward events from the transducer object to our own listeners.

interrupt

public void interrupt()

Notifies this PR that it should stop its execution as soon as possible.

getTransducer

public Transducer getTransducer()

Get the transducer.

transduce

public void transduce(Corpus coll)
               throws JapeException,
                      ExecutionException

Process the given collection.

Throws:

JapeException

ExecutionException

transduce

public void transduce(Document doc)
               throws JapeException,
                      ExecutionException

Process a single document.

Throws:

JapeException

ExecutionException

transduce

public void transduce(Document doc,
             AnnotationSet inputAS,
             AnnotationSet outputAS)
               throws JapeException,
                      ExecutionException

Process a single document.

Throws:

JapeException

ExecutionException

setFeatures

public void setFeatures(FeatureMap newFeatures)

getFeatures

public FeatureMap getFeatures()

removeProgressListener

public void removeProgressListener(ProgressListener l)

addProgressListener

public void addProgressListener(ProgressListener l)

fireProgressChanged

protected void fireProgressChanged(int e)

fireProcessFinished

protected void fireProcessFinished()

removeStatusListener

public void removeStatusListener(StatusListener l)

addStatusListener

public void addStatusListener(StatusListener l)

fireStatusChanged

protected void fireStatusChanged(String e)

setOntology

public void setOntology(Ontology ontology)

Sets the ontology to be used by the transducers

Parameters:

ontology -

isEnableDebugging

public boolean isEnableDebugging()

setEnableDebugging

public void setEnableDebugging(boolean enableDebugging)

getBenchmarkId

public String getBenchmarkId()

Description copied from interface: Benchmarkable

Returns the benchmark ID of this resource.

Specified by:

getBenchmarkId in interface Benchmarkable

setBenchmarkId

public void setBenchmarkId(String benchmarkId)

Description copied from interface: Benchmarkable

This method sets the benchmarkID for this resource. The resource must use this as the prefix for any sub-events it logs.

Specified by:

setBenchmarkId in interface Benchmarkable

Parameters:

benchmarkId - the benchmark ID, which must not contain spaces as it is already used as a separator in the log, you can use Benchmark.createBenchmarkId(String, String) for it.

runControllerExecutionAbortedBlock

public void runControllerExecutionAbortedBlock(ActionContext ac,
                                      Controller c,
                                      Throwable t,
                                      Ontology o)
                                        throws ExecutionException

Throws:

ExecutionException

runControllerExecutionFinishedBlock

public void runControllerExecutionFinishedBlock(ActionContext ac,
                                       Controller c,
                                       Ontology o)
                                         throws ExecutionException

Throws:

ExecutionException

runControllerExecutionStartedBlock

public void runControllerExecutionStartedBlock(ActionContext ac,
                                      Controller c,
                                      Ontology o)
                                        throws ExecutionException

Throws:

ExecutionException