org.apache.poi.openxml4j.opc.internal

Class PackagePropertiesPart

java.lang.Object

org.apache.poi.openxml4j.opc.PackagePart

org.apache.poi.openxml4j.opc.internal.PackagePropertiesPart

All Implemented Interfaces:

java.lang.Comparable<PackagePart>, PackageProperties, RelationshipSource

public final class PackagePropertiesPart
extends PackagePart
implements PackageProperties

Represents the core properties part of a package.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Optional<java.lang.String>	category A categorization of the content of this package.
protected java.util.Optional<java.lang.String>	contentStatus The status of the content.
protected java.util.Optional<java.lang.String>	contentType The type of content represented, generally defined by a specific use and intended audience.
protected java.util.Optional<java.util.Date>	created Date of creation of the resource.
protected java.util.Optional<java.lang.String>	creator An entity primarily responsible for making the content of the resource.
protected java.util.Optional<java.lang.String>	description An explanation of the content of the resource.
protected java.util.Optional<java.lang.String>	identifier An unambiguous reference to the resource within a given context.
protected java.util.Optional<java.lang.String>	keywords A delimited set of keywords to support searching and indexing.
protected java.util.Optional<java.lang.String>	language The language of the intellectual content of the resource.
protected java.util.Optional<java.lang.String>	lastModifiedBy The user who performed the last modification.
protected java.util.Optional<java.util.Date>	lastPrinted The date and time of the last printing.
protected java.util.Optional<java.util.Date>	modified Date on which the resource was changed.
static java.lang.String	NAMESPACE_CP_URI
static java.lang.String	NAMESPACE_DC_URI
static java.lang.String	NAMESPACE_DCTERMS_URI
protected java.util.Optional<java.lang.String>	revision The revision number.
protected java.util.Optional<java.lang.String>	subject The topic of the content of the resource.
protected java.util.Optional<java.lang.String>	title The name given to the resource.
protected java.util.Optional<java.lang.String>	version The version number.

Fields inherited from class org.apache.poi.openxml4j.opc.PackagePart

_container, _contentType, _partName

Fields inherited from interface org.apache.poi.openxml4j.opc.PackageProperties

NAMESPACE_DC, NAMESPACE_DCTERMS

Constructor Summary

Constructors

Constructor and Description
PackagePropertiesPart(OPCPackage pack, PackagePartName partName) Constructor.

Method Summary

