com.itextpdf.kernel.pdf.filespec

Class PdfFileSpec

java.lang.Object

com.itextpdf.kernel.pdf.PdfObjectWrapper<PdfObject>

com.itextpdf.kernel.pdf.filespec.PdfFileSpec

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

PdfDictionaryFS, PdfStringFS

public class PdfFileSpec
extends PdfObjectWrapper<PdfObject>

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PdfFileSpec(PdfObject pdfObject)

Method Summary

Modifier and Type	Method and Description
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, byte[] fileStore, String description, String fileDisplay, PdfName mimeType, PdfDictionary fileParameter, PdfName afRelationshipValue, boolean isUnicodeFileName) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, InputStream is, String description, String fileDisplay, PdfName mimeType, PdfName afRelationshipValue, boolean isUnicodeFileName)
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, String filePath, String description, String fileDisplay, PdfName mimeType, PdfName afRelationshipValue, boolean isUnicodeFileName)
static PdfFileSpec	createExternalFileSpec(PdfDocument doc, String filePath, boolean isUnicodeFileName)
PdfArray	getFileIdentifier()
PdfBoolean	isVolatile()
protected boolean	isWrappedObjectMustBeIndirect() Defines if the object behind this wrapper must be an indirect object in the resultant document.
PdfFileSpec	put(PdfName key, PdfObject value)
PdfFileSpec	setCollectionItem(PdfCollectionItem item)
PdfFileSpec	setFileIdentifier(PdfArray fileIdentifier)
PdfFileSpec	setVolatile(PdfBoolean isVolatile)

Methods inherited from class com.itextpdf.kernel.pdf.PdfObjectWrapper

ensureObjectIsAddedToDocument, ensureUnderlyingObjectHasIndirectReference, flush, getPdfObject, isFlushed, makeIndirect, makeIndirect, markObjectAsIndirect, setForbidRelease, setModified, setPdfObject, unsetForbidRelease

Methods inherited from class java.lang.Object

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

Constructor Detail

PdfFileSpec

protected PdfFileSpec(PdfObject pdfObject)

Method Detail

createExternalFileSpec

public static PdfFileSpec createExternalFileSpec(PdfDocument doc,
                                                 String filePath,
                                                 boolean isUnicodeFileName)

createEmbeddedFileSpec

public static PdfFileSpec createEmbeddedFileSpec(PdfDocument doc,
                                                 byte[] fileStore,
                                                 String description,
                                                 String fileDisplay,
                                                 PdfName mimeType,
                                                 PdfDictionary fileParameter,
                                                 PdfName afRelationshipValue,
                                                 boolean isUnicodeFileName)

Embed a file to a PdfDocument.

Parameters:

doc - PdfDocument to add the file to

fileStore - byte[] containing the file

description - file description

fileDisplay - actual file name stored in the pdf

mimeType - mime-type of the file

fileParameter - Pdfdictionary containing fil parameters

afRelationshipValue - AFRelationship key value, @see AFRelationshipValue. If null, @see AFRelationshipValue.Unspecified will be added.

isUnicodeFileName -

Returns:

PdfFileSpec containing the file specification of the file as Pdfobject

createEmbeddedFileSpec

public static PdfFileSpec createEmbeddedFileSpec(PdfDocument doc,
                                                 String filePath,
                                                 String description,
                                                 String fileDisplay,
                                                 PdfName mimeType,
                                                 PdfName afRelationshipValue,
                                                 boolean isUnicodeFileName)
                                          throws IOException

Parameters:

doc -

filePath -

description -

fileDisplay -

mimeType -

afRelationshipValue -

isUnicodeFileName -

Throws:

IOException

createEmbeddedFileSpec

public static PdfFileSpec createEmbeddedFileSpec(PdfDocument doc,
                                                 InputStream is,
                                                 String description,
                                                 String fileDisplay,
                                                 PdfName mimeType,
                                                 PdfName afRelationshipValue,
                                                 boolean isUnicodeFileName)

Parameters:

doc -

is -

description -

fileDisplay -

mimeType -

afRelationshipValue -

isUnicodeFileName -

setFileIdentifier

public PdfFileSpec setFileIdentifier(PdfArray fileIdentifier)

getFileIdentifier

public PdfArray getFileIdentifier()

setVolatile

public PdfFileSpec setVolatile(PdfBoolean isVolatile)

isVolatile

public PdfBoolean isVolatile()

setCollectionItem

public PdfFileSpec setCollectionItem(PdfCollectionItem item)

put

public PdfFileSpec put(PdfName key,
                       PdfObject value)

isWrappedObjectMustBeIndirect

protected boolean isWrappedObjectMustBeIndirect()

Description copied from class: PdfObjectWrapper

Defines if the object behind this wrapper must be an indirect object in the resultant document.

If this method returns true it doesn't necessarily mean that object must be in the indirect state at any moment, but rather defines that when the object will be written to the document it will be transformed into indirect object if it's not indirect yet.

Return value of this method shouldn't depend on any logic, it should return always true or false.

Specified by:

isWrappedObjectMustBeIndirect in class PdfObjectWrapper<PdfObject>

Returns:

true if in the resultant document the object behind the wrapper must be indirect, otherwise false.