Package com.lowagie.text.pdf

Class XfdfReader

java.lang.Object

com.lowagie.text.pdf.XfdfReader

All Implemented Interfaces:

FieldReader, SimpleXMLDocHandler

public class XfdfReader
extends Object
implements SimpleXMLDocHandler, FieldReader

Reads a XFDF.

Author:

Leonard Rosenthol (leonardr@pdfsages.com)

Constructor Summary

Constructors

Constructor	Description
XfdfReader(byte[] xfdfIn)	Reads an XFDF form.
XfdfReader(String filename)	Reads an XFDF form.

Method Summary

Modifier and Type	Method	Description
void	endDocument()	Called after the document is parsed.
void	endElement(String tag)	Called when an end tag is found.
Map<String,String>	getAllFields()
String	getField(String name)	Gets the field value.
HashMap<String,String>	getFields()	Deprecated. use getAllFields()
String	getFieldValue(String name)	Gets the field value or null if the field does not exist or has no value defined.
String	getFileSpec()	Gets the PDF file specification contained in the FDF.
List<String>	getListValues(String name)	Gets the field values for a list or null if the field does not exist or has no value defined.
void	startDocument()	Called when the document starts to be parsed.
void	startElement(String tag, HashMap h)	Deprecated.
void	startElement(String tag, Map<String,String> h)	Called when a start tag is found.
void	text(String str)	Called when a text element is found.

Methods inherited from class java.lang.Object

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

Constructor Detail

XfdfReader

public XfdfReader(String filename)
           throws IOException

Reads an XFDF form.

Parameters:

filename - the file name of the form

Throws:

IOException - on error

XfdfReader

public XfdfReader(byte[] xfdfIn)
           throws IOException

Reads an XFDF form.

Parameters:

xfdfIn - the byte array with the form

Throws:

IOException - on error

Method Detail

getFields

@Deprecated
public HashMap<String,String> getFields()

Deprecated.

use getAllFields()

Gets all the fields. The map is keyed by the fully qualified field name and the value is a merged PdfDictionary with the field content.

Specified by:

getFields in interface FieldReader

Returns:

all the fields

getAllFields

public Map<String,String> getAllFields()

Specified by:

getAllFields in interface FieldReader

getField

public String getField(String name)

Gets the field value.

Parameters:

name - the fully qualified field name

Returns:

the field's value

getFieldValue

public String getFieldValue(String name)

Gets the field value or null if the field does not exist or has no value defined.

Specified by:

getFieldValue in interface FieldReader

Parameters:

name - the fully qualified field name

Returns:

the field value or null

getListValues

public List<String> getListValues(String name)

Gets the field values for a list or null if the field does not exist or has no value defined.

Specified by:

getListValues in interface FieldReader

Parameters:

name - the fully qualified field name

Returns:

the field values or null

Since:

2.1.4

getFileSpec

public String getFileSpec()

Gets the PDF file specification contained in the FDF.

Returns:

the PDF file specification contained in the FDF

startElement

@Deprecated
public void startElement(String tag,
                         HashMap h)

Deprecated.

Called when a start tag is found.

Specified by:

startElement in interface SimpleXMLDocHandler

Parameters:

tag - the tag name

h - the tag's attributes

startElement

public void startElement(String tag,
                         Map<String,String> h)

Called when a start tag is found.

Specified by:

startElement in interface SimpleXMLDocHandler

Parameters:

tag - the tag name

h - the tag's attributes

endElement

public void endElement(String tag)

Called when an end tag is found.

Specified by:

endElement in interface SimpleXMLDocHandler

Parameters:

tag - the tag name

startDocument

public void startDocument()

Called when the document starts to be parsed.

Specified by:

startDocument in interface SimpleXMLDocHandler

endDocument

public void endDocument()

Called after the document is parsed.

Specified by:

endDocument in interface SimpleXMLDocHandler

text

public void text(String str)

Called when a text element is found.

Specified by:

text in interface SimpleXMLDocHandler

Parameters:

str - the text element, probably a fragment.