Class ThreadSafePOSTaggerME

java.lang.Object

opennlp.tools.postag.ThreadSafePOSTaggerME

All Implemented Interfaces:

AutoCloseable, opennlp.tools.ml.Probabilistic, opennlp.tools.postag.POSTagger

@ThreadSafe
public class ThreadSafePOSTaggerME
extends Object
implements opennlp.tools.postag.POSTagger, opennlp.tools.ml.Probabilistic, AutoCloseable

A thread-safe version of the POSTaggerME. Using it is completely transparent. You can use it in a single-threaded context as well, it only incurs a minimal overhead.

Note:
This implementation uses a ThreadLocal. Although the implementation is lightweight because the model is not duplicated, if you have many long-running threads, you may run into memory problems.

Be careful when using this in a Jakarta EE application, for example.

The user is responsible for clearing the ThreadLocal via calling close().

See Also:

• POSTagger
• POSTaggerME
• Probabilistic

Constructor Summary

Constructors

Constructor	Description
ThreadSafePOSTaggerME(String language)	Initializes a ThreadSafePOSTaggerME by downloading a default model for a given language.
ThreadSafePOSTaggerME(String language, POSTagFormat format)	Initializes a ThreadSafePOSTaggerME by downloading a default model for a given language.
ThreadSafePOSTaggerME(POSModel model)	Initializes a ThreadSafePOSTaggerME with the specified model.
ThreadSafePOSTaggerME(POSModel model, POSTagFormat format)	Initializes a ThreadSafePOSTaggerME with the specified model.

Method Summary

Modifier and Type	Method	Description
void	close()
double[]	probs()
String[]	tag(String[] sentence)
String[]	tag(String[] sentence, Object[] additionaContext)
opennlp.tools.util.Sequence[]	topKSequences(String[] sentence)
opennlp.tools.util.Sequence[]	topKSequences(String[] sentence, Object[] additionaContext)

Methods inherited from class Object

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

Constructor Details

ThreadSafePOSTaggerME

public ThreadSafePOSTaggerME(String language)
                      throws IOException

Initializes a ThreadSafePOSTaggerME by downloading a default model for a given language.

Parameters:

language - An ISO conform language code.

Throws:

IOException - Thrown if the model could not be downloaded or saved.

ThreadSafePOSTaggerME

public ThreadSafePOSTaggerME(String language,
 POSTagFormat format)
                      throws IOException

Initializes a ThreadSafePOSTaggerME by downloading a default model for a given language.

Parameters:

language - An ISO conform language code.

format - A valid POSTagFormat.

Throws:

IOException - Thrown if the model could not be downloaded or saved.

ThreadSafePOSTaggerME

public ThreadSafePOSTaggerME(POSModel model)

Initializes a ThreadSafePOSTaggerME with the specified model.

Parameters:

model - A valid POSModel.

ThreadSafePOSTaggerME

public ThreadSafePOSTaggerME(POSModel model,
 POSTagFormat format)

Initializes a ThreadSafePOSTaggerME with the specified model.

Parameters:

model - A valid POSModel.

format - A valid POSTagFormat.

Method Details

tag

public String[] tag(String[] sentence)

Specified by:

tag in interface opennlp.tools.postag.POSTagger

tag

public String[] tag(String[] sentence,
 Object[] additionaContext)

Specified by:

tag in interface opennlp.tools.postag.POSTagger

topKSequences

public opennlp.tools.util.Sequence[] topKSequences(String[] sentence)

Specified by:

topKSequences in interface opennlp.tools.postag.POSTagger

topKSequences

public opennlp.tools.util.Sequence[] topKSequences(String[] sentence,
 Object[] additionaContext)

Specified by:

topKSequences in interface opennlp.tools.postag.POSTagger

probs

public double[] probs()

Specified by:

probs in interface opennlp.tools.ml.Probabilistic

close

public void close()

Specified by:

close in interface AutoCloseable