com.itextpdf.pdfa

Class PdfADocument

java.lang.Object

com.itextpdf.kernel.pdf.PdfDocument

com.itextpdf.pdfa.PdfADocument

All Implemented Interfaces:

IEventDispatcher, Closeable, Serializable, AutoCloseable

public class PdfADocument
extends PdfDocument

This class extends PdfDocument and is in charge of creating files that comply with the PDF/A standard. Client code is still responsible for making sure the file is actually PDF/A compliant: multiple steps must be undertaken (depending on the PdfAConformanceLevel) to ensure that the PDF/A standard is followed. This class will throw exceptions, mostly PdfAConformanceException, and thus refuse to output a PDF/A file if at any point the document does not adhere to the PDF/A guidelines specified by the PdfAConformanceLevel.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected PdfAChecker	checker

Fields inherited from class com.itextpdf.kernel.pdf.PdfDocument

catalog, closed, closeReader, closeWriter, currentPage, defaultPageSize, eventDispatcher, fingerPrint, flushUnusedObjects, info, initialDocumentId, isClosing, modifiedDocumentId, pdfVersion, properties, reader, structParentIndex, structTreeRoot, tagStructureContext, trailer, userProperties, writer, xmpMetadata

Constructor Summary

Constructors

Constructor and Description
PdfADocument(PdfReader reader, PdfWriter writer) Opens a PDF/A document in the stamping mode.
PdfADocument(PdfReader reader, PdfWriter writer, StampingProperties properties) Open a PDF/A document in stamping mode.
PdfADocument(PdfWriter writer, PdfAConformanceLevel conformanceLevel, PdfOutputIntent outputIntent) Constructs a new PdfADocument for writing purposes, i.e.

Method Summary

Modifier and Type	Method and Description
protected void	addCustomMetadataExtensions(XMPMeta xmpMeta) Adds custom XMP metadata extension.
protected void	checkIsoConformance() Checks whether PDF document conforms a specific standard.
void	checkIsoConformance(Object obj, IsoKey key) Checks whether PDF document conforms a specific standard.
void	checkIsoConformance(Object obj, IsoKey key, PdfResources resources) Checks whether PDF document conforms a specific standard.
void	checkShowTextIsoConformance(Object obj, PdfResources resources) Deprecated. Will be removed in 7.1.0.
protected void	flushFonts()
protected void	flushObject(PdfObject pdfObject, boolean canBeInObjStm) Flush an object.
PdfAConformanceLevel	getConformanceLevel() Gets the PdfAConformanceLevel set in the constructor or in the metadata of the PdfReader.
protected Counter	getCounter() Gets Counter instance.
protected void	initTagStructureContext() Initialize TagStructureContext.
protected void	setChecker(PdfAConformanceLevel conformanceLevel)
protected void	updateXmpMetadata() Updates XMP metadata.

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

addEventHandler, addFileAttachment, addFileAttachment, addFileAttachment, addFont, addNamedDestination, addNewPage, addNewPage, addNewPage, addNewPage, addOutputIntent, addPage, addPage, checkAndAddPage, checkAndAddPage, checkClosingStatus, close, copyPagesTo, copyPagesTo, copyPagesTo, copyPagesTo, copyPagesTo, copyPagesTo, copyPagesTo, copyPagesTo, createNextIndirectReference, dispatchEvent, dispatchEvent, flushCopiedObjects, getCatalog, getDefaultFont, getDefaultPageSize, getDocumentFonts, getDocumentInfo, getFingerPrint, getFirstPage, getFont, getLastPage, getNextStructParentIndex, getNumberOfPages, getNumberOfPdfObjects, getOutlines, getPage, getPage, getPageLabels, getPageNumber, getPageNumber, getPdfObject, getPdfVersion, getReader, getStructTreeRoot, getTagStructureContext, getTrailer, getWriter, getXmpMetadata, getXmpMetadata, hasEventHandler, hasOutlines, initializeOutlines, isAppendMode, isClosed, isCloseReader, isCloseWriter, isFlushUnusedObjects, isTagged, listIndirectReferences, markObjectAsMustBeFlushed, open, registerProduct, removeAllHandlers, removeEventHandler, removePage, removePage, setCloseReader, setCloseWriter, setDefaultPageSize, setFlushUnusedObjects, setInitialDocumentId, setModifiedDocumentId, setTagged, setUserProperties, setXmpMetadata, setXmpMetadata, setXmpMetadata, storeLinkAnnotation, updateDefaultXmpMetadata

