org.apache.poi.hwpf.extractor

Class WordExtractor

java.lang.Object

org.apache.poi.hwpf.extractor.WordExtractor

All Implemented Interfaces:

Closeable, AutoCloseable, POIOLE2TextExtractor, POITextExtractor

public final class WordExtractor
extends Object
implements POIOLE2TextExtractor

Class to extract the text from a Word Document. You should use either getParagraphText() or getText() unless you have a strong reason otherwise.

Constructor Summary

Constructors

Constructor and Description
WordExtractor(DirectoryNode dir)
WordExtractor(HWPFDocument doc) Create a new Word Extractor
WordExtractor(InputStream is) Create a new Word Extractor
WordExtractor(POIFSFileSystem fs) Create a new Word Extractor

Method Summary

Modifier and Type	Method and Description
String[]	getCommentsText()
HWPFDocument	getDocument()
String[]	getEndnoteText()
HWPFDocument	getFilesystem()
String	getFooterText() Deprecated. 3.8 beta 4
String[]	getFootnoteText()
String	getHeaderText() Deprecated. 3.8 beta 4
String[]	getMainTextboxText()
String[]	getParagraphText() Get the text from the word file, as an array with one String per paragraph
String	getText() Grab the text, based on the WordToTextConverter.
String	getTextFromPieces() Grab the text out of the text pieces.
boolean	isCloseFilesystem()
void	setCloseFilesystem(boolean doCloseFilesystem)
static String	stripFields(String text) Removes any fields (eg macros, page markers etc) from the string.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.poi.extractor.POIOLE2TextExtractor

getDocSummaryInformation, getMetadataTextExtractor, getRoot, getSummaryInformation

Methods inherited from interface org.apache.poi.extractor.POITextExtractor

close

Constructor Detail

WordExtractor

public WordExtractor(InputStream is)
              throws IOException

Create a new Word Extractor

Parameters:

is - InputStream containing the word file

Throws:

IOException

WordExtractor

public WordExtractor(POIFSFileSystem fs)
              throws IOException

Create a new Word Extractor

Parameters:

fs - POIFSFileSystem containing the word file

Throws:

IOException

WordExtractor

public WordExtractor(DirectoryNode dir)
              throws IOException

Throws:

IOException

WordExtractor

public WordExtractor(HWPFDocument doc)

Create a new Word Extractor

Parameters:

doc - The HWPFDocument to extract from

Method Detail

getParagraphText

public String[] getParagraphText()

Get the text from the word file, as an array with one String per paragraph

getFootnoteText

public String[] getFootnoteText()

getMainTextboxText

public String[] getMainTextboxText()

getEndnoteText

public String[] getEndnoteText()

getCommentsText

public String[] getCommentsText()

getHeaderText

@Deprecated
public String getHeaderText()

Deprecated. 3.8 beta 4

Grab the text from the headers

getFooterText

@Deprecated
public String getFooterText()

Deprecated. 3.8 beta 4

Grab the text from the footers

getTextFromPieces

public String getTextFromPieces()

Grab the text out of the text pieces. Might also include various bits of crud, but will work in cases where the text piece -> paragraph mapping is broken. Fast too.

getText

public String getText()

Grab the text, based on the WordToTextConverter. Shouldn't include any crud, but slower than getTextFromPieces().

Specified by:

getText in interface POITextExtractor

stripFields

public static String stripFields(String text)

Removes any fields (eg macros, page markers etc) from the string.

getDocument

public HWPFDocument getDocument()

Specified by:

getDocument in interface POIOLE2TextExtractor

Specified by:

getDocument in interface POITextExtractor

setCloseFilesystem

public void setCloseFilesystem(boolean doCloseFilesystem)

Specified by:

setCloseFilesystem in interface POITextExtractor

isCloseFilesystem

public boolean isCloseFilesystem()

Specified by:

isCloseFilesystem in interface POITextExtractor

getFilesystem

public HWPFDocument getFilesystem()

Specified by:

getFilesystem in interface POITextExtractor