com.dd.plist

Class BinaryPropertyListParser

java.lang.Object

com.dd.plist.BinaryPropertyListParser

public class BinaryPropertyListParser
extends Object

Parses property lists that are in Apple's binary format. Use this class when you are sure about the format of the property list. Otherwise use the PropertyListParser class.

Parsing is done by calling the static parse methods.

Author:

Daniel Dreibrodt

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BinaryPropertyListParser() Protected constructor so that instantiation is fully controlled by the static parse methods.

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	copyOfRange(byte[] src, int startIndex, int endIndex) Copies a part of a byte array into a new array.
static NSObject	parse(byte[] data) Parses a binary property list from a byte array.
static NSObject	parse(File f) Parses a binary property list file.
static NSObject	parse(InputStream is) Parses a binary property list from an input stream.
static double	parseDouble(byte[] bytes) Parses doubles from a (big-endian) byte array.
static long	parseLong(byte[] bytes) Parses longs from a (big-endian) byte array.
static long	parseUnsignedInt(byte[] bytes) Parses an unsigned integers from a byte array.

Methods inherited from class java.lang.Object

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

Constructor Detail

BinaryPropertyListParser

protected BinaryPropertyListParser()

Protected constructor so that instantiation is fully controlled by the static parse methods.

See Also:

parse(byte[])

Method Detail

parse

public static NSObject parse(byte[] data)
                      throws IOException,
                             PropertyListFormatException

Parses a binary property list from a byte array.

Parameters:

data - The binary property list's data.

Returns:

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

Throws:

Exception - When an error occurs during parsing.

IOException

PropertyListFormatException

parse

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

Parses a binary property list from an input stream.

Parameters:

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

Returns:

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

Throws:

Exception - When an error occurs during parsing.

IOException

PropertyListFormatException

parse

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

Parses a binary property list file.

Parameters:

f - The binary property list file

Returns:

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

Throws:

Exception - When an error occurs during parsing.

IOException

PropertyListFormatException

parseUnsignedInt

public static final long parseUnsignedInt(byte[] bytes)

Parses an unsigned integers from a byte array.

Parameters:

bytes - The byte array containing the unsigned integer.

Returns:

The unsigned integer represented by the given bytes.

parseLong

public static final long parseLong(byte[] bytes)

Parses longs from a (big-endian) byte array.

Parameters:

bytes - The bytes representing the long integer.

Returns:

The long integer represented by the given bytes.

parseDouble

public static final double parseDouble(byte[] bytes)

Parses doubles from a (big-endian) byte array.

Parameters:

bytes - The bytes representing the double.

Returns:

The double represented by the given bytes.

copyOfRange

public static byte[] copyOfRange(byte[] src,
                 int startIndex,
                 int endIndex)

Copies a part of a byte array into a new array.

Parameters:

src - The source array.

startIndex - The index from which to start copying.

endIndex - The index until which to copy.

Returns:

The copied array.