COSDocument (veraPDF PDF Box PDF/A Validation Model Implementation 1.16.1 API)

java.lang.Object
- org.apache.pdfbox.cos.COSBase
- - org.apache.pdfbox.cos.COSDocument

All Implemented Interfaces:

Closeable, AutoCloseable, COSObjectable
```
public class COSDocument
extends COSBase
implements Closeable
```
This is the in-memory representation of the PDF document. You need to call close() on this object when you are done using it!!

Author:

Ben Litchfield

Constructor Summary

Constructors
Constructor and Description
`COSDocument()` Constructor.
`COSDocument(boolean useScratchFiles)` Constructor.
`COSDocument(File scratchDir, boolean useScratchFiles)` Constructor that will use a temporary file in the given directory for storage of the PDF streams.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Object`	`accept(ICOSVisitor visitor)` visitor pattern double dispatch method.
`void`	`addXRefTable(Map<COSObjectKey,Long> xrefTableValues)` Populate XRef HashMap with given values.
`void`	`close()` This will close all storage and delete the tmp files.
`COSStream`	`createCOSStream()` Creates a new COSStream using the current configuration for scratch files.
`COSStream`	`createCOSStream(COSDictionary dictionary)` Creates a new COSStream using the current configuration for scratch files.
`void`	`dereferenceObjectStreams()` This method will search the list of objects for types of ObjStm.
`protected void`	`finalize()` Warn the user in the finalizer if he didn't close the PDF document.
`COSObject`	`getCatalog()` This will get the document catalog.
`COSArray`	`getDocumentID()` This will get the document ID.
`COSDictionary`	`getEncryptionDictionary()` This will get the encryption dictionary if the document is encrypted or null if the document is not encrypted.
`COSDictionary`	`getFirstPageTrailer()` Returns the first page trailer.
`String`	`getHeader()`
`int`	`getHeaderCommentByte1()`
`int`	`getHeaderCommentByte2()`
`int`	`getHeaderCommentByte3()`
`int`	`getHeaderCommentByte4()`
`long`	`getHeaderOffset()`
`COSObjectKey`	`getKey(COSBase object)` Returns the COSObjectKey for a given COS object, or null if there is none.
`COSDictionary`	`getLastTrailer()` This will get the last document trailer.
`COSObject`	`getObjectByType(COSName type)` This will get the first dictionary object by type.
`COSObject`	`getObjectFromPool(COSObjectKey key)` This will get an object from the pool.
`List<COSObject>`	`getObjects()` This will get a list of all available objects.
`List<COSObject>`	`getObjectsByType(COSName type)` This will get a dictionary object by type.
`List<COSObject>`	`getObjectsByType(String type)` This will get all dictionary objects by type.
`int`	`getPostEOFDataSize()`
`long`	`getStartXref()` Return the startXref Position of the parsed document.
`COSDictionary`	`getTrailer()` This will get the document trailer.
`float`	`getVersion()` This will get the version extracted from the header of this PDF document.
`Map<COSObjectKey,Long>`	`getXrefTable()` Returns the xrefTable which is a mapping of ObjectKeys to byte offsets in the file.
`boolean`	`isClosed()` Returns true if this document has been closed.
`boolean`	`isDecrypted()` Indicates if a encrypted pdf is already decrypted after parsing.
`boolean`	`isEncrypted()` This will tell if this is an encrypted document.
`boolean`	`isLinearized()`
`Boolean`	`isXrefEOLMarkersComplyPDFA()`
`boolean`	`isXRefStream()` Determines if the trailer is a XRef stream or not.
`void`	`print()` This will print contents to stdout.
`COSObject`	`removeObject(COSObjectKey key)` Removes an object from the object pool.
`void`	`setDecrypted()` Signals that the document is decrypted completely.
`void`	`setDocumentID(COSArray id)` This will set the document ID.
`void`	`setEncryptionDictionary(COSDictionary encDictionary)` This will set the encryption dictionary, this should only be called when encrypting the document.
`void`	`setFirstPageTrailer(COSDictionary firstPageTrailer)`
`void`	`setHeader(String header)`
`void`	`setHeaderCommentByte1(int headerCommentByte1)`
`void`	`setHeaderCommentByte2(int headerCommentByte2)`
`void`	`setHeaderCommentByte3(int headerCommentByte3)`
`void`	`setHeaderCommentByte4(int headerCommentByte4)`
`void`	`setHeaderOffset(long headerOffset)`
`void`	`setIsLinearized(boolean isLinearized)`
`void`	`setIsXRefStream(boolean isXRefStreamValue)` Sets isXRefStream to the given value.
`void`	`setLastTrailer(COSDictionary lastTrailer)` This will set the document trailer.
`void`	`setPostEOFDataSize(int postEOFDataSize)`
`void`	`setStartXref(long startXrefValue)` This method set the startxref value of the document.
`void`	`setSubsectionHeaderSpaceSeparated(Boolean subsectionHeaderSpaceSeparated)`
`void`	`setTrailer(COSDictionary newTrailer)` // MIT added, maybe this should not be supported as trailer is a persistence construct.
`void`	`setVersion(float versionValue)` This will set the header version of this PDF document.
`void`	`setWarnMissingClose(boolean warn)` Controls whether this instance shall issue a warning if the PDF document wasn't closed properly through a call to the `close()` method.
`void`	`setXrefEOLMarkersComplyPDFA(Boolean xrefEOLMarkersComplyPDFA)`
`Boolean`	`subSectionHeaderSpaceSeparated()`

Methods inherited from class org.apache.pdfbox.cos.COSBase
getCOSObject, getKey, isDirect, setDirect, setKey

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - COSDocument
```
public COSDocument(boolean useScratchFiles)
```
    Constructor.
    
    Parameters:
    
    useScratchFiles - enables the usage of a scratch file if set to true
  - COSDocument
```
public COSDocument(File scratchDir,
                   boolean useScratchFiles)
