org.apache.any23.filter
Class ExtractionContextBlocker

java.lang.Object
  org.apache.any23.filter.ExtractionContextBlocker

All Implemented Interfaces:

TripleHandler

public class ExtractionContextBlocker
extends Object
implements TripleHandler

A wrapper around a TripleHandler that can block and unblock calls to the handler, either for the entire document, or for individual ExtractionContexts. A document is initially blocked and must be explicitly unblocked. Contexts are initially unblocked and must be explicitly blocked. Unblocking a document unblocks all contexts as well. This class it thread-safe.

Author:

Richard Cyganiak (richard@cyganiak.de)

Constructor Summary

ExtractionContextBlocker(TripleHandler wrapped)

Method Summary

void	blockContext(ExtractionContext context)
void	close() Will be called last and exactly once.
void	closeContext(ExtractionContext context) Informs the handler that no more triples will come from a previously opened context.
void	endDocument(org.openrdf.model.URI documentURI) Informs the handler that the end of the document has been reached.
boolean	isDocBlocked()
void	openContext(ExtractionContext context) Informs the handler that a new context has been established.
void	receiveNamespace(String prefix, String uri, ExtractionContext context) Invoked with a currently open context, notifies the detection of a namespace.
void	receiveTriple(org.openrdf.model.Resource s, org.openrdf.model.URI p, org.openrdf.model.Value o, org.openrdf.model.URI g, ExtractionContext context) Invoked with a currently open context, notifies the detection of a triple.
void	setContentLength(long contentLength) Sets the length of the content to be processed.
void	startDocument(org.openrdf.model.URI documentURI)
void	unblockContext(ExtractionContext context)
void	unblockDocument()

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtractionContextBlocker

public ExtractionContextBlocker(TripleHandler wrapped)

Method Detail

isDocBlocked

public boolean isDocBlocked()

blockContext

public void blockContext(ExtractionContext context)

unblockContext

public void unblockContext(ExtractionContext context)

startDocument

public void startDocument(org.openrdf.model.URI documentURI)
                   throws TripleHandlerException

Specified by:

startDocument in interface TripleHandler

Throws:

TripleHandlerException

openContext

public void openContext(ExtractionContext context)
                 throws TripleHandlerException

Description copied from interface: TripleHandler

Informs the handler that a new context has been established. Contexts are not guaranteed to receive any triples, so they might be closed without any triple.

Specified by:

openContext in interface TripleHandler

Throws:

TripleHandlerException

closeContext

public void closeContext(ExtractionContext context)

Description copied from interface: TripleHandler

Informs the handler that no more triples will come from a previously opened context. All contexts are guaranteed to be closed before the final close(). The document context for each document is guaranteed to be closed after all local contexts of that document.

Specified by:

closeContext in interface TripleHandler

Parameters:

context - the context to be closed.

unblockDocument

public void unblockDocument()

receiveTriple

public void receiveTriple(org.openrdf.model.Resource s,
                          org.openrdf.model.URI p,
                          org.openrdf.model.Value o,
                          org.openrdf.model.URI g,
                          ExtractionContext context)
                   throws TripleHandlerException

Description copied from interface: TripleHandler

Invoked with a currently open context, notifies the detection of a triple.

Specified by:

receiveTriple in interface TripleHandler

Parameters:

s - triple subject, cannot be null.

p - triple predicate, cannot be null.

o - triple object, cannot be null.

g - triple graph, can be null.

context - extraction context.

Throws:

TripleHandlerException

receiveNamespace

public void receiveNamespace(String prefix,
                             String uri,
                             ExtractionContext context)
                      throws TripleHandlerException

Description copied from interface: TripleHandler

Invoked with a currently open context, notifies the detection of a namespace.

Specified by:

receiveNamespace in interface TripleHandler

Parameters:

prefix - namespace prefix.

uri - namespace URI.

context - namespace context.

Throws:

TripleHandlerException

close

public void close()
           throws TripleHandlerException

Description copied from interface: TripleHandler

Will be called last and exactly once.

Specified by:

close in interface TripleHandler

Throws:

TripleHandlerException

endDocument

public void endDocument(org.openrdf.model.URI documentURI)
                 throws TripleHandlerException

Description copied from interface: TripleHandler

Informs the handler that the end of the document has been reached.

Specified by:

endDocument in interface TripleHandler

Parameters:

documentURI - document URI.

Throws:

TripleHandlerException

setContentLength

public void setContentLength(long contentLength)

Description copied from interface: TripleHandler

Sets the length of the content to be processed.

Specified by:

setContentLength in interface TripleHandler