org.apache.poi.ooxml

Class POIXMLRelation

java.lang.Object

org.apache.poi.ooxml.POIXMLRelation

Direct Known Subclasses:

XDGFRelation, XSLFRelation, XSSFBRelation, XSSFRelation, XWPFRelation

public abstract class POIXMLRelation
extends java.lang.Object

Represents a descriptor of a OOXML relation.

Constructor Summary

Constructors

Constructor and Description
POIXMLRelation(java.lang.String type, java.lang.String rel, java.lang.String defaultName) Instantiates a POIXMLRelation.
POIXMLRelation(java.lang.String type, java.lang.String rel, java.lang.String defaultName, java.lang.Class<? extends POIXMLDocumentPart> cls) Instantiates a POIXMLRelation.

Method Summary

Modifier and Type	Method and Description
java.io.InputStream	getContents(PackagePart corePart) Fetches the InputStream to read the contents, based of the specified core part, for which we are defined as a suitable relationship
java.lang.String	getContentType() Return the content type.
java.lang.String	getDefaultFileName() Return the default part name.
java.lang.String	getFileName(int index) Returns the filename for the nth one of these, e.g.
java.lang.Integer	getFileNameIndex(POIXMLDocumentPart part) Returns the index of the filename within the package for the given part.
java.lang.String	getRelation() Return the relationship, the kind of connection between a source part and a target part in a package.
java.lang.Class<? extends POIXMLDocumentPart>	getRelationClass() Return type of the object used to construct instances of this relationship

Methods inherited from class java.lang.Object

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

Constructor Detail

POIXMLRelation

public POIXMLRelation(java.lang.String type,
                      java.lang.String rel,
                      java.lang.String defaultName,
                      java.lang.Class<? extends POIXMLDocumentPart> cls)

Instantiates a POIXMLRelation.

Parameters:

type - content type

rel - relationship

defaultName - default item name

cls - defines what object is used to construct instances of this relationship

POIXMLRelation

public POIXMLRelation(java.lang.String type,
                      java.lang.String rel,
                      java.lang.String defaultName)

Instantiates a POIXMLRelation.

Parameters:

type - content type

rel - relationship

defaultName - default item name

Method Detail

getContentType

public java.lang.String getContentType()

Return the content type. Content types define a media type, a subtype, and an optional set of parameters, as defined in RFC 2616.

Returns:

the content type

getRelation

public java.lang.String getRelation()

Return the relationship, the kind of connection between a source part and a target part in a package. Relationships make the connections between parts directly discoverable without looking at the content in the parts, and without altering the parts themselves.

Returns:

the relationship

getDefaultFileName

public java.lang.String getDefaultFileName()

Return the default part name. Part names are used to refer to a part in the context of a package, typically as part of a URI.

Returns:

the default part name

getFileName

public java.lang.String getFileName(int index)

Returns the filename for the nth one of these, e.g. /xl/comments4.xml

Parameters:

index - the suffix for the document type

Returns:

the filename including the suffix

getFileNameIndex

public java.lang.Integer getFileNameIndex(POIXMLDocumentPart part)

Returns the index of the filename within the package for the given part. e.g. 4 for /xl/comments4.xml

Parameters:

part - the part to read the suffix from

Returns:

the suffix

getRelationClass

public java.lang.Class<? extends POIXMLDocumentPart> getRelationClass()

Return type of the object used to construct instances of this relationship

Returns:

the class of the object used to construct instances of this relation

getContents

public java.io.InputStream getContents(PackagePart corePart)
                                throws java.io.IOException,
                                       InvalidFormatException

Fetches the InputStream to read the contents, based of the specified core part, for which we are defined as a suitable relationship

Throws:

java.io.IOException

InvalidFormatException

Since:

3.16-beta3