org.aksw.gerbil.annotator.decorator

Class SingleInstanceSecuringAnnotatorDecorator

java.lang.Object

org.aksw.gerbil.annotator.decorator.AbstractAnnotatorDecorator

org.aksw.gerbil.annotator.decorator.SingleInstanceSecuringAnnotatorDecorator

All Implemented Interfaces:

Closeable, AutoCloseable, Annotator, AnnotatorDecorator

public abstract class SingleInstanceSecuringAnnotatorDecorator
extends AbstractAnnotatorDecorator

This is a decorator for an Annotator which is used to make sure that the decorated Annotator instance is used by one single thread at a time. This is needed because of some Singleton based annotator implementations that lead to an increase of the runtime measurement while their threads are not working but waiting for a Semaphore. Thus, this decorator should be used to decorate the time measurement.

Author:

Michael Röder (roeder@informatik.uni-leipzig.de)

Field Summary

Fields

Modifier and Type	Field and Description
protected static Map<Annotator,org.aksw.gerbil.annotator.decorator.SingleInstanceSecuringAnnotatorDecorator.RegistryValue>	annotatorRegistry
protected static Semaphore	registryMutex

Fields inherited from class org.aksw.gerbil.annotator.decorator.AbstractAnnotatorDecorator

decoratedAnnotator

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SingleInstanceSecuringAnnotatorDecorator(Annotator decoratedAnnotator)

Method Summary

Modifier and Type	Method and Description
static SingleInstanceSecuringAnnotatorDecorator	createDecorator(ExperimentType type, Annotator annotator)
protected void	finalize()
protected static List<org.aksw.gerbil.transfer.nif.Meaning>	performC2KB(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static List<org.aksw.gerbil.transfer.nif.MeaningSpan>	performD2KBTask(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static List<org.aksw.gerbil.transfer.nif.MeaningSpan>	performExtraction(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static List<org.aksw.gerbil.transfer.nif.data.TypedNamedEntity>	performOKETask1(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static List<org.aksw.gerbil.transfer.nif.data.TypedNamedEntity>	performOKETask2(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static List<org.aksw.gerbil.transfer.nif.Span>	performRecognition(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static List<org.aksw.gerbil.transfer.nif.TypedSpan>	performRT2KBTask(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static List<org.aksw.gerbil.transfer.nif.TypedSpan>	performTyping(SingleInstanceSecuringAnnotatorDecorator decorator, org.aksw.gerbil.transfer.nif.Document document)
protected static Semaphore	registerAnnotator(Annotator decoratedAnnotator) Registers the given Annotator (if it is not already present in the registration) and returns its semaphore.
protected static void	unregisterAnnotator(Annotator decoratedAnnotator) Removes the given Annotator from the registration.

Methods inherited from class org.aksw.gerbil.annotator.decorator.AbstractAnnotatorDecorator

close, getDecoratedAnnotator, getName, setClosePermitionGranter, setName

Methods inherited from class java.lang.Object

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

Field Detail

annotatorRegistry

protected static final Map<Annotator,org.aksw.gerbil.annotator.decorator.SingleInstanceSecuringAnnotatorDecorator.RegistryValue> annotatorRegistry

registryMutex

protected static final Semaphore registryMutex

Constructor Detail

SingleInstanceSecuringAnnotatorDecorator

protected SingleInstanceSecuringAnnotatorDecorator(Annotator decoratedAnnotator)

Method Detail

createDecorator

public static SingleInstanceSecuringAnnotatorDecorator createDecorator(ExperimentType type,
                                                                       Annotator annotator)

performC2KB

protected static List<org.aksw.gerbil.transfer.nif.Meaning> performC2KB(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                        org.aksw.gerbil.transfer.nif.Document document)
                                                                 throws GerbilException

Throws:

GerbilException

performD2KBTask

protected static List<org.aksw.gerbil.transfer.nif.MeaningSpan> performD2KBTask(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                                org.aksw.gerbil.transfer.nif.Document document)
                                                                         throws GerbilException

Throws:

GerbilException

performExtraction

protected static List<org.aksw.gerbil.transfer.nif.MeaningSpan> performExtraction(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                                  org.aksw.gerbil.transfer.nif.Document document)
                                                                           throws GerbilException

Throws:

GerbilException

performTyping

protected static List<org.aksw.gerbil.transfer.nif.TypedSpan> performTyping(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                            org.aksw.gerbil.transfer.nif.Document document)
                                                                     throws GerbilException

Throws:

GerbilException

performRecognition

protected static List<org.aksw.gerbil.transfer.nif.Span> performRecognition(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                            org.aksw.gerbil.transfer.nif.Document document)
                                                                     throws GerbilException

Throws:

GerbilException

performOKETask1

protected static List<org.aksw.gerbil.transfer.nif.data.TypedNamedEntity> performOKETask1(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                                          org.aksw.gerbil.transfer.nif.Document document)
                                                                                   throws GerbilException

Throws:

GerbilException

performOKETask2

protected static List<org.aksw.gerbil.transfer.nif.data.TypedNamedEntity> performOKETask2(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                                          org.aksw.gerbil.transfer.nif.Document document)
                                                                                   throws GerbilException

Throws:

GerbilException

performRT2KBTask

protected static List<org.aksw.gerbil.transfer.nif.TypedSpan> performRT2KBTask(SingleInstanceSecuringAnnotatorDecorator decorator,
                                                                               org.aksw.gerbil.transfer.nif.Document document)
                                                                        throws GerbilException

Throws:

GerbilException

registerAnnotator

protected static Semaphore registerAnnotator(Annotator decoratedAnnotator)

Registers the given Annotator (if it is not already present in the registration) and returns its semaphore.

Parameters:

decoratedAnnotator -

Returns:

unregisterAnnotator

protected static void unregisterAnnotator(Annotator decoratedAnnotator)

Removes the given Annotator from the registration.

Parameters:

decoratedAnnotator -

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable