com.dd.plist

Class XMLPropertyListParser

java.lang.Object

com.dd.plist.XMLPropertyListParser

public class XMLPropertyListParser
extends Object

Parses XML property lists.

Author:

Daniel Dreibrodt

Constructor Summary

Constructors

Constructor and Description
XMLPropertyListParser()

Method Summary

Modifier and Type	Method and Description
static DocumentBuilder	getDocBuilder() Gets a DocumentBuilder to parse a XML property list.
static NSObject	parse(byte[] bytes) Parses a XML property list from a byte array.
static NSObject	parse(Document doc) Parses a property list from an XML document.
static NSObject	parse(File f) Parses a XML property list file.
static NSObject	parse(InputStream is) Parses a XML property list from an input stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLPropertyListParser

public XMLPropertyListParser()

Method Detail

getDocBuilder

public static DocumentBuilder getDocBuilder()
                                     throws ParserConfigurationException

Gets a DocumentBuilder to parse a XML property list. As DocumentBuilders are not thread-safe a new DocBuilder is generated for each request.

Returns:

A new DocBuilder that can parse property lists w/o an internet connection.

Throws:

ParserConfigurationException - If a document builder for parsing a XML property list could not be created. This should not occur.

parse

public static NSObject parse(File f)
                      throws ParserConfigurationException,
                             IOException,
                             SAXException,
                             PropertyListFormatException,
                             ParseException

Parses a XML property list file.

Parameters:

f - The XML property list file.

Returns:

The root object of the property list. This is usually a NSDictionary but can also be a NSArray.

Throws:

ParserConfigurationException - If a document builder for parsing a XML property list could not be created. This should not occur.

IOException - If any IO error occurs while reading the file.

SAXException - If any parse error occurs.

PropertyListFormatException - If the given property list has an invalid format.

ParseException - If a date string could not be parsed.

See Also:

DocumentBuilder.parse(java.io.File)

parse

public static NSObject parse(byte[] bytes)
                      throws ParserConfigurationException,
                             ParseException,
                             SAXException,
                             PropertyListFormatException,
                             IOException

Parses a XML property list from a byte array.

Parameters:

bytes - The byte array containing the property list's data.

Returns:

The root object of the property list. This is usually a NSDictionary but can also be a NSArray.

Throws:

ParserConfigurationException - If a document builder for parsing a XML property list could not be created. This should not occur.

IOException - If any IO error occurs while reading the file.

SAXException - If any parse error occurs.

PropertyListFormatException - If the given property list has an invalid format.

ParseException - If a date string could not be parsed.

parse

public static NSObject parse(InputStream is)
                      throws ParserConfigurationException,
                             IOException,
                             SAXException,
                             PropertyListFormatException,
                             ParseException

Parses a XML property list from an input stream.

Parameters:

is - The input stream pointing to the property list's data.

Returns:

The root object of the property list. This is usually a NSDictionary but can also be a NSArray.

Throws:

ParserConfigurationException - If a document builder for parsing a XML property list could not be created. This should not occur.

IOException - If any IO error occurs while reading the file.

SAXException - If any parse error occurs.

PropertyListFormatException - If the given property list has an invalid format.

ParseException - If a date string could not be parsed.

See Also:

DocumentBuilder.parse(java.io.InputStream)

parse

public static NSObject parse(Document doc)
                      throws PropertyListFormatException,
                             IOException,
                             ParseException

Parses a property list from an XML document.

Parameters:

doc - The XML document.

Returns:

The root NSObject of the property list contained in the XML document.

Throws:

IOException - If any IO error occurs while reading the file.

PropertyListFormatException - If the given property list has an invalid format.

ParseException - If a date string could not be parsed.