```
    Constructor that will use a temporary file in the given directory for storage of the PDF streams. The temporary file is automatically removed when this document gets closed.
    
    Parameters:
    
    scratchDir - directory for the temporary file, or null to use the system default
    
    useScratchFiles - enables the usage of a scratch file if set to true
  - COSDocument
```
public COSDocument()
```
    Constructor. Uses memory to store stream.
- Method Detail
  - getPostEOFDataSize
```
public int getPostEOFDataSize()
```
  - setPostEOFDataSize
```
public void setPostEOFDataSize(int postEOFDataSize)
```
  - isLinearized
```
public boolean isLinearized()
```
  - setIsLinearized
```
public void setIsLinearized(boolean isLinearized)
```
  - isXrefEOLMarkersComplyPDFA
```
public Boolean isXrefEOLMarkersComplyPDFA()
```
  - setXrefEOLMarkersComplyPDFA
```
public void setXrefEOLMarkersComplyPDFA(Boolean xrefEOLMarkersComplyPDFA)
```
  - subSectionHeaderSpaceSeparated
```
public Boolean subSectionHeaderSpaceSeparated()
```
  - setSubsectionHeaderSpaceSeparated
```
public void setSubsectionHeaderSpaceSeparated(Boolean subsectionHeaderSpaceSeparated)
```
  - setHeaderOffset
```
public void setHeaderOffset(long headerOffset)
```
  - getHeaderOffset
```
public long getHeaderOffset()
```
  - getHeader
```
public String getHeader()
```
  - setHeader
```
public void setHeader(String header)
```
  - getHeaderCommentByte1
```
public int getHeaderCommentByte1()
```
  - setHeaderCommentByte1
```
public void setHeaderCommentByte1(int headerCommentByte1)
```
  - getHeaderCommentByte2
```
public int getHeaderCommentByte2()
```
  - setHeaderCommentByte2
```
public void setHeaderCommentByte2(int headerCommentByte2)
```
  - getHeaderCommentByte3
```
public int getHeaderCommentByte3()
```
  - setHeaderCommentByte3
```
public void setHeaderCommentByte3(int headerCommentByte3)
```
  - getHeaderCommentByte4
```
public int getHeaderCommentByte4()
```
  - setHeaderCommentByte4
```
public void setHeaderCommentByte4(int headerCommentByte4)
```
  - createCOSStream
```
public COSStream createCOSStream()
```
    Creates a new COSStream using the current configuration for scratch files.
    
    Returns:
    
    the new COSStream
  - createCOSStream
```
public COSStream createCOSStream(COSDictionary dictionary)
```
    Creates a new COSStream using the current configuration for scratch files.
    
    Parameters:
    
    dictionary - the corresponding dictionary
    
    Returns:
    
    the new COSStream
  - getObjectByType
```
public COSObject getObjectByType(COSName type)
                          throws IOException
```
    This will get the first dictionary object by type.
    
    Parameters:
    
    type - The type of the object.
    
    Returns:
    
    This will return an object with the specified type.
    
    Throws:
    
    IOException - If there is an error getting the object
  - getObjectsByType
```
public List<COSObject> getObjectsByType(String type)
                                 throws IOException
