Package org.apache.poi.xssf.eventusermodel

Class XSSFReader

java.lang.Object

org.apache.poi.xssf.eventusermodel.XSSFReader

Direct Known Subclasses:

XSSFBReader

public class XSSFReader
extends Object

This class makes it easy to get at individual parts of an OOXML .xlsx file, suitable for low memory sax parsing or similar. It makes up the core part of the EventUserModel support for XSSF.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	XSSFReader.SheetIterator	Iterator over sheet data.
static class	XSSFReader.XMLSheetRefReader
static final class	XSSFReader.XSSFSheetRef

Constructor Summary

Constructors

Constructor	Description
XSSFReader(OPCPackage pkg)	Creates a new XSSFReader, for the given package
XSSFReader(OPCPackage pkg, boolean allowStrictOoxmlFiles)	Creates a new XSSFReader, for the given package

Method Summary

Modifier and Type	Method	Description
InputStream	getSharedStringsData()	Returns an InputStream to read the contents of the shared strings table.
SharedStrings	getSharedStringsTable()	Opens up the Shared Strings Table, parses it, and returns a handy object for working with shared strings.
InputStream	getSheet(String relId)	Returns an InputStream to read the contents of the specified Sheet.
Iterator<InputStream>	getSheetsData()	Returns an Iterator which will let you get at all the different Sheets in turn.
InputStream	getStylesData()	Returns an InputStream to read the contents of the styles table.
StylesTable	getStylesTable()	Opens up the Styles Table, parses it, and returns a handy object for working with cell styles
InputStream	getThemesData()	Returns an InputStream to read the contents of the themes table.
InputStream	getWorkbookData()	Returns an InputStream to read the contents of the main Workbook, which contains key overall data for the file, including sheet definitions.
void	setUseReadOnlySharedStringsTable(boolean useReadOnlySharedStringsTable)	Controls whether getSharedStringsTable() uses SharedStringsTable or ReadOnlySharedStringsTable.
boolean	useReadOnlySharedStringsTable()

Methods inherited from class java.lang.Object

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

Constructor Details

XSSFReader

public XSSFReader(OPCPackage pkg)
           throws IOException,
OpenXML4JException

Creates a new XSSFReader, for the given package

Throws:

IOException

OpenXML4JException

XSSFReader

public XSSFReader(OPCPackage pkg,
 boolean allowStrictOoxmlFiles)
           throws IOException,
OpenXML4JException

Creates a new XSSFReader, for the given package

Parameters:

pkg - an OPCPackage representing a spreasheet file

allowStrictOoxmlFiles - whether to try to handle Strict OOXML format files

Throws:

IOException

OpenXML4JException

Method Details

setUseReadOnlySharedStringsTable

public void setUseReadOnlySharedStringsTable(boolean useReadOnlySharedStringsTable)

Controls whether getSharedStringsTable() uses SharedStringsTable or ReadOnlySharedStringsTable.

Parameters:

useReadOnlySharedStringsTable - if true, the ReadOnlySharedStringsTable is used, SharedStringsTable otherwise

Since:

POI 5.2.0

useReadOnlySharedStringsTable

public boolean useReadOnlySharedStringsTable()

Returns:

whether getSharedStringsTable() uses SharedStringsTable or ReadOnlySharedStringsTable.

Since:

POI 5.2.0

getSharedStringsTable

public SharedStrings getSharedStringsTable()
                                    throws IOException,
InvalidFormatException

Opens up the Shared Strings Table, parses it, and returns a handy object for working with shared strings.

Throws:

IOException

InvalidFormatException

See Also:

• setUseReadOnlySharedStringsTable(boolean)

getStylesTable

public StylesTable getStylesTable()
                           throws IOException,
InvalidFormatException

Opens up the Styles Table, parses it, and returns a handy object for working with cell styles

Throws:

IOException

InvalidFormatException

getSharedStringsData

public InputStream getSharedStringsData()
                                 throws IOException,
InvalidFormatException

Returns an InputStream to read the contents of the shared strings table.

Throws:

IOException

InvalidFormatException

getStylesData

public InputStream getStylesData()
                          throws IOException,
InvalidFormatException

Returns an InputStream to read the contents of the styles table.

Throws:

IOException

InvalidFormatException

getThemesData

public InputStream getThemesData()
                          throws IOException,
InvalidFormatException

Returns an InputStream to read the contents of the themes table.

Throws:

IOException

InvalidFormatException

getWorkbookData

public InputStream getWorkbookData()
                            throws IOException,
InvalidFormatException

Returns an InputStream to read the contents of the main Workbook, which contains key overall data for the file, including sheet definitions.

Throws:

IOException

InvalidFormatException

getSheet

public InputStream getSheet(String relId)
                     throws IOException,
InvalidFormatException

Returns an InputStream to read the contents of the specified Sheet.

Parameters:

relId - The relationId of the sheet, from a r:id on the workbook

Throws:

IOException

InvalidFormatException

getSheetsData

public Iterator<InputStream> getSheetsData()
                                    throws IOException,
InvalidFormatException

Returns an Iterator which will let you get at all the different Sheets in turn. Each sheet's InputStream is only opened when fetched from the Iterator. It's up to you to close the InputStreams when done with each one.

Throws:

IOException

InvalidFormatException