FDFDictionary (pdfbox-1.8.12 API)

java.lang.Object
- org.apache.pdfbox.pdmodel.fdf.FDFDictionary

All Implemented Interfaces:

COSObjectable
```
public class FDFDictionary
extends java.lang.Object
implements COSObjectable
```
This represents an FDF dictionary that is part of the FDF document.

Version:

$Revision: 1.9 $

Author:

Ben Litchfield

Constructor Summary

Constructors
Constructor	Description
`FDFDictionary()`	Default constructor.
`FDFDictionary(COSDictionary fdfDictionary)`	Constructor.
`FDFDictionary(org.w3c.dom.Element fdfXML)`	This will create an FDF dictionary from an XFDF XML document.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`java.util.List`	`getAnnotations()`	This will get the list of FDF Annotations.
`COSDictionary`	`getCOSDictionary()`	Convert this standard java object to a COS object.
`COSBase`	`getCOSObject()`	Convert this standard java object to a COS object.
`COSStream`	`getDifferences()`	This will get the incremental updates since the PDF was last opened.
`java.util.List`	`getEmbeddedFDFs()`	This will get the list of embedded FDF entries, or null if the entry is null.
`java.lang.String`	`getEncoding()`	The encoding to be used for a FDF field.
`java.util.List`	`getFields()`	This will get the list of FDF Fields.
`PDFileSpecification`	`getFile()`	The source file or target file: the PDF document file that this FDF file was exported from or is intended to be imported into.
`COSArray`	`getID()`	This is the FDF id.
`FDFJavaScript`	`getJavaScript()`	This will get the java script entry.
`java.util.List`	`getPages()`	This will get the list of FDF Pages.
`java.lang.String`	`getStatus()`	This will get the status string to be displayed as the result of an action.
`java.lang.String`	`getTarget()`	This will get the target frame in the browser to open this document.
`void`	`setAnnotations(java.util.List annots)`	This will set the list of annotations.
`void`	`setDifferences(COSStream diff)`	This will set the differences stream.
`void`	`setEmbeddedFDFs(java.util.List embedded)`	This will set the list of embedded FDFs.
`void`	`setEncoding(java.lang.String encoding)`	This will set the encoding.
`void`	`setFields(java.util.List fields)`	This will set the list of fields.
`void`	`setFile(PDFileSpecification fs)`	This will set the file specification.
`void`	`setID(COSArray id)`	This will set the FDF id.
`void`	`setJavaScript(FDFJavaScript js)`	This will set the JavaScript entry.
`void`	`setPages(java.util.List pages)`	This will set the list of pages.
`void`	`setStatus(java.lang.String status)`	This will set the status string.
`void`	`setTarget(java.lang.String target)`	This will set the target frame in the browser to open this document.
`void`	`writeXML(java.io.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
  - FDFDictionary
```
public FDFDictionary()
```
    Default constructor.
  - FDFDictionary
```
public FDFDictionary(COSDictionary fdfDictionary)
```
    Constructor.
    
    Parameters:
    
    fdfDictionary - The FDF documents catalog.
  - FDFDictionary
```
public FDFDictionary(org.w3c.dom.Element fdfXML)
              throws java.io.IOException
```
    This will create an FDF dictionary from an XFDF XML document.
    
    Parameters:
    
    fdfXML - The XML document that contains the XFDF data.
    
    Throws:
    
    java.io.IOException - If there is an error reading from the dom.
- Method Detail
  - writeXML
```
public void writeXML(java.io.Writer output)
              throws java.io.IOException
```
    This will write this element as an XML document.
    
    Parameters:
    
    output - The stream to write the xml to.
    
    Throws:
    
    java.io.IOException - If there is an error writing the XML.
  - getCOSObject
```
public COSBase getCOSObject()
```
    Convert this standard java object to a COS object.
    
    Specified by:
    
    getCOSObject in interface COSObjectable
    
    Returns:
    
    The cos object that matches this Java object.
  - getCOSDictionary
```
public COSDictionary getCOSDictionary()
```
    Convert this standard java object to a COS object.
    
    Returns:
    
    The cos object that matches this Java object.
  - getFile
```
public PDFileSpecification getFile()
                            throws java.io.IOException