```
    This will get all dictionary objects by type.
    
    Parameters:
    
    type - The type of the object.
    
    Returns:
    
    This will return an object with the specified type.
    
    Throws:
    
    IOException - If there is an error getting the object
  - getObjectsByType
```
public List<COSObject> getObjectsByType(COSName type)
                                 throws IOException
```
    This will get a dictionary object by type.
    
    Parameters:
    
    type - The type of the object.
    
    Returns:
    
    This will return an object with the specified type.
    
    Throws:
    
    IOException - If there is an error getting the object
  - getKey
```
public COSObjectKey getKey(COSBase object)
```
    Returns the COSObjectKey for a given COS object, or null if there is none. This lookup iterates over all objects in a PDF, which may be slow for large files.
    
    Parameters:
    
    object - COS object
    
    Returns:
    
    key
  - print
```
public void print()
```
    This will print contents to stdout.
  - setVersion
```
public void setVersion(float versionValue)
```
    This will set the header version of this PDF document.
    
    Parameters:
    
    versionValue - The version of the PDF document.
  - getVersion
```
public float getVersion()
```
    This will get the version extracted from the header of this PDF document.
    
    Returns:
    
    The header version.
  - setDecrypted
```
public void setDecrypted()
```
    Signals that the document is decrypted completely.
  - isDecrypted
```
public boolean isDecrypted()
```
    Indicates if a encrypted pdf is already decrypted after parsing.
    
    Returns:
    
    true indicates that the pdf is decrypted.
  - isEncrypted
```
public boolean isEncrypted()
```
    This will tell if this is an encrypted document.
    
    Returns:
    
    true If this document is encrypted.
  - getEncryptionDictionary
```
public COSDictionary getEncryptionDictionary()
```
    This will get the encryption dictionary if the document is encrypted or null if the document is not encrypted.
    
    Returns:
    
    The encryption dictionary.
  - setEncryptionDictionary
```
public void setEncryptionDictionary(COSDictionary encDictionary)
```
    This will set the encryption dictionary, this should only be called when encrypting the document.
    
    Parameters:
    
    encDictionary - The encryption dictionary.
  - getDocumentID
```
public COSArray getDocumentID()
```
    This will get the document ID.
    
    Returns:
    
    The document id.
  - setDocumentID
```
public void setDocumentID(COSArray id)
```
    This will set the document ID.
    
    Parameters:
    
    id - The document id.
  - getCatalog
```
public COSObject getCatalog()
                     throws IOException
```
    This will get the document catalog. Maybe this should move to an object at PDFEdit level
    
    Returns:
    
    catalog is the root of all document activities
    
    Throws:
    
    IOException - If no catalog can be found.
  - getObjects
```
public List<COSObject> getObjects()
```
    This will get a list of all available objects.
    
    Returns:
    
    A list of all objects.
  - getTrailer
```
public COSDictionary getTrailer()
```
    This will get the document trailer.
    
    Returns:
    
    the document trailer dict
  - setTrailer
```
public void setTrailer(COSDictionary newTrailer)
```
    // MIT added, maybe this should not be supported as trailer is a persistence construct. This will set the document trailer.
    
    Parameters:
    
    newTrailer - the document trailer dictionary
  - getFirstPageTrailer
```
public COSDictionary getFirstPageTrailer()
```
    Returns the first page trailer.
    
    Returns:
    
    the document first trailer dict
  - setFirstPageTrailer
```
public void setFirstPageTrailer(COSDictionary firstPageTrailer)
```
  - getLastTrailer
```
public COSDictionary getLastTrailer()
```
    This will get the last document trailer.
    
    Returns:
    
    the document last trailer dict
  - setLastTrailer
```
public void setLastTrailer(COSDictionary lastTrailer)
```
    This will set the document trailer.
    
    Parameters:
    
    lastTrailer - the document trailer dictionary
  - accept
```
public Object accept(ICOSVisitor visitor)
              throws IOException
```
    visitor pattern double dispatch method.
    
    Specified by:
    
    accept in class COSBase
    
    Parameters:
    
    visitor - The object to notify when visiting this object.
    
    Returns:
    
    any object, depending on the visitor implementation, or null
    
    Throws:
    
    IOException - If an error occurs while visiting this object.
  - close
```
public void close()
           throws IOException
```
    This will close all storage and delete the tmp files.
    
    Specified by:
    
    close in interface Closeable
    
    Specified by:
    
    close in interface AutoCloseable
    
    Throws:
    
    IOException - If there is an error close resources.
  - isClosed
```
public boolean isClosed()
```
    Returns true if this document has been closed.
  - finalize
```
protected void finalize()
                 throws IOException
