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 fileDisplay, PdfDictionary fileParameter, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, byte[] fileStore, String fileDisplay, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, byte[] fileStore, String description, String fileDisplay, PdfDictionary fileParameter, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, byte[] fileStore, String description, String fileDisplay, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, byte[] fileStore, String description, String fileDisplay, PdfName mimeType, PdfDictionary fileParameter, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, InputStream is, String description, String fileDisplay, PdfName mimeType, PdfDictionary fileParameter, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, InputStream is, String description, String fileDisplay, PdfName mimeType, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, String filePath, String fileDisplay, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, String filePath, String description, String fileDisplay, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, String filePath, String description, String fileDisplay, PdfName mimeType, PdfDictionary fileParameter, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createEmbeddedFileSpec(PdfDocument doc, String filePath, String description, String fileDisplay, PdfName mimeType, PdfName afRelationshipValue) Embed a file to a PdfDocument.
static PdfFileSpec	createExternalFileSpec(PdfDocument doc, String filePath)
static PdfFileSpec	createExternalFileSpec(PdfDocument doc, String filePath, PdfName afRelationshipValue)
PdfArray	getFileIdentifier()
PdfImageXObject	getThumbnailImage() PDF 2.0.
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	setThumbnailImage(PdfImageXObject thumbnailImage) PDF 2.0.
PdfFileSpec	setVolatile(PdfBoolean isVolatile)
static PdfFileSpec	wrapFileSpecObject(PdfObject fileSpecObject)

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

wrapFileSpecObject

public static PdfFileSpec wrapFileSpecObject(PdfObject fileSpecObject)

createExternalFileSpec

public static PdfFileSpec createExternalFileSpec(PdfDocument doc,
                                                 String filePath,
                                                 PdfName afRelationshipValue)

createExternalFileSpec

public static PdfFileSpec createExternalFileSpec(PdfDocument doc,
                                                 String filePath)

createEmbeddedFileSpec

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

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.

Returns:

PdfFileSpec containing the file specification of the file as Pdfobject

createEmbeddedFileSpec

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

Embed a file to a PdfDocument.

Parameters:

doc - PdfDocument to add the file to

fileStore - byte[] containing the file

fileDisplay - actual file name stored in the pdf

fileParameter - Pdfdictionary containing fil parameters

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

Returns:

PdfFileSpec containing the file specification of the file as Pdfobject

createEmbeddedFileSpec

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

Embed a file to a PdfDocument.

Parameters:

doc - PdfDocument to add the file to

fileStore - byte[] containing the file

fileDisplay - actual file name stored in the pdf

fileParameter - Pdfdictionary containing fil parameters

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

Returns:

PdfFileSpec containing the file specification of the file as Pdfobject

createEmbeddedFileSpec

public static PdfFileSpec createEmbeddedFileSpec(PdfDocument doc,
                                                 byte[] fileStore,
                                                 String fileDisplay,
                                                 PdfName afRelationshipValue)

Embed a file to a PdfDocument.

Parameters:

doc - PdfDocument to add the file to

fileStore - byte[] containing the file

fileDisplay - actual file name stored in the pdf

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

Returns:

PdfFileSpec containing the file specification of the file as Pdfobject

createEmbeddedFileSpec

public static PdfFileSpec createEmbeddedFileSpec(PdfDocument doc,
                                                 byte[] fileStore,
                                                 String description,
                                                 String fileDisplay,
                                                 PdfName afRelationshipValue)

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

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

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,
                                                 PdfDictionary fileParameter,
                                                 PdfName afRelationshipValue)
                                          throws IOException

Embed a file to a PdfDocument.

Parameters:

doc -

filePath -

description -

fileDisplay -

mimeType -

fileParameter -

afRelationshipValue -

Throws:

IOException

createEmbeddedFileSpec

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

Embed a file to a PdfDocument.

Parameters:

doc -

filePath -

description -

fileDisplay -

mimeType -

afRelationshipValue -

Throws:

IOException

createEmbeddedFileSpec

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

Embed a file to a PdfDocument.

Parameters:

doc -

filePath -

description -

fileDisplay -

afRelationshipValue -

Throws:

IOException

createEmbeddedFileSpec

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

Embed a file to a PdfDocument.

Parameters:

doc -

filePath -

fileDisplay -

afRelationshipValue -

Throws:

IOException

createEmbeddedFileSpec

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

Embed a file to a PdfDocument.

Parameters:

doc -

is -

description -

fileDisplay -

mimeType -

fileParameter -

afRelationshipValue -

createEmbeddedFileSpec

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

Embed a file to a PdfDocument.

Parameters:

doc -

is -

description -

fileDisplay -

mimeType -

afRelationshipValue -

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)

setThumbnailImage

public PdfFileSpec setThumbnailImage(PdfImageXObject thumbnailImage)

PDF 2.0. Sets a stream object defining the thumbnail image for the file specification.

Parameters:

thumbnailImage - image used as a thumbnail

Returns:

this PdfFileSpec instance

getThumbnailImage

public PdfImageXObject getThumbnailImage()

PDF 2.0. Gets a stream object defining the thumbnail image for the file specification.

Returns:

image used as a thumbnail, or null if it is not set

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.