com.itextpdf.signatures

Class PdfSignature

java.lang.Object

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

com.itextpdf.signatures.PdfSignature

All Implemented Interfaces:

Serializable

public class PdfSignature
extends com.itextpdf.kernel.pdf.PdfObjectWrapper<com.itextpdf.kernel.pdf.PdfDictionary>

Represents the signature dictionary.

Author:

Paulo Soares

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
PdfSignature() Creates new PdfSignature.
PdfSignature(com.itextpdf.kernel.pdf.PdfDictionary sigDictionary)
PdfSignature(com.itextpdf.kernel.pdf.PdfName filter, com.itextpdf.kernel.pdf.PdfName subFilter) Creates new PdfSignature.

Method Summary

Modifier and Type	Method and Description
com.itextpdf.kernel.pdf.PdfArray	getByteRange() Gets the /ByteRange.
com.itextpdf.kernel.pdf.PdfString	getCert() Gets the /Cert entry value of this signature.
com.itextpdf.kernel.pdf.PdfString	getContents() Gets the /Contents entry value.
com.itextpdf.kernel.pdf.PdfString	getDate() Gets the /M value.
String	getLocation() Gets the /Location entry value.
String	getName() gets the /Name of the person signing the document.
String	getReason()
com.itextpdf.kernel.pdf.PdfName	getSubFilter() A name that describes the encoding of the signature value and key information in the signature dictionary.
com.itextpdf.kernel.pdf.PdfName	getType() The type of PDF object that the wrapped dictionary describes; if present, shall be PdfName.Sig for a signature dictionary or PdfName.DocTimeStamp for a timestamp signature dictionary.
protected boolean	isWrappedObjectMustBeIndirect()
PdfSignature	put(com.itextpdf.kernel.pdf.PdfName key, com.itextpdf.kernel.pdf.PdfObject value)
void	setByteRange(int[] range) Sets the /ByteRange.
void	setCert(byte[] cert) Sets the /Cert value of this signature.
void	setContact(String contactInfo) Sets the /ContactInfo value.
void	setContents(byte[] contents) Sets the /Contents value to the specified byte[].
void	setDate(com.itextpdf.kernel.pdf.PdfDate date) Sets the /M value.
void	setLocation(String location) Sets the /Location value.
void	setName(String name) Sets the /Name of the person signing the document.
void	setReason(String reason) Sets the /Reason value.
void	setSignatureCreator(String signatureCreator) Sets the signature creator name in the PdfSignatureBuildProperties dictionary.

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

PdfSignature

public PdfSignature()

Creates new PdfSignature.

PdfSignature

public PdfSignature(com.itextpdf.kernel.pdf.PdfName filter,
                    com.itextpdf.kernel.pdf.PdfName subFilter)

Creates new PdfSignature.

Parameters:

filter - PdfName of the signature handler to use when validating this signature

subFilter - PdfName that describes the encoding of the signature

PdfSignature

public PdfSignature(com.itextpdf.kernel.pdf.PdfDictionary sigDictionary)

Method Detail

getSubFilter

public com.itextpdf.kernel.pdf.PdfName getSubFilter()

A name that describes the encoding of the signature value and key information in the signature dictionary.

Returns:

a PdfName which usually has a value either PdfName.Adbe_pkcs7_detached or PdfName.ETSI_CAdES_DETACHED.

getType

public com.itextpdf.kernel.pdf.PdfName getType()

The type of PDF object that the wrapped dictionary describes; if present, shall be PdfName.Sig for a signature dictionary or PdfName.DocTimeStamp for a timestamp signature dictionary. Shall be not null if it's value is PdfName.DocTimeStamp. The default value is: PdfName.Sig.

Returns:

a PdfName that identifies type of the wrapped dictionary, returns null if it is not explicitly specified.

setByteRange

public void setByteRange(int[] range)

Sets the /ByteRange.

Parameters:

range - an array of pairs of integers that specifies the byte range used in the digest calculation. A pair consists of the starting byte offset and the length

getByteRange

public com.itextpdf.kernel.pdf.PdfArray getByteRange()

Gets the /ByteRange.

Returns:

an array of pairs of integers that specifies the byte range used in the digest calculation. A pair consists of the starting byte offset and the length.

setContents

public void setContents(byte[] contents)

Sets the /Contents value to the specified byte[].

Parameters:

contents - a byte[] representing the digest

getContents

public com.itextpdf.kernel.pdf.PdfString getContents()

Gets the /Contents entry value.

setCert

public void setCert(byte[] cert)

Sets the /Cert value of this signature.

Parameters:

cert - the byte[] representing the certificate chain

getCert

public com.itextpdf.kernel.pdf.PdfString getCert()

Gets the /Cert entry value of this signature.

setName

public void setName(String name)

Sets the /Name of the person signing the document.

Parameters:

name - name of the person signing the document

getName

public String getName()

gets the /Name of the person signing the document.

Returns:

name of the person signing the document.

setDate

public void setDate(com.itextpdf.kernel.pdf.PdfDate date)

Sets the /M value. Should only be used if the time of signing is not available in the signature.

Parameters:

date - time of signing

getDate

public com.itextpdf.kernel.pdf.PdfString getDate()

Gets the /M value. Should only be used if the time of signing is not available in the signature.

Returns:

PdfString which denotes time of signing.

setLocation

public void setLocation(String location)

Sets the /Location value.

Parameters:

location - physical location of signing

getLocation

public String getLocation()

Gets the /Location entry value.

Returns:

physical location of signing.

setReason

public void setReason(String reason)

Sets the /Reason value.

Parameters:

reason - reason for signing

getReason

public String getReason()

setSignatureCreator

public void setSignatureCreator(String signatureCreator)

Sets the signature creator name in the PdfSignatureBuildProperties dictionary.

Parameters:

signatureCreator - name of the signature creator

setContact

public void setContact(String contactInfo)

Sets the /ContactInfo value.

Parameters:

contactInfo - information to contact the person who signed this document

put

public PdfSignature put(com.itextpdf.kernel.pdf.PdfName key,
                        com.itextpdf.kernel.pdf.PdfObject value)

isWrappedObjectMustBeIndirect

protected boolean isWrappedObjectMustBeIndirect()

Specified by:

isWrappedObjectMustBeIndirect in class com.itextpdf.kernel.pdf.PdfObjectWrapper<com.itextpdf.kernel.pdf.PdfDictionary>