```
    Warn the user in the finalizer if he didn't close the PDF document. The method also closes the document just in case, to avoid abandoned temporary files. It's still a good idea for the user to close the PDF document at the earliest possible to conserve resources.
    
    Overrides:
    
    finalize in class Object
    
    Throws:
    
    IOException - if an error occurs while closing the temporary files
  - setWarnMissingClose
```
public void setWarnMissingClose(boolean warn)
```
    Controls whether this instance shall issue a warning if the PDF document wasn't closed properly through a call to the close() method. If the PDF document is held in a cache governed by soft references it is impossible to reliably close the document before the warning is raised. By default, the warning is enabled.
    
    Parameters:
    
    warn - true enables the warning, false disables it.
  - dereferenceObjectStreams
```
public void dereferenceObjectStreams()
                              throws IOException
```
    This method will search the list of objects for types of ObjStm. If it finds them then it will parse out all of the objects from the stream that is contains.
    
    Throws:
    
    IOException - If there is an error parsing the stream.
  - getObjectFromPool
```
public COSObject getObjectFromPool(COSObjectKey key)
                            throws IOException
```
    This will get an object from the pool.
    
    Parameters:
    
    key - The object key.
    
    Returns:
    
    The object in the pool or a new one if it has not been parsed yet.
    
    Throws:
    
    IOException - If there is an error getting the proxy object.
  - removeObject
```
public COSObject removeObject(COSObjectKey key)
```
    Removes an object from the object pool.
    
    Parameters:
    
    key - the object key
    
    Returns:
    
    the object that was removed or null if the object was not found
  - addXRefTable
```
public void addXRefTable(Map<COSObjectKey,Long> xrefTableValues)
```
    Populate XRef HashMap with given values. Each entry maps ObjectKeys to byte offsets in the file.
    
    Parameters:
    
    xrefTableValues - xref table entries to be added
  - getXrefTable
```
public Map<COSObjectKey,Long> getXrefTable()
```
    Returns the xrefTable which is a mapping of ObjectKeys to byte offsets in the file.
    
    Returns:
    
    mapping of ObjectsKeys to byte offsets
  - setStartXref
```
public void setStartXref(long startXrefValue)
```
    This method set the startxref value of the document. This will only be needed for incremental updates.
    
    Parameters:
    
    startXrefValue - the value for startXref
  - getStartXref
```
public long getStartXref()
```
    Return the startXref Position of the parsed document. This will only be needed for incremental updates.
    
    Returns:
    
    a long with the old position of the startxref
  - isXRefStream
```
public boolean isXRefStream()
```
    Determines if the trailer is a XRef stream or not.
    
    Returns:
    
    true if the trailer is a XRef stream
  - setIsXRefStream
```
public void setIsXRefStream(boolean isXRefStreamValue)
```
    Sets isXRefStream to the given value.
    
    Parameters:
    
    isXRefStreamValue - the new value for isXRefStream

Class COSDocument

Constructor Summary

Method Summary

Methods inherited from class org.apache.pdfbox.cos.COSBase

Methods inherited from class java.lang.Object

Constructor Detail

COSDocument

COSDocument

COSDocument

Method Detail

getPostEOFDataSize

setPostEOFDataSize

isLinearized

setIsLinearized

isXrefEOLMarkersComplyPDFA

setXrefEOLMarkersComplyPDFA

subSectionHeaderSpaceSeparated

setSubsectionHeaderSpaceSeparated

setHeaderOffset

getHeaderOffset

getHeader

setHeader

getHeaderCommentByte1

setHeaderCommentByte1

getHeaderCommentByte2

setHeaderCommentByte2

getHeaderCommentByte3

setHeaderCommentByte3

getHeaderCommentByte4

setHeaderCommentByte4

createCOSStream

createCOSStream

getObjectByType

getObjectsByType

getObjectsByType

getKey

print

setVersion

getVersion

setDecrypted

isDecrypted

isEncrypted

getEncryptionDictionary

setEncryptionDictionary

getDocumentID

setDocumentID

getCatalog

getObjects

getTrailer

setTrailer

getFirstPageTrailer

setFirstPageTrailer

getLastTrailer

setLastTrailer

accept

close

isClosed

finalize

setWarnMissingClose

dereferenceObjectStreams

getObjectFromPool

removeObject

addXRefTable

getXrefTable

setStartXref

getStartXref

isXRefStream

setIsXRefStream