org.apache.pdfbox.pdmodel.fdf

Class FDFDocument

java.lang.Object

org.apache.pdfbox.pdmodel.fdf.FDFDocument

All Implemented Interfaces:

Closeable, AutoCloseable

public class FDFDocument
extends Object
implements Closeable

This is the in-memory representation of the FDF document. You need to call close() on this object when you are done using it!!

Author:

Ben Litchfield

Constructor Summary

Constructors

Constructor and Description
FDFDocument() Constructor, creates a new FDF document.
FDFDocument(COSDocument doc) Deprecated. Use FDFDocument(COSDocument, RandomAccessRead)
FDFDocument(COSDocument doc, org.apache.pdfbox.io.RandomAccessRead source) Constructor that uses an existing document.
FDFDocument(Document doc) This will create an FDF document from an XFDF XML document.

Method Summary

Modifier and Type	Method and Description
void	close() This will close the underlying COSDocument object.
FDFCatalog	getCatalog() This will get the FDF Catalog.
COSDocument	getDocument() This will get the low level document.
void	save(File fileName) This will save this document to the filesystem.
void	save(OutputStream output) This will save the document to an output stream.
void	save(String fileName) This will save this document to the filesystem.
void	saveXFDF(File fileName) This will save this document to the filesystem.
void	saveXFDF(String fileName) This will save this document to the filesystem.
void	saveXFDF(Writer output) This will save the document to an output stream and close the stream.
void	setCatalog(FDFCatalog cat) This will set the FDF catalog for this FDF document.
void	writeXML(Writer output) This will write this element as an XML document.

Methods inherited from class java.lang.Object

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

Constructor Detail

FDFDocument

public FDFDocument()

Constructor, creates a new FDF document.

FDFDocument

@Deprecated
public FDFDocument(COSDocument doc)

Deprecated. Use FDFDocument(COSDocument, RandomAccessRead)

Constructor that uses an existing document. The COSDocument that is passed in must be valid.

Parameters:

doc - The COSDocument that this document wraps.

FDFDocument

public FDFDocument(COSDocument doc,
                   org.apache.pdfbox.io.RandomAccessRead source)

Constructor that uses an existing document. The COSDocument that is passed in must be valid.

Parameters:

doc - The COSDocument that this document wraps.

source - The source that will be closed when this document gets closed, can be null.

FDFDocument

public FDFDocument(Document doc)
            throws IOException

This will create an FDF document from an XFDF XML document.

Parameters:

doc - The XML document that contains the XFDF data.

Throws:

IOException - If there is an error reading from the dom.

Method Detail

writeXML

public void writeXML(Writer output)
              throws IOException

This will write this element as an XML document.

Parameters:

output - The stream to write the xml to.

Throws:

IOException - If there is an error writing the XML.

getDocument

public COSDocument getDocument()

This will get the low level document.

Returns:

The document that this layer sits on top of.

getCatalog

public FDFCatalog getCatalog()

This will get the FDF Catalog. This is guaranteed to not return null.

Returns:

The documents /Root dictionary

setCatalog

public final void setCatalog(FDFCatalog cat)

This will set the FDF catalog for this FDF document.

Parameters:

cat - The FDF catalog.

save

public void save(File fileName)
          throws IOException

This will save this document to the filesystem.

Parameters:

fileName - The file to save as.

Throws:

IOException - If there is an error saving the document.

save

public void save(String fileName)
          throws IOException

This will save this document to the filesystem.

Parameters:

fileName - The file to save as.

Throws:

IOException - If there is an error saving the document.

save

public void save(OutputStream output)
          throws IOException

This will save the document to an output stream.

Parameters:

output - The stream to write to.

Throws:

IOException - If there is an error writing the document.

saveXFDF

public void saveXFDF(File fileName)
              throws IOException

This will save this document to the filesystem.

Parameters:

fileName - The file to save as.

Throws:

IOException - If there is an error saving the document.

saveXFDF

public void saveXFDF(String fileName)
              throws IOException

This will save this document to the filesystem.

Parameters:

fileName - The file to save as.

Throws:

IOException - If there is an error saving the document.

saveXFDF

public void saveXFDF(Writer output)
              throws IOException

This will save the document to an output stream and close the stream.

Parameters:

output - The stream to write to.

Throws:

IOException - If there is an error writing the document.

close

public void close()
           throws IOException

This will close the underlying COSDocument object.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException - If there is an error releasing resources.