Package org.apache.poi.ooxml

Class POIXMLDocument

java.lang.Object

org.apache.poi.ooxml.POIXMLDocumentPart

org.apache.poi.ooxml.POIXMLDocument

All Implemented Interfaces:

Closeable, AutoCloseable

Direct Known Subclasses:

XMLSlideShow, XmlVisioDocument, XSLFSlideShow, XSSFWorkbook, XWPFDocument

public abstract class POIXMLDocument
extends POIXMLDocumentPart
implements Closeable

This holds the common functionality for all POI OOXML Document classes.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

POIXMLDocumentPart.RelationPart

Field Summary

Fields

Modifier and Type	Field	Description
static String	DOCUMENT_CREATOR
static String	OLE_OBJECT_REL_TYPE
static String	PACK_OBJECT_REL_TYPE

Method Summary

Modifier and Type	Method	Description
void	close()	Closes the underlying OPCPackage from which this document was read, if there is one
abstract List<PackagePart>	getAllEmbeddedParts()	Get the document's embedded files.
List<PackagePart>	getAllEmbedds()	Deprecated. use getAllEmbeddedParts instead
OPCPackage	getPackage()	Get the assigned OPCPackage
POIXMLProperties	getProperties()	Get the document properties.
static OPCPackage	openPackage(String path)	Wrapper to open a package, which works around shortcomings in java's this() constructor calls
void	write(OutputStream stream)	Write out this document to an Outputstream.

Methods inherited from class org.apache.poi.ooxml.POIXMLDocumentPart

_invokeOnDocumentRead, addRelation, createRelationship, createRelationship, createRelationship, getPackagePart, getParent, getRelationById, getRelationId, getRelationPartById, getRelationParts, getRelations, isCommited, setCommited, toString

Methods inherited from class java.lang.Object

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

Field Detail

DOCUMENT_CREATOR

public static final String DOCUMENT_CREATOR

See Also:

Constant Field Values

OLE_OBJECT_REL_TYPE

public static final String OLE_OBJECT_REL_TYPE

See Also:

Constant Field Values

PACK_OBJECT_REL_TYPE

public static final String PACK_OBJECT_REL_TYPE

See Also:

Constant Field Values

Method Detail

openPackage

public static OPCPackage openPackage(String path)
                              throws IOException

Wrapper to open a package, which works around shortcomings in java's this() constructor calls

Parameters:

path - the path to the document

Returns:

the new OPCPackage

Throws:

IOException - if there was a problem opening the document

getPackage

public OPCPackage getPackage()

Get the assigned OPCPackage

Returns:

the assigned OPCPackage

getProperties

public POIXMLProperties getProperties()

Get the document properties. This gives you access to the core ooxml properties, and the extended ooxml properties.

Returns:

the document properties

getAllEmbedds

@Deprecated
@Removal(version="4.2")
public List<PackagePart> getAllEmbedds()
                                throws OpenXML4JException

Deprecated.

use getAllEmbeddedParts instead

Get the document's embedded files.

Returns:

the document's embedded files

Throws:

OpenXML4JException - if the embedded parts can't be determined

getAllEmbeddedParts

public abstract List<PackagePart> getAllEmbeddedParts()
                                               throws OpenXML4JException

Get the document's embedded files.

Returns:

the document's embedded files

Throws:

OpenXML4JException - if the embedded parts can't be determined

Since:

POI 4.0.0

close

public void close()
           throws IOException

Closes the underlying OPCPackage from which this document was read, if there is one

Once this has been called, no further operations, updates or reads should be performed on the document.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException - for writable packages, if an IO exception occur during the saving process.

write

public final void write(OutputStream stream)
                 throws IOException

Write out this document to an Outputstream. Note - if the Document was opened from a File rather than an InputStream, you must write out to a different file, overwriting via an OutputStream isn't possible. If stream is a FileOutputStream on a networked drive or has a high cost/latency associated with each written byte, consider wrapping the OutputStream in a BufferedOutputStream to improve write performance.

Parameters:

stream - - the java OutputStream you wish to write the file to

Throws:

IOException - if anything can't be written.