gov.sandia.cognition.text.document.extractor

Interface DocumentExtractor

All Known Subinterfaces:

SingleDocumentExtractor

All Known Implementing Classes:

AbstractDocumentExtractor, AbstractSingleDocumentExtractor, TextDocumentExtractor

public interface DocumentExtractor

Interface for extracting documents from files.

Since:

3.0

Author:

Justin Basilico

Method Summary

Modifier and Type	Method and Description
boolean	canExtract(java.io.File file) Determines if the given file can be extracted by this extractor.
boolean	canExtract(java.net.URI uri) Determines if the given file can be extracted by this extractor.
boolean	canExtract(java.net.URLConnection connection) Determines if the given file can be extracted by this extractor.
java.lang.Iterable<? extends Document>	extractAll(java.io.File file) Attempts to extract all of the documents from the given file.
java.lang.Iterable<? extends Document>	extractAll(java.net.URI uri) Attempts to extract all of the documents from the given file.
java.lang.Iterable<? extends Document>	extractAll(java.net.URLConnection connection) Attempts to extract all of the documents from the given file.

Method Detail

canExtract

boolean canExtract(java.io.File file)
            throws java.io.IOException

Determines if the given file can be extracted by this extractor.

Parameters:

file - The file to extract.

Returns:

True if this extractor can extract the file and false otherwise.

Throws:

java.io.IOException - If there is an IO error.

canExtract

boolean canExtract(java.net.URI uri)
            throws java.io.IOException

Determines if the given file can be extracted by this extractor.

Parameters:

uri - The URI of the file to extract.

Returns:

True if this extractor can extract the file and false otherwise.

Throws:

java.io.IOException - If there is an IO error.

canExtract

boolean canExtract(java.net.URLConnection connection)
            throws java.io.IOException

Determines if the given file can be extracted by this extractor.

Parameters:

connection - The connection to the file to extract.

Returns:

True if this extractor can extract the file and false otherwise.

Throws:

java.io.IOException - If there is an IO error.

extractAll

java.lang.Iterable<? extends Document> extractAll(java.io.File file)
                                           throws DocumentExtractionException,
                                                  java.io.IOException

Attempts to extract all of the documents from the given file.

Parameters:

file - The file to extract.

Returns:

The list of documents extracted from the given file.

Throws:

DocumentExtractionException - If there is an error extracting data from the file.

java.io.IOException - If there is an IO error.

extractAll

java.lang.Iterable<? extends Document> extractAll(java.net.URI uri)
                                           throws DocumentExtractionException,
                                                  java.io.IOException

Attempts to extract all of the documents from the given file.

Parameters:

uri - The URI of the file to extract.

Returns:

The list of documents extracted from the given file.

Throws:

DocumentExtractionException - If there is an error extracting data from the file.

java.io.IOException - If there is an IO error.

extractAll

java.lang.Iterable<? extends Document> extractAll(java.net.URLConnection connection)
                                           throws DocumentExtractionException,
                                                  java.io.IOException

Attempts to extract all of the documents from the given file.

Parameters:

connection - The connection to the file to extract.

Returns:

The list of documents extracted from the given file.

Throws:

DocumentExtractionException - If there is an error extracting data from the file.

java.io.IOException - If there is an IO error.