com.dd.plist

Class UID

java.lang.Object

com.dd.plist.NSObject

com.dd.plist.UID

All Implemented Interfaces:

Cloneable, Comparable<NSObject>

public class UID
extends NSObject

The UID class holds a unique identifier. Only found in binary property lists that are keyed archives.

Author:

Daniel Dreibrodt

Constructor Summary

Constructors

Constructor and Description
UID(String name, BigInteger value) Creates a new UID instance.
UID(String name, byte[] bytes) Creates a new UID instance.

Method Summary

Modifier and Type	Method and Description
UID	clone() Creates and returns a deep copy of this instance.
int	compareTo(NSObject o)
boolean	equals(Object o)
byte[]	getBytes() Gets this instance's value.
String	getName() Gets this instance's name.
int	hashCode()
protected void	toASCII(StringBuilder ascii, int level) Generates the ASCII representation of this object.
protected void	toASCIIGnuStep(StringBuilder ascii, int level) Generates the ASCII representation of this object in the GnuStep format.
Object	toJavaObject() Converts this NSObject into an equivalent object of the Java Runtime Environment.
String	toString()

Methods inherited from class com.dd.plist.NSObject

fromJavaObject, getLocationInformation, indent, toJavaObject, toXMLPropertyList

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

UID

public UID(String name,
           BigInteger value)

Creates a new UID instance.

Parameters:

name - The UID name.

value - The UID value.

Throws:

NullPointerException - If value is null.

IllegalArgumentException - If value is negative or has a length of more than 128-bit.

UID

public UID(String name,
           byte[] bytes)

Creates a new UID instance.

Parameters:

name - The UID name.

bytes - The UID value.

Throws:

NullPointerException - If bytes is null.

IllegalArgumentException - If bytes represents a UID with a length of more than 128-bit (leading zero bytes are ignored).

Method Detail

getBytes

public byte[] getBytes()

Gets this instance's value.

Returns:

The UID's value in big-endian representation, encoded on 1, 2, 4, 8 or 16 bytes.

getName

public String getName()

Gets this instance's name.

Returns:

The UID's name.

clone

public UID clone()

Description copied from class: NSObject

Creates and returns a deep copy of this instance.

Specified by:

clone in class NSObject

Returns:

A clone of this instance.

toJavaObject

public Object toJavaObject()

Description copied from class: NSObject

Converts this NSObject into an equivalent object of the Java Runtime Environment.

• NSArray objects are converted to arrays.
• NSDictionary objects are converted to objects extending the Map class.
• NSSet objects are converted to objects extending the Set class.
• NSNumber objects are converted to primitive number values (int, long, double or boolean).
• NSString objects are converted to String objects.
• NSData objects are converted to byte arrays.
• NSDate objects are converted to Date objects.
• UID objects are converted to byte arrays.

Specified by:

toJavaObject in class NSObject

Returns:

A native java object representing this NSObject's value.

toASCII

protected void toASCII(StringBuilder ascii,
                       int level)

Description copied from class: NSObject

Generates the ASCII representation of this object. The generated ASCII representation does not end with a newline. Complies with the Old-Style ASCII Property Lists definition.

Parameters:

ascii - The StringBuilder onto which the ASCII representation is appended.

level - The indentation level of the object.

toASCIIGnuStep

protected void toASCIIGnuStep(StringBuilder ascii,
                              int level)

Description copied from class: NSObject

Generates the ASCII representation of this object in the GnuStep format. The generated ASCII representation does not end with a newline.

Parameters:

ascii - The StringBuilder onto which the ASCII representation is appended.

level - The indentation level of the object.

compareTo

public int compareTo(NSObject o)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object