Modifier and Type	Method and Description
void	close() Close this part : flush this part, close the input stream and output stream.
void	flush() Flush the content of this part.
java.util.Optional<java.lang.String>	getCategoryProperty() Get the category property.
java.util.Optional<java.lang.String>	getContentStatusProperty() Get content status.
java.util.Optional<java.lang.String>	getContentTypeProperty() Get content type.
java.util.Optional<java.util.Date>	getCreatedProperty() Get created date.
java.lang.String	getCreatedPropertyString() Get created date formatted into a String.
java.util.Optional<java.lang.String>	getCreatorProperty() Get creator.
java.util.Optional<java.lang.String>	getDescriptionProperty() Get description.
java.util.Optional<java.lang.String>	getIdentifierProperty() Get identifier.
protected java.io.InputStream	getInputStreamImpl() Method that gets the input stream for this part.
java.util.Optional<java.lang.String>	getKeywordsProperty() Get keywords.
java.util.Optional<java.lang.String>	getLanguageProperty() Get the language.
java.util.Optional<java.lang.String>	getLastModifiedByProperty() Get the author of last modifications.
java.util.Optional<java.util.Date>	getLastPrintedProperty() Get last printed date.
java.lang.String	getLastPrintedPropertyString() Get last printed date formatted into a String.
java.util.Optional<java.util.Date>	getModifiedProperty() Get modified date.
java.lang.String	getModifiedPropertyString() Get modified date formatted into a String.
protected java.io.OutputStream	getOutputStreamImpl() Method that gets the output stream for this part.
java.util.Optional<java.lang.String>	getRevisionProperty() Get revision.
java.util.Optional<java.lang.String>	getSubjectProperty() Get subject.
java.util.Optional<java.lang.String>	getTitleProperty() Get title.
java.util.Optional<java.lang.String>	getVersionProperty() Get version.
boolean	load(java.io.InputStream ios) Load the content of this part.
boolean	save(java.io.OutputStream zos) Save the content of this part and the associated relationships part (if this part own at least one relationship) into the specified output stream.
void	setCategoryProperty(java.util.Optional<java.lang.String> category) Set the category.
void	setCategoryProperty(java.lang.String category) Set the category.
void	setContentStatusProperty(java.util.Optional<java.lang.String> contentStatus) Set the content status.
void	setContentStatusProperty(java.lang.String contentStatus) Set the content status.
void	setContentTypeProperty(java.util.Optional<java.lang.String> contentType) Set the content type.
void	setContentTypeProperty(java.lang.String contentType) Set the content type.
void	setCreatedProperty(java.util.Optional<java.util.Date> created) Set the created date.
void	setCreatedProperty(java.lang.String created) Set the created date.
void	setCreatorProperty(java.util.Optional<java.lang.String> creator) Set the creator.
void	setCreatorProperty(java.lang.String creator) Set the creator.
void	setDescriptionProperty(java.util.Optional<java.lang.String> description) Set the description.
void	setDescriptionProperty(java.lang.String description) Set the description.
void	setIdentifierProperty(java.util.Optional<java.lang.String> identifier) Set identifier.
void	setIdentifierProperty(java.lang.String identifier) Set identifier.
void	setKeywordsProperty(java.util.Optional<java.lang.String> keywords) Set keywords.
void	setKeywordsProperty(java.lang.String keywords) Set keywords.
void	setLanguageProperty(java.util.Optional<java.lang.String> language) Set language.
void	setLanguageProperty(java.lang.String language) Set language.
void	setLastModifiedByProperty(java.util.Optional<java.lang.String> lastModifiedBy) Set last modifications author.
void	setLastModifiedByProperty(java.lang.String lastModifiedBy) Set last modifications author.
void	setLastPrintedProperty(java.util.Optional<java.util.Date> lastPrinted) Set last printed date.
void	setLastPrintedProperty(java.lang.String lastPrinted) Set last printed date.
void	setModifiedProperty(java.util.Optional<java.util.Date> modified) Set last modification date.
void	setModifiedProperty(java.lang.String modified) Set last modification date.
void	setRevisionProperty(java.util.Optional<java.lang.String> revision) Set revision.
void	setRevisionProperty(java.lang.String revision) Set revision.
void	setSubjectProperty(java.util.Optional<java.lang.String> subject) Set subject.
void	setSubjectProperty(java.lang.String subject) Set subject.
void	setTitleProperty(java.util.Optional<java.lang.String> title) Set title.
void	setTitleProperty(java.lang.String title) Set title.
void	setVersionProperty(java.util.Optional<java.lang.String> version) Set version.
void	setVersionProperty(java.lang.String version) Set version.

Methods inherited from class org.apache.poi.openxml4j.opc.PackagePart

addExternalRelationship, addExternalRelationship, addRelationship, addRelationship, addRelationship, addRelationship, clear, clearRelationships, compareTo, findExistingRelation, getContentType, getContentTypeDetails, getInputStream, getOutputStream, getPackage, getPartName, getRelatedPart, getRelationship, getRelationships, getRelationshipsByType, getSize, hasRelationships, isDeleted, isRelationshipExists, isRelationshipPart, removeRelationship, setContentType, setDeleted, toString

Methods inherited from class java.lang.Object

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

Field Detail

NAMESPACE_DC_URI

public static final java.lang.String NAMESPACE_DC_URI

See Also:

Constant Field Values

NAMESPACE_CP_URI

public static final java.lang.String NAMESPACE_CP_URI

See Also:

Constant Field Values

NAMESPACE_DCTERMS_URI

public static final java.lang.String NAMESPACE_DCTERMS_URI

See Also:

Constant Field Values

category

protected java.util.Optional<java.lang.String> category