Methods inherited from class java.lang.Object

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

Field Detail

checker

protected PdfAChecker checker

Constructor Detail

PdfADocument

public PdfADocument(PdfWriter writer,
                    PdfAConformanceLevel conformanceLevel,
                    PdfOutputIntent outputIntent)

Constructs a new PdfADocument for writing purposes, i.e. from scratch. A PDF/A file has a conformance level, and must have an explicit output intent.

Parameters:

writer - the PdfWriter object to write to

conformanceLevel - the generation and strictness level of the PDF/A that must be followed.

outputIntent - a PdfOutputIntent

PdfADocument

public PdfADocument(PdfReader reader,
                    PdfWriter writer)

Opens a PDF/A document in the stamping mode.

Parameters:

reader - PDF reader.

writer - PDF writer.

PdfADocument

public PdfADocument(PdfReader reader,
                    PdfWriter writer,
                    StampingProperties properties)

Open a PDF/A document in stamping mode.

Parameters:

reader - PDF reader.

writer - PDF writer.

properties - properties of the stamping process

Method Detail

checkIsoConformance

public void checkIsoConformance(Object obj,
                                IsoKey key)

Description copied from class: PdfDocument

Checks whether PDF document conforms a specific standard. Shall be override.

Overrides:

checkIsoConformance in class PdfDocument

Parameters:

obj - An object to conform.

key - type of object to conform.

checkShowTextIsoConformance

@Deprecated
public void checkShowTextIsoConformance(Object obj,
                                                    PdfResources resources)

Deprecated. Will be removed in 7.1.0.

Description copied from class: PdfDocument

Checks whether PDF document conforms a specific standard. Shall be override.

Overrides:

checkShowTextIsoConformance in class PdfDocument

Parameters:

obj - a CanvasGraphicsState object to conform.

resources - PdfResources associated with an object to check.

checkIsoConformance

public void checkIsoConformance(Object obj,
                                IsoKey key,
                                PdfResources resources)

Description copied from class: PdfDocument

Checks whether PDF document conforms a specific standard. Shall be override.

Overrides:

checkIsoConformance in class PdfDocument

Parameters:

obj - an object to conform.

key - type of object to conform.

resources - PdfResources associated with an object to check.

getConformanceLevel

public PdfAConformanceLevel getConformanceLevel()

Gets the PdfAConformanceLevel set in the constructor or in the metadata of the PdfReader.

Returns:

a PdfAConformanceLevel

addCustomMetadataExtensions

protected void addCustomMetadataExtensions(XMPMeta xmpMeta)

Description copied from class: PdfDocument

Adds custom XMP metadata extension. Useful for PDF/UA, ZUGFeRD, etc.

Overrides:

addCustomMetadataExtensions in class PdfDocument

Parameters:

xmpMeta - XMPMeta to add custom metadata to.

updateXmpMetadata

protected void updateXmpMetadata()

Description copied from class: PdfDocument

Updates XMP metadata. Shall be override.

Overrides:

updateXmpMetadata in class PdfDocument

checkIsoConformance

protected void checkIsoConformance()

Description copied from class: PdfDocument

Checks whether PDF document conforms a specific standard. Shall be override.

Overrides:

checkIsoConformance in class PdfDocument

flushObject

protected void flushObject(PdfObject pdfObject,
                           boolean canBeInObjStm)
                    throws IOException

Description copied from class: PdfDocument

Flush an object.

Overrides:

flushObject in class PdfDocument

Parameters:

pdfObject - object to flush.

canBeInObjStm - indicates whether object can be placed into object stream.

Throws:

IOException - on error.

flushFonts

protected void flushFonts()

Overrides:

flushFonts in class PdfDocument

setChecker

protected void setChecker(PdfAConformanceLevel conformanceLevel)

initTagStructureContext

protected void initTagStructureContext()

Description copied from class: PdfDocument

Initialize TagStructureContext.

Overrides:

initTagStructureContext in class PdfDocument

getCounter

protected Counter getCounter()

Description copied from class: PdfDocument

Gets Counter instance.

Overrides:

getCounter in class PdfDocument

Returns:

Counter instance.