com.dd.plist

Class NSObject

java.lang.Object

com.dd.plist.NSObject

All Implemented Interfaces:

Cloneable

Direct Known Subclasses:

NSArray, NSData, NSDate, NSDictionary, NSNumber, NSSet, NSString, UID

public abstract class NSObject
extends Object
implements Cloneable

Abstract interface for an object contained in a property list. The names and functions of the various objects orient themselves towards Apple's Cocoa API.

Author:

Daniel Dreibrodt

Constructor Summary

Constructors

Constructor and Description
NSObject()

Method Summary

Modifier and Type	Method and Description
abstract NSObject	clone() Creates and returns a deep copy of this instance.
static NSObject	fromJavaObject(Object object) Serializes the specified object into an NSObject.
protected abstract void	toASCII(StringBuilder ascii, int level) Generates the ASCII representation of this object.
protected abstract 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.
<T> T	toJavaObject(Class<T> clazz) Converts this NSObject into an object of the specified class.
String	toXMLPropertyList() Generates a valid XML property list including headers using this object as root.

Methods inherited from class java.lang.Object

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

Constructor Detail

NSObject

public NSObject()

Method Detail

clone

public abstract NSObject clone()

Creates and returns a deep copy of this instance.

Overrides:

clone in class Object

Returns:

A clone of this instance.

toXMLPropertyList

public String toXMLPropertyList()

Generates a valid XML property list including headers using this object as root.

Returns:

The XML representation of the property list including XML header and doctype information.

toASCII

protected abstract void toASCII(StringBuilder ascii,
                                int level)

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 abstract void toASCIIGnuStep(StringBuilder ascii,
                                       int level)

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.

toJavaObject

public Object toJavaObject()

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.

Returns:

A native java object representing this NSObject's value.

toJavaObject

public <T> T toJavaObject(Class<T> clazz)

Converts this NSObject into an object of the specified class.

Type Parameters:

T - The target object type.

Parameters:

clazz - The target class.

Returns:

A new instance of the specified class, deserialized from this NSObject.

Throws:

IllegalArgumentException - If the specified class cannot be deserialized from this NSObject.

fromJavaObject

public static NSObject fromJavaObject(Object object)

Serializes the specified object into an NSObject. Objects which do not have a direct type correspondence to an NSObject type will be serialized as a NSDictionary. The dictionary will contain the values of all publicly accessible fields and properties.

Parameters:

object - The object to serialize.

Returns:

A NSObject instance.

Throws:

IllegalArgumentException - If the specified object throws an exception while getting its properties.