com.dd.plist

Class NSObject

java.lang.Object

com.dd.plist.NSObject

Direct Known Subclasses:

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

public abstract class NSObject
extends Object

Abstract interface for any 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

Methods

Modifier and Type	Method and Description
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.
String	toXMLPropertyList() Generates a valid XML property list including headers using this object as root.
static NSNumber	wrap(boolean value) Wraps the given value inside a NSObject.
static NSData	wrap(byte[] value) Wraps the given value inside a NSObject.
static NSNumber	wrap(double value) Wraps the given value inside a NSObject.
static NSNumber	wrap(long value) Wraps the given value inside a NSObject.
static NSDictionary	wrap(Map<String,Object> value) Creates a NSDictionary with the contents of the given map.
static NSObject	wrap(Object o) Creates a NSObject representing the given Java Object.
static NSArray	wrap(Object[] value) Creates a NSArray with the contents of the given array.
static NSSet	wrap(Set<Object> value) Creates a NSSet with the contents of this set.
static NSData	wrapSerialized(Object o) Serializes the given object using Java's default object serialization and wraps the serialized object in a NSData object.

Methods inherited from class java.lang.Object

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

Constructor Detail

NSObject

public NSObject()

Method Detail

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 https://developer.apple.com/library/mac/#documentation/Cocoa/Conceptual/PropertyLists/OldStylePlists/OldStylePLists.html

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.

wrap

public static NSNumber wrap(long value)

Wraps the given value inside a NSObject.

Parameters:

value - The value to represent as a NSObject.

Returns:

A NSObject representing the given value.

wrap

public static NSNumber wrap(double value)

Wraps the given value inside a NSObject.

Parameters:

value - The value to represent as a NSObject.

Returns:

A NSObject representing the given value.

wrap

public static NSNumber wrap(boolean value)

Wraps the given value inside a NSObject.

Parameters:

value - The value to represent as a NSObject.

Returns:

A NSObject representing the given value.

wrap

public static NSData wrap(byte[] value)

Wraps the given value inside a NSObject.

Parameters:

value - The value to represent as a NSObject.

Returns:

A NSObject representing the given value.

wrap

public static NSArray wrap(Object[] value)

Creates a NSArray with the contents of the given array.

Parameters:

value - The value to represent as a NSObject.

Returns:

A NSObject representing the given value.

Throws:

RuntimeException - When one of the objects contained in the array cannot be represented by a NSObject.

wrap

public static NSDictionary wrap(Map<String,Object> value)

Creates a NSDictionary with the contents of the given map.

Parameters:

value - The value to represent as a NSObject.

Returns:

A NSObject representing the given value.

Throws:

RuntimeException - When one of the values contained in the map cannot be represented by a NSObject.

wrap

public static NSSet wrap(Set<Object> value)

Creates a NSSet with the contents of this set.

Parameters:

value - The value to represent as a NSObject.

Returns:

A NSObject representing the given value.

Throws:

RuntimeException - When one of the values contained in the set cannot be represented by a NSObject.

wrap

public static NSObject wrap(Object o)

Creates a NSObject representing the given Java Object. Numerics of type bool, int, long, short, byte, float or double are wrapped as NSNumber objects. Strings are wrapped as NSString objects abd byte arrays as NSData objects. Date objects are wrapped as NSDate objects. Serializable classes are serialized and their data is stored in NSData objects. Arrays and Collection objects are converted to NSArrays where each array member is wrapped into a NSObject. Map objects are converted to NSDictionaries. Each key is converted to a string and each value wrapped into a NSObject.

Parameters:

o - The object to represent.

Returns:

A NSObject equivalent to the given object.

wrapSerialized

public static NSData wrapSerialized(Object o)

Serializes the given object using Java's default object serialization and wraps the serialized object in a NSData object.

Parameters:

o - The object to serialize and wrap.

Returns:

A NSData object

Throws:

RuntimeException - When the object could not be serialized.

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 java.util.Map class.
• NSSet objects are converted to objects extending the java.util.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 java.util.Date objects.
• UID objects are converted to byte arrays.

Returns:

A native java object representing this NSObject's value.