at.gv.egiz.pdfas.api.commons
Interface SignatureInformation

All Known Subinterfaces:

VerifyResult

All Known Implementing Classes:

SignatureInformationAdapter, VerifyResultAdapter

public interface SignatureInformation

Holds the information of one found signature block, which is the signed data and the corresponding signature information.

Author:

wprinz

Method Summary

Object	getInternalSignatureInformation() Returns additional, internal information about the found signature.
List	getNonTextualObjects() Returns a list<NonTextObjectInfo> of non textual objects in the pdf document.
String	getSignatureType() Returns the type of this signature (binary/textual).
DataSource	getSignedData() Returns the DataSource providing the data that was signed.
X509Certificate	getSignerCertificate() Returns the certificate of the signer.
Date	getSigningTime() Returns the signing time, which is the time when the signature was created.
String	getTimeStampValue() Returns the embedded /TimeStamp value (b64 encoded) from the signature if available.
boolean	hasNonTextualObjects() Returns true if non textual objects have been found, false if not.
void	setNonTextualObjects(List nonTextualObjects)

Method Detail

getSignatureType

public String getSignatureType()

Returns the type of this signature (binary/textual).

May be Constants.SIGNATURE_TYPE_BINARY or Constants.SIGNATURE_TYPE_TEXTUAL.

Returns:

Returns the type of this signature (binary/textual).

getSignedData

public DataSource getSignedData()

Returns the DataSource providing the data that was signed.

Note that this is the signed data as sent to the verification device by PDF-AS. The verification device (e.g. MOA) may perform several other transformations on the data before feeding it to the signature hash function. To get the actual hashed data use the ReturnHashInputData mechanism (which is very slow).

Returns:

Returns the DataSource providing the data that was signed.

See Also:

VerifyParameters.setReturnHashInputData(boolean), VerifyResult.getHashInputData()

getSignerCertificate

public X509Certificate getSignerCertificate()

Returns the certificate of the signer.

Information like subject name, issuer name or serial number can be retrieved form this certificate.

Returns:

Returns the certificate of the signer.

getSigningTime

public Date getSigningTime()

Returns the signing time, which is the time when the signature was created.

Returns:

Returns the signing time, which is the time when the signature was created.

getInternalSignatureInformation

public Object getInternalSignatureInformation()

Returns additional, internal information about the found signature.

Note that this provides a way for developers to gather core information about the signature. What information is returned strongly depends on the core implementation.

Returns:

Returns additional, internal information about the signature. Null means that no additional information is available.

getTimeStampValue

public String getTimeStampValue()

Returns the embedded /TimeStamp value (b64 encoded) from the signature if available.

Returns:

getNonTextualObjects

public List getNonTextualObjects()

Returns a list<NonTextObjectInfo> of non textual objects in the pdf document. Only available for textual signatures. Show this to the user who signed the textual content only!

Returns:

List<NonTextObjectInfo or null of not available (binary signature)

setNonTextualObjects

public void setNonTextualObjects(List nonTextualObjects)

hasNonTextualObjects

public boolean hasNonTextualObjects()

Returns true if non textual objects have been found, false if not.

Returns:

true if non textual objects have been found, false if not.