org.ow2.weblab.service.normaliser.tika
Class TikaExtractorService

java.lang.Object
  org.ow2.weblab.service.normaliser.tika.TikaExtractorService

All Implemented Interfaces:

Analyser

public class TikaExtractorService
extends java.lang.Object
implements Analyser

Tika extractor is quite simple since it does not handle with structure of documents (sheets in Excel, paragraphs in Word, etc.) The structure might have been represented as various MediaUnits.

To do:

Rewrite the class comment which is not good... TODO

Field Summary

protected org.ow2.weblab.content.api.ContentManager	contentManager The ContentManager to use.
protected org.apache.commons.logging.Log	logger The logger to be used inside this class.
protected MetadataWriter	metadataWriter MetadataWriter used
protected boolean	removeContent Whether or not to remove content.
protected TikaConfiguration	serviceConfig The configuration to be used for the service.
protected java.text.DateFormat	simpleDateFormat The formatter used to annotate dates (like 2011-12-31)
protected TikaConfig	tikaConfig The configuration Tika by it self.

Constructor Summary

TikaExtractorService(TikaConfiguration conf)
The only constructor of this class that needs a configuration.

Method Summary

protected Document	checkArgs(ProcessArgs args) Get the document inside the process args or throw an InvalidParameterException if not possible.
protected Metadata	extractTextAndMetadata(Document document, java.io.File contentFile, boolean forceAutoDetectParser)
ProcessReturn	process(ProcessArgs args)

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.apache.commons.logging.Log logger

The logger to be used inside this class.

contentManager

protected final org.ow2.weblab.content.api.ContentManager contentManager

The ContentManager to use. Various implementation exists. They are defined through a configuration file.

serviceConfig

protected final TikaConfiguration serviceConfig

The configuration to be used for the service.

tikaConfig

protected final TikaConfig tikaConfig

The configuration Tika by it self.

removeContent

protected final boolean removeContent

Whether or not to remove content. Just a flag to prevent calculation on each process method call. True only and only if the reader of the content manager is not a file AND

simpleDateFormat

protected final java.text.DateFormat simpleDateFormat

The formatter used to annotate dates (like 2011-12-31)

metadataWriter

protected MetadataWriter metadataWriter

MetadataWriter used

Constructor Detail

TikaExtractorService

public TikaExtractorService(TikaConfiguration conf)
                     throws TikaException,
                            java.io.IOException

The only constructor of this class that needs a configuration.

Parameters:

conf - The service configuration.

Throws:

java.io.IOException - If an error occurs accessing the tika configuration or instanciating the content manager.

TikaException - If an error occurs reading the tika configuration.

Method Detail

process

public ProcessReturn process(ProcessArgs args)
                      throws InvalidParameterException,
                             ContentNotAvailableException,
                             UnexpectedException

Specified by:

process in interface Analyser

Throws:

InvalidParameterException

ContentNotAvailableException

UnexpectedException

checkArgs

protected Document checkArgs(ProcessArgs args)
                      throws InvalidParameterException

Get the document inside the process args or throw an InvalidParameterException if not possible.

Parameters:

args - The ProcessArgs of the process method.

Returns:

The Document that must be contained by args.

Throws:

InvalidParameterException - If resource in args is null or not a Document.

extractTextAndMetadata

protected Metadata extractTextAndMetadata(Document document,
                                          java.io.File contentFile,
                                          boolean forceAutoDetectParser)
                                   throws UnexpectedException,
                                          ContentNotAvailableException

Parameters:

document - The document to be fill with MediaUnit units

contentFile - The file to be parsed

forceAutoDetectParser - Whether to let Tika guess the parser to use from file content or use existing mimeType on the document (dc:format) to select the appropriated parser.

Throws:

UnexpectedException - If the Tika parser fails.

ContentNotAvailableException - If the file is not reachable. (This should not appear this its access has been checked before)