|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.itextpdf.text.pdf.PdfStamper
com.itextpdf.text.pdf.PdfAStamper
public class PdfAStamper
Extension of PdfStamper that will attempt to keep a file in conformance with the PDF/A standard.
PdfStamper
Field Summary |
---|
Fields inherited from class com.itextpdf.text.pdf.PdfStamper |
---|
hasSignature, sigApp, sigXmlApp, stamper |
Constructor Summary | |
---|---|
PdfAStamper(PdfReader reader,
OutputStream os,
char pdfVersion,
boolean append,
PdfAConformanceLevel conformanceLevel)
Starts the process of adding extra content to an existing PDF document keeping the document PDF/A conformant. |
|
PdfAStamper(PdfReader reader,
OutputStream os,
char pdfVersion,
PdfAConformanceLevel conformanceLevel)
Starts the process of adding extra content to an existing PDF document keeping the document PDF/A conformant. |
|
PdfAStamper(PdfReader reader,
OutputStream os,
PdfAConformanceLevel conformanceLevel)
Starts the process of adding extra content to an existing PDF document keeping the document PDF/A conformant. |
Method Summary | |
---|---|
static PdfAStamper |
createSignature(PdfReader reader,
OutputStream os,
char pdfVersion,
File tempFile,
boolean append,
PdfAConformanceLevel conformanceLevel)
Applies a digital signature to a document, possibly as a new revision, making possible multiple signatures. |
static PdfAStamper |
createSignature(PdfReader reader,
OutputStream os,
char pdfVersion,
File tempFile,
PdfAConformanceLevel conformanceLevel)
Applies a digital signature to a document. |
static PdfAStamper |
createSignature(PdfReader reader,
OutputStream os,
char pdfVersion,
PdfAConformanceLevel conformanceLevel)
Applies a digital signature to a document. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public PdfAStamper(PdfReader reader, OutputStream os, PdfAConformanceLevel conformanceLevel) throws DocumentException, IOException
reader
- the original document. It cannot be reusedos
- the output streamconformanceLevel
- PDF/A conformance level of a new PDF document
DocumentException
- on error
IOException
- or errorpublic PdfAStamper(PdfReader reader, OutputStream os, char pdfVersion, PdfAConformanceLevel conformanceLevel) throws DocumentException, IOException
reader
- the original document. It cannot be reusedos
- the output streampdfVersion
- the new pdf version or '\0' to keep the same version as the original documentconformanceLevel
- PDF/A conformance level of a new PDF document
DocumentException
- on error
IOException
- or errorpublic PdfAStamper(PdfReader reader, OutputStream os, char pdfVersion, boolean append, PdfAConformanceLevel conformanceLevel) throws DocumentException, IOException
reader
- the original document. It cannot be reusedos
- the output streampdfVersion
- the new pdf version or '\0' to keep the same version as the original documentappend
- if true
appends the document changes as a new revision. This is only useful for multiple signatures as nothing is gained in speed or memoryconformanceLevel
- PDF/A conformance level of a new PDF document
DocumentException
- on error
IOException
- or errorMethod Detail |
---|
public static PdfAStamper createSignature(PdfReader reader, OutputStream os, char pdfVersion, File tempFile, boolean append, PdfAConformanceLevel conformanceLevel) throws DocumentException, IOException
A possible use for adding a signature without invalidating an existing one is:
KeyStore ks = KeyStore.getInstance("pkcs12"); ks.load(new FileInputStream("my_private_key.pfx"), "my_password".toCharArray()); String alias = (String)ks.aliases().nextElement(); PrivateKey key = (PrivateKey)ks.getKey(alias, "my_password".toCharArray()); Certificate[] chain = ks.getCertificateChain(alias); PdfReader reader = new PdfReader("original.pdf"); FileOutputStream fout = new FileOutputStream("signed.pdf"); PdfStamper stp = PdfStamper.createSignature(reader, fout, '\0', new File("/temp"), true); PdfSignatureAppearance sap = stp.getSignatureAppearance(); sap.setCrypto(key, chain, null, PdfSignatureAppearance.WINCER_SIGNED); sap.setReason("I'm the author"); sap.setLocation("Lisbon"); // comment next line to have an invisible signature sap.setVisibleSignature(new Rectangle(100, 100, 200, 200), 1, null); stp.close();
reader
- the original documentos
- the output stream or null
to keep the document in the temporary filepdfVersion
- the new pdf version or '\0' to keep the same version as the original
documenttempFile
- location of the temporary file. If it's a directory a temporary file will be created there.
If it's a file it will be used directly. The file will be deleted on exit unless os
is null.
In that case the document can be retrieved directly from the temporary file. If it's null
no temporary file will be created and memory will be usedappend
- if true
the signature and all the other content will be added as a
new revision thus not invalidating existing signaturesconformanceLevel
- PDF/A conformance level of a new PDF document
PdfAStamper
DocumentException
- on error
IOException
- on errorpublic static PdfAStamper createSignature(PdfReader reader, OutputStream os, char pdfVersion, PdfAConformanceLevel conformanceLevel) throws DocumentException, IOException
Note that the pdf is created in memory.
A possible use is:
KeyStore ks = KeyStore.getInstance("pkcs12"); ks.load(new FileInputStream("my_private_key.pfx"), "my_password".toCharArray()); String alias = (String)ks.aliases().nextElement(); PrivateKey key = (PrivateKey)ks.getKey(alias, "my_password".toCharArray()); Certificate[] chain = ks.getCertificateChain(alias); PdfReader reader = new PdfReader("original.pdf"); FileOutputStream fout = new FileOutputStream("signed.pdf"); PdfStamper stp = PdfStamper.createSignature(reader, fout, '\0'); PdfSignatureAppearance sap = stp.getSignatureAppearance(); sap.setCrypto(key, chain, null, PdfSignatureAppearance.WINCER_SIGNED); sap.setReason("I'm the author"); sap.setLocation("Lisbon"); // comment next line to have an invisible signature sap.setVisibleSignature(new Rectangle(100, 100, 200, 200), 1, null); stp.close();
reader
- the original documentos
- the output streampdfVersion
- the new pdf version or '\0' to keep the same version as the original
documentconformanceLevel
- PDF/A conformance level of a new PDF document
PdfAStamper
DocumentException
- on error
IOException
- on errorpublic static PdfAStamper createSignature(PdfReader reader, OutputStream os, char pdfVersion, File tempFile, PdfAConformanceLevel conformanceLevel) throws DocumentException, IOException
A possible use is:
KeyStore ks = KeyStore.getInstance("pkcs12"); ks.load(new FileInputStream("my_private_key.pfx"), "my_password".toCharArray()); String alias = (String)ks.aliases().nextElement(); PrivateKey key = (PrivateKey)ks.getKey(alias, "my_password".toCharArray()); Certificate[] chain = ks.getCertificateChain(alias); PdfReader reader = new PdfReader("original.pdf"); FileOutputStream fout = new FileOutputStream("signed.pdf"); PdfStamper stp = PdfStamper.createSignature(reader, fout, '\0', new File("/temp")); PdfSignatureAppearance sap = stp.getSignatureAppearance(); sap.setCrypto(key, chain, null, PdfSignatureAppearance.WINCER_SIGNED); sap.setReason("I'm the author"); sap.setLocation("Lisbon"); // comment next line to have an invisible signature sap.setVisibleSignature(new Rectangle(100, 100, 200, 200), 1, null); stp.close();
reader
- the original documentos
- the output stream or null
to keep the document in the temporary filepdfVersion
- the new pdf version or '\0' to keep the same version as the original
documenttempFile
- location of the temporary file. If it's a directory a temporary file will be created there.
If it's a file it will be used directly. The file will be deleted on exit unless os
is null.
In that case the document can be retrieved directly from the temporary file. If it's null
no temporary file will be created and memory will be usedconformanceLevel
- PDF/A conformance level of a new PDF document
PdfAStamper
DocumentException
- on error
IOException
- on error
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |