XfaForm (iText 5.5.13.1 API)

java.lang.Object
- com.itextpdf.text.pdf.XfaForm

```
public class XfaForm
extends Object
```
Processes XFA forms.

Author:

Paulo Soares

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`XfaForm.AcroFieldsSearch` A class to process "classic" fields.
`static class`	`XfaForm.InverseStore` A structure to store each part of a SOM name and link it to the next part beginning from the lower hierarchy.
`static class`	`XfaForm.Stack2<T>` Another stack implementation.
`static class`	`XfaForm.Xml2Som` A class for some basic SOM processing.
`static class`	`XfaForm.Xml2SomDatasets` Processes the datasets section in the XFA form.
`static class`	`XfaForm.Xml2SomTemplate` Processes the template section in the XFA form.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`XFA_DATA_SCHEMA`

Constructor Summary

Constructors
Constructor and Description
`XfaForm()` An empty constructor to build on.
`XfaForm(PdfReader reader)` A constructor from a `PdfReader`.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static Map<String,Node>`	`extractXFANodes(Document domDocument)`
`void`	`fillXfaForm(File file)`
`void`	`fillXfaForm(File file, boolean readOnly)`
`void`	`fillXfaForm(InputSource is)`
`void`	`fillXfaForm(InputSource is, boolean readOnly)`
`void`	`fillXfaForm(InputStream is)`
`void`	`fillXfaForm(InputStream is, boolean readOnly)`
`void`	`fillXfaForm(Node node)`
`void`	`fillXfaForm(Node node, boolean readOnly)` Replaces the data under datasets/data.
`String`	`findDatasetsName(String name)` Finds the complete SOM name contained in the datasets section from a possibly partial name.
`Node`	`findDatasetsNode(String name)` Finds the `Node` contained in the datasets section from a possibly partial name.
`String`	`findFieldName(String name, AcroFields af)` Finds the complete field name contained in the "classic" forms from a partial name.
`XfaForm.AcroFieldsSearch`	`getAcroFieldsSom()` Gets the class that contains the "classic" fields processing.
`Node`	`getDatasetsNode()` Gets the `Node` that corresponds to the datasets part.
`XfaForm.Xml2SomDatasets`	`getDatasetsSom()` Gets the class that contains the datasets processing section of the XFA.
`Document`	`getDomDocument()` Gets the top level DOM document.
`static String`	`getNodeText(Node n)` Gets all the text contained in the child nodes of this node.
`PdfReader`	`getReader()` Gets the `PdfReader` used by this instance.
`XfaForm.Xml2SomTemplate`	`getTemplateSom()` Gets the class that contains the template processing section of the XFA.
`static PdfObject`	`getXfaObject(PdfReader reader)` Return the XFA Object, could be an array, could be a Stream.
`boolean`	`isChanged()` Checks if this XFA form was changed.
`boolean`	`isXfaPresent()` Returns `true` if it is a XFA form.
`static byte[]`	`serializeDoc(Node n)` Serializes a XML document to a byte array.
`void`	`setAcroFieldsSom(XfaForm.AcroFieldsSearch acroFieldsSom)` Sets the class that contains the "classic" fields processing.
`void`	`setChanged(boolean changed)` Sets the changed status of this XFA instance.
`void`	`setDatasetsSom(XfaForm.Xml2SomDatasets datasetsSom)` Sets the class that contains the datasets processing section of the XFA.
`void`	`setDomDocument(Document domDocument)` Sets the top DOM document.
`void`	`setNodeText(Node n, String text)` Sets the text of this node.
`void`	`setReader(PdfReader reader)` Sets the `PdfReader` to be used by this instance.
`void`	`setTemplateSom(XfaForm.Xml2SomTemplate templateSom)` Sets the class that contains the template processing section of the XFA
`void`	`setXfa(PdfWriter writer)` Sets the XFA key from the instance data.
`static void`	`setXfa(XfaForm form, PdfReader reader, PdfWriter writer)` Sets the XFA key from a byte array.
`void`	`setXfaPresent(boolean xfaPresent)` Sets the XFA form flag signaling that this is a valid XFA form.

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

- Field Detail
  - XFA_DATA_SCHEMA
```
public static final String XFA_DATA_SCHEMA
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - XfaForm
```
public XfaForm()
```
    An empty constructor to build on.
  - XfaForm
```
public XfaForm(PdfReader reader)
        throws IOException,
               ParserConfigurationException,
               SAXException
```
    A constructor from a PdfReader. It basically does everything from finding the XFA stream to the XML parsing.
    
    Parameters:
    
    reader - the reader
    
    Throws:
    
    IOException - on error
    
    ParserConfigurationException - on error
    
    SAXException - on error
- Method Detail
  - getXfaObject
```
public static PdfObject getXfaObject(PdfReader reader)
```
    Return the XFA Object, could be an array, could be a Stream. Returns null f no XFA Object is present.
    
    Parameters:
    
    reader - a PdfReader instance
    
    Returns:
    
    the XFA object
    
    Since:
    
    2.1.3
  - extractXFANodes
```
public static Map<String,Node> extractXFANodes(Document domDocument)
```
  - setXfa
```
public static void setXfa(XfaForm form,
                          PdfReader reader,
                          PdfWriter writer)
                   throws IOException
```
    Sets the XFA key from a byte array. The old XFA is erased.
    
    Parameters:
    
    form - the data
    
    reader - the reader
    
    writer - the writer
    
    Throws:
    
    IOException - on error
  - setXfa
```
public void setXfa(PdfWriter writer)
            throws IOException
```
    Sets the XFA key from the instance data. The old XFA is erased.
    
    Parameters:
    
    writer - the writer
    
    Throws:
    
    IOException - on error
  - serializeDoc
```
public static byte[] serializeDoc(Node n)
                           throws IOException
```
    Serializes a XML document to a byte array.
    
    Parameters:
    
    n - the XML document
    
    Returns:
    
    the serialized XML document
    
    Throws:
    
    IOException - on error
  - isXfaPresent
```
public boolean isXfaPresent()
```
    Returns true if it is a XFA form.
    
    Returns:
    
    true if it is a XFA form
  - getDomDocument
```
public Document getDomDocument()
```
    Gets the top level DOM document.
    
    Returns:
    
    the top level DOM document
  - findFieldName
```
public String findFieldName(String name,
                            AcroFields af)
```
    Finds the complete field name contained in the "classic" forms from a partial name.
    
    Parameters:
    
    name - the complete or partial name
    
    af - the fields
    
    Returns:
    
    the complete name or null if not found
  - findDatasetsName
```
public String findDatasetsName(String name)
```
    Finds the complete SOM name contained in the datasets section from a possibly partial name.
    
    Parameters:
    
    name - the complete or partial name
    
    Returns:
    
    the complete name or null if not found
  - findDatasetsNode
```
public Node findDatasetsNode(String name)
```
    Finds the Node contained in the datasets section from a possibly partial name.
    
    Parameters:
    
    name - the complete or partial name
    
    Returns:
    
    the Node or null if not found
  - getNodeText
```
public static String getNodeText(Node n)
```
    Gets all the text contained in the child nodes of this node.
    
    Parameters:
    
    n - the Node
    
    Returns:
    
    the text found or "" if no text was found
  - setNodeText
```
public void setNodeText(Node n,
                        String text)
```
    Sets the text of this node. All the child's node are deleted and a new child text node is created.
    
    Parameters:
    
    n - the Node to add the text to
    
    text - the text to add
  - setXfaPresent
```
public void setXfaPresent(boolean xfaPresent)
```
    Sets the XFA form flag signaling that this is a valid XFA form.
    
    Parameters:
    
    xfaPresent - the XFA form flag signaling that this is a valid XFA form
  - setDomDocument
```
public void setDomDocument(Document domDocument)
```
    Sets the top DOM document.
    
    Parameters:
    
    domDocument - the top DOM document
  - getReader
```
public PdfReader getReader()
```
    Gets the PdfReader used by this instance.
    
    Returns:
    
    the PdfReader used by this instance
  - setReader
```
public void setReader(PdfReader reader)
```
    Sets the PdfReader to be used by this instance.
    
    Parameters:
    
    reader - the PdfReader to be used by this instance
  - isChanged
```
public boolean isChanged()
```
    Checks if this XFA form was changed.
    
    Returns:
    
    true if this XFA form was changed
  - setChanged
```
public void setChanged(boolean changed)
```
    Sets the changed status of this XFA instance.
    
    Parameters:
    
    changed - the changed status of this XFA instance
  - getTemplateSom
```
public XfaForm.Xml2SomTemplate getTemplateSom()
```
    Gets the class that contains the template processing section of the XFA.
    
    Returns:
    
    the class that contains the template processing section of the XFA
  - setTemplateSom
```
public void setTemplateSom(XfaForm.Xml2SomTemplate templateSom)
```
    Sets the class that contains the template processing section of the XFA
    
    Parameters:
    
    templateSom - the class that contains the template processing section of the XFA
  - getDatasetsSom
```
public XfaForm.Xml2SomDatasets getDatasetsSom()
```
    Gets the class that contains the datasets processing section of the XFA.
    
    Returns:
    
    the class that contains the datasets processing section of the XFA
  - setDatasetsSom
```
public void setDatasetsSom(XfaForm.Xml2SomDatasets datasetsSom)
```
    Sets the class that contains the datasets processing section of the XFA.
    
    Parameters:
    
    datasetsSom - the class that contains the datasets processing section of the XFA
  - getAcroFieldsSom
```
public XfaForm.AcroFieldsSearch getAcroFieldsSom()
```
    Gets the class that contains the "classic" fields processing.
    
    Returns:
    
    the class that contains the "classic" fields processing
  - setAcroFieldsSom
```
public void setAcroFieldsSom(XfaForm.AcroFieldsSearch acroFieldsSom)
```
    Sets the class that contains the "classic" fields processing.
    
    Parameters:
    
    acroFieldsSom - the class that contains the "classic" fields processing
  - getDatasetsNode
```
public Node getDatasetsNode()
```
    Gets the Node that corresponds to the datasets part.
    
    Returns:
    
    the Node that corresponds to the datasets part
  - fillXfaForm
```
public void fillXfaForm(File file)
                 throws IOException
```
    Throws:
    
    IOException
  - fillXfaForm
```
public void fillXfaForm(File file,
                        boolean readOnly)
                 throws IOException
```
    Throws:
    
    IOException
  - fillXfaForm
```
public void fillXfaForm(InputStream is)
                 throws IOException
```
    Throws:
    
    IOException
  - fillXfaForm
```
public void fillXfaForm(InputStream is,
                        boolean readOnly)
                 throws IOException
```
    Throws:
    
    IOException
  - fillXfaForm
```
public void fillXfaForm(InputSource is)
                 throws IOException
```
    Throws:
    
    IOException
  - fillXfaForm
```
public void fillXfaForm(InputSource is,
                        boolean readOnly)
                 throws IOException
```
    Throws:
    
    IOException
  - fillXfaForm
```
public void fillXfaForm(Node node)
```
  - fillXfaForm
```
public void fillXfaForm(Node node,
                        boolean readOnly)
```
    Replaces the data under datasets/data.
    
    Since:
    
    iText 5.0.0

Class XfaForm

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

XFA_DATA_SCHEMA

Constructor Detail

XfaForm

XfaForm

Method Detail

getXfaObject

extractXFANodes

setXfa

setXfa

serializeDoc

isXfaPresent

getDomDocument

findFieldName

findDatasetsName

findDatasetsNode

getNodeText

setNodeText

setXfaPresent

setDomDocument

getReader

setReader

isChanged

setChanged

getTemplateSom

setTemplateSom

getDatasetsSom

setDatasetsSom

getAcroFieldsSom

setAcroFieldsSom

getDatasetsNode

fillXfaForm

fillXfaForm

fillXfaForm

fillXfaForm

fillXfaForm

fillXfaForm

fillXfaForm

fillXfaForm