A categorization of the content of this package. [Example: Example values for this property might include: Resume, Letter, Financial Forecast, Proposal, Technical Presentation, and so on. This value might be used by an application's user interface to facilitate navigation of a large set of documents. end example]

contentStatus

protected java.util.Optional<java.lang.String> contentStatus

The status of the content. [Example: Values might include "Draft", "Reviewed", and "Final". end example]

contentType

protected java.util.Optional<java.lang.String> contentType

The type of content represented, generally defined by a specific use and intended audience. [Example: Values might include "Whitepaper", "Security Bulletin", and "Exam". end example] [Note: This property is distinct from MIME content types as defined in RFC 2616. end note]

created

protected java.util.Optional<java.util.Date> created

Date of creation of the resource.

creator

protected java.util.Optional<java.lang.String> creator

An entity primarily responsible for making the content of the resource.

description

protected java.util.Optional<java.lang.String> description

An explanation of the content of the resource. [Example: Values might include an abstract, table of contents, reference to a graphical representation of content, and a free-text account of the content. end example]

identifier

protected java.util.Optional<java.lang.String> identifier

An unambiguous reference to the resource within a given context.

keywords

protected java.util.Optional<java.lang.String> keywords

A delimited set of keywords to support searching and indexing. This is typically a list of terms that are not available elsewhere in the properties.

language

protected java.util.Optional<java.lang.String> language

The language of the intellectual content of the resource. [Note: IETF RFC 3066 provides guidance on encoding to represent languages. end note]

lastModifiedBy

protected java.util.Optional<java.lang.String> lastModifiedBy

The user who performed the last modification. The identification is environment-specific. [Example: A name, email address, or employee ID. end example] It is recommended that this value be as concise as possible.

lastPrinted

protected java.util.Optional<java.util.Date> lastPrinted

The date and time of the last printing.

modified

protected java.util.Optional<java.util.Date> modified

Date on which the resource was changed.

revision

protected java.util.Optional<java.lang.String> revision

The revision number. [Example: This value might indicate the number of saves or revisions, provided the application updates it after each revision. end example]

subject

protected java.util.Optional<java.lang.String> subject

The topic of the content of the resource.

title

protected java.util.Optional<java.lang.String> title

The name given to the resource.

version

protected java.util.Optional<java.lang.String> version

The version number. This value is set by the user or by the application.

Constructor Detail

PackagePropertiesPart

public PackagePropertiesPart(OPCPackage pack,
                             PackagePartName partName)
                      throws InvalidFormatException

Constructor.

Parameters:

pack - Container package.

partName - Name of this part.

Throws:

InvalidFormatException - Throws if the content is invalid.

Method Detail

getCategoryProperty

public java.util.Optional<java.lang.String> getCategoryProperty()

Get the category property.

Specified by:

getCategoryProperty in interface PackageProperties

Returns:

property value

getContentStatusProperty

public java.util.Optional<java.lang.String> getContentStatusProperty()

Get content status.

Specified by:

getContentStatusProperty in interface PackageProperties

Returns:

property value

getContentTypeProperty

public java.util.Optional<java.lang.String> getContentTypeProperty()

Get content type.

Specified by:

getContentTypeProperty in interface PackageProperties

Returns:

property value

getCreatedProperty

public java.util.Optional<java.util.Date> getCreatedProperty()

Get created date.

Specified by:

getCreatedProperty in interface PackageProperties

Returns:

property value

getCreatedPropertyString

public java.lang.String getCreatedPropertyString()

Get created date formatted into a String.

Returns:

A string representation of the created date.

getCreatorProperty

public java.util.Optional<java.lang.String> getCreatorProperty()

Get creator.

Specified by:

getCreatorProperty in interface PackageProperties

Returns:

property value

getDescriptionProperty

public java.util.Optional<java.lang.String> getDescriptionProperty()

Get description.

Specified by:

getDescriptionProperty in interface PackageProperties

getIdentifierProperty

public java.util.Optional<java.lang.String> getIdentifierProperty()

Get identifier.

Specified by:

getIdentifierProperty in interface PackageProperties

Returns:

property value

getKeywordsProperty

public java.util.Optional<java.lang.String> getKeywordsProperty()

Get keywords.

Specified by:

getKeywordsProperty in interface PackageProperties

Returns:

property value

getLanguageProperty

public java.util.Optional<java.lang.String> getLanguageProperty()

Get the language.

Specified by:

getLanguageProperty in interface PackageProperties

Returns:

property value

getLastModifiedByProperty

public java.util.Optional<java.lang.String> getLastModifiedByProperty()

Get the author of last modifications.

Specified by:

getLastModifiedByProperty in interface PackageProperties

getLastPrintedProperty

public java.util.Optional<java.util.Date> getLastPrintedProperty()

Get last printed date.

Specified by:

getLastPrintedProperty in interface PackageProperties

Returns:

property value

getLastPrintedPropertyString

public java.lang.String getLastPrintedPropertyString()

Get last printed date formatted into a String.

Returns:

A string representation of the last printed date.

getModifiedProperty

public java.util.Optional<java.util.Date> getModifiedProperty()

Get modified date.

Specified by:

getModifiedProperty in interface PackageProperties

Returns:

property value

getModifiedPropertyString

public java.lang.String getModifiedPropertyString()

Get modified date formatted into a String.

Returns:

A string representation of the modified date.

getRevisionProperty

public java.util.Optional<java.lang.String> getRevisionProperty()

Get revision.

Specified by:

getRevisionProperty in interface PackageProperties

Returns:

property value

getSubjectProperty

public java.util.Optional<java.lang.String> getSubjectProperty()

Get subject.

Specified by:

getSubjectProperty in interface PackageProperties

Returns:

property value

getTitleProperty

public java.util.Optional<java.lang.String> getTitleProperty()

Get title.

Specified by:

getTitleProperty in interface PackageProperties

Returns:

property value

getVersionProperty

public java.util.Optional<java.lang.String> getVersionProperty()

Get version.

Specified by:

getVersionProperty in interface PackageProperties

Returns:

property value

setCategoryProperty

public void setCategoryProperty(java.lang.String category)

Set the category.

Specified by:

setCategoryProperty in interface PackageProperties

setCategoryProperty

public void setCategoryProperty(java.util.Optional<java.lang.String> category)

Set the category.

Specified by:

setCategoryProperty in interface PackageProperties

setContentStatusProperty

public void setContentStatusProperty(java.lang.String contentStatus)

Set the content status.

Specified by:

setContentStatusProperty in interface PackageProperties

setContentStatusProperty

public void setContentStatusProperty(java.util.Optional<java.lang.String> contentStatus)

Set the content status.

Specified by:

setContentStatusProperty in interface PackageProperties

setContentTypeProperty

public void setContentTypeProperty(java.lang.String contentType)

Set the content type.

Specified by:

setContentTypeProperty in interface PackageProperties

setContentTypeProperty

public void setContentTypeProperty(java.util.Optional<java.lang.String> contentType)

Set the content type.

Specified by:

setContentTypeProperty in interface PackageProperties

setCreatedProperty

public void setCreatedProperty(java.lang.String created)
                        throws InvalidFormatException

Set the created date.

Specified by:

setCreatedProperty in interface PackageProperties

Throws:

InvalidFormatException - only since POI 5.2.0, used to throw unchecked exception IllegalArgumentException if format was invalid

See Also:

PackageProperties.setCreatedProperty(java.util.Optional)

setCreatedProperty

public void setCreatedProperty(java.util.Optional<java.util.Date> created)

Set the created date.

Specified by:

setCreatedProperty in interface PackageProperties

setCreatorProperty

public void setCreatorProperty(java.lang.String creator)

Set the creator.

Specified by:

setCreatorProperty in interface PackageProperties

setCreatorProperty

public void setCreatorProperty(java.util.Optional<java.lang.String> creator)

Set the creator.

Specified by:

setCreatorProperty in interface PackageProperties

setDescriptionProperty

public void setDescriptionProperty(java.lang.String description)

Set the description.

Specified by:

setDescriptionProperty in interface PackageProperties

setDescriptionProperty

public void setDescriptionProperty(java.util.Optional<java.lang.String> description)

Set the description.

Specified by:

setDescriptionProperty in interface PackageProperties

setIdentifierProperty

public void setIdentifierProperty(java.lang.String identifier)

Set identifier.

Specified by:

setIdentifierProperty in interface PackageProperties

setIdentifierProperty

public void setIdentifierProperty(java.util.Optional<java.lang.String> identifier)

Set identifier.

Specified by:

setIdentifierProperty in interface PackageProperties

setKeywordsProperty

public void setKeywordsProperty(java.lang.String keywords)

Set keywords.

Specified by:

setKeywordsProperty in interface PackageProperties

setKeywordsProperty

public void setKeywordsProperty(java.util.Optional<java.lang.String> keywords)

Set keywords.

Specified by:

setKeywordsProperty in interface PackageProperties

setLanguageProperty

public void setLanguageProperty(java.lang.String language)

Set language.

Specified by:

setLanguageProperty in interface PackageProperties

setLanguageProperty

public void setLanguageProperty(java.util.Optional<java.lang.String> language)

Set language.

Specified by:

setLanguageProperty in interface PackageProperties

setLastModifiedByProperty

public void setLastModifiedByProperty(java.lang.String lastModifiedBy)

Set last modifications author.

Specified by:

setLastModifiedByProperty in interface PackageProperties

setLastModifiedByProperty

public void setLastModifiedByProperty(java.util.Optional<java.lang.String> lastModifiedBy)

Set last modifications author.

Specified by:

setLastModifiedByProperty in interface PackageProperties

setLastPrintedProperty

public void setLastPrintedProperty(java.lang.String lastPrinted)
                            throws InvalidFormatException

Set last printed date.

Specified by:

setLastPrintedProperty in interface PackageProperties

Throws:

InvalidFormatException - only since POI 5.2.0, used to throw unchecked exception IllegalArgumentException if format was invalid

See Also:

PackageProperties.setLastPrintedProperty(java.util.Optional)

setLastPrintedProperty

public void setLastPrintedProperty(java.util.Optional<java.util.Date> lastPrinted)

Set last printed date.

Specified by:

setLastPrintedProperty in interface PackageProperties

setModifiedProperty

public void setModifiedProperty(java.lang.String modified)
                         throws InvalidFormatException

Set last modification date.

Specified by:

setModifiedProperty in interface PackageProperties

Throws:

InvalidFormatException - only since POI 5.2.0, used to throw unchecked exception IllegalArgumentException if format was invalid

See Also:

PackageProperties.setModifiedProperty(java.util.Optional)

setModifiedProperty

public void setModifiedProperty(java.util.Optional<java.util.Date> modified)

Set last modification date.

Specified by:

setModifiedProperty in interface PackageProperties

setRevisionProperty

public void setRevisionProperty(java.util.Optional<java.lang.String> revision)

Set revision.

Specified by:

setRevisionProperty in interface PackageProperties

setRevisionProperty

public void setRevisionProperty(java.lang.String revision)

Set revision.

Specified by:

setRevisionProperty in interface PackageProperties

setSubjectProperty

public void setSubjectProperty(java.lang.String subject)

Set subject.

Specified by:

setSubjectProperty in interface PackageProperties

setSubjectProperty

public void setSubjectProperty(java.util.Optional<java.lang.String> subject)

Set subject.

Specified by:

setSubjectProperty in interface PackageProperties

setTitleProperty

public void setTitleProperty(java.lang.String title)

Set title.

Specified by:

setTitleProperty in interface PackageProperties

setTitleProperty

public void setTitleProperty(java.util.Optional<java.lang.String> title)

Set title.

Specified by:

setTitleProperty in interface PackageProperties

setVersionProperty

public void setVersionProperty(java.lang.String version)

Set version.

Specified by:

setVersionProperty in interface PackageProperties

setVersionProperty

public void setVersionProperty(java.util.Optional<java.lang.String> version)

Set version.

Specified by:

setVersionProperty in interface PackageProperties

getInputStreamImpl

protected java.io.InputStream getInputStreamImpl()

Description copied from class: PackagePart

Method that gets the input stream for this part.

Specified by:

getInputStreamImpl in class PackagePart

Returns:

input stream for this part

getOutputStreamImpl

protected java.io.OutputStream getOutputStreamImpl()

Description copied from class: PackagePart

Method that gets the output stream for this part.

Specified by:

getOutputStreamImpl in class PackagePart

Returns:

output stream for this part

save

public boolean save(java.io.OutputStream zos)

Description copied from class: PackagePart

Save the content of this part and the associated relationships part (if this part own at least one relationship) into the specified output stream.

Specified by:

save in class PackagePart

Parameters:

zos - Output stream to save this part.

Returns:

true if the content has been successfully stored, false otherwise. More information about errors may be logged via Log4j 2.

load

public boolean load(java.io.InputStream ios)

Description copied from class: PackagePart

Load the content of this part.

Specified by:

load in class PackagePart

Parameters:

ios - The input stream of the content to load.

Returns:

true if the content has been successfully loaded, false otherwise. More information about errors may be logged via Log4j 2.

close

public void close()

Description copied from class: PackagePart

Close this part : flush this part, close the input stream and output stream. After this method call, the part must be available for packaging.

Specified by:

close in class PackagePart

flush

public void flush()

Description copied from class: PackagePart

Flush the content of this part. If the input stream and/or output stream as in a waiting state to read or write, the must to empty their respective buffer.

Specified by:

flush in class PackagePart