```
    The source file or target file: the PDF document file that this FDF file was exported from or is intended to be imported into.
    
    Returns:
    
    The F entry of the FDF dictionary.
    
    Throws:
    
    java.io.IOException - If there is an error creating the file spec.
  - setFile
```
public void setFile(PDFileSpecification fs)
```
    This will set the file specification.
    
    Parameters:
    
    fs - The file specification.
  - getID
```
public COSArray getID()
```
    This is the FDF id.
    
    Returns:
    
    The FDF ID.
  - setID
```
public void setID(COSArray id)
```
    This will set the FDF id.
    
    Parameters:
    
    id - The new id for the FDF.
  - getFields
```
public java.util.List getFields()
```
    This will get the list of FDF Fields. This will return a list of FDFField objects.
    
    Returns:
    
    A list of FDF fields.
  - setFields
```
public void setFields(java.util.List fields)
```
    This will set the list of fields. This should be a list of FDFField objects.
    
    Parameters:
    
    fields - The list of fields.
  - getStatus
```
public java.lang.String getStatus()
```
    This will get the status string to be displayed as the result of an action.
    
    Returns:
    
    The status.
  - setStatus
```
public void setStatus(java.lang.String status)
```
    This will set the status string.
    
    Parameters:
    
    status - The new status string.
  - getPages
```
public java.util.List getPages()
```
    This will get the list of FDF Pages. This will return a list of FDFPage objects.
    
    Returns:
    
    A list of FDF pages.
  - setPages
```
public void setPages(java.util.List pages)
```
    This will set the list of pages. This should be a list of FDFPage objects.
    
    Parameters:
    
    pages - The list of pages.
  - getEncoding
```
public java.lang.String getEncoding()
```
    The encoding to be used for a FDF field. The default is PDFDocEncoding and this method will never return null.
    
    Returns:
    
    The encoding value.
  - setEncoding
```
public void setEncoding(java.lang.String encoding)
```
    This will set the encoding.
    
    Parameters:
    
    encoding - The new encoding.
  - getAnnotations
```
public java.util.List getAnnotations()
                              throws java.io.IOException
```
    This will get the list of FDF Annotations. This will return a list of FDFAnnotation objects or null if the entry is not set.
    
    Returns:
    
    A list of FDF annotations.
    
    Throws:
    
    java.io.IOException - If there is an error creating the annotation list.
  - setAnnotations
```
public void setAnnotations(java.util.List annots)
```
    This will set the list of annotations. This should be a list of FDFAnnotation objects.
    
    Parameters:
    
    annots - The list of annotations.
  - getDifferences
```
public COSStream getDifferences()
```
    This will get the incremental updates since the PDF was last opened.
    
    Returns:
    
    The differences entry of the FDF dictionary.
  - setDifferences
```
public void setDifferences(COSStream diff)
```
    This will set the differences stream.
    
    Parameters:
    
    diff - The new differences stream.
  - getTarget
```
public java.lang.String getTarget()
```
    This will get the target frame in the browser to open this document.
    
    Returns:
    
    The target frame.
  - setTarget
```
public void setTarget(java.lang.String target)
```
    This will set the target frame in the browser to open this document.
    
    Parameters:
    
    target - The new target frame.
  - getEmbeddedFDFs
```
public java.util.List getEmbeddedFDFs()
                               throws java.io.IOException
```
    This will get the list of embedded FDF entries, or null if the entry is null. This will return a list of PDFileSpecification objects.
    
    Returns:
    
    A list of embedded FDF files.
    
    Throws:
    
    java.io.IOException - If there is an error creating the file spec.
  - setEmbeddedFDFs
```
public void setEmbeddedFDFs(java.util.List embedded)
```
    This will set the list of embedded FDFs. This should be a list of PDFileSpecification objects.
    
    Parameters:
    
    embedded - The list of embedded FDFs.
  - getJavaScript
```
public FDFJavaScript getJavaScript()
```
    This will get the java script entry.
    
    Returns:
    
    The java script entry describing javascript commands.
  - setJavaScript
```
public void setJavaScript(FDFJavaScript js)
```
    This will set the JavaScript entry.
    
    Parameters:
    
    js - The javascript entries.

Class FDFDictionary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

FDFDictionary

FDFDictionary

FDFDictionary

Method Detail

writeXML

getCOSObject

getCOSDictionary

getFile

setFile

getID

setID

getFields

setFields

getStatus

setStatus

getPages

setPages

getEncoding

setEncoding

getAnnotations

setAnnotations

getDifferences

setDifferences

getTarget

setTarget

getEmbeddedFDFs

setEmbeddedFDFs

getJavaScript

setJavaScript