com.dd.plist

Class NSData

java.lang.Object

com.dd.plist.NSObject

com.dd.plist.NSData

All Implemented Interfaces:

Cloneable, Comparable<NSObject>

public class NSData
extends NSObject

The NSData class is a wrapper for a byte buffer.

Author:

Daniel Dreibrodt

See Also:

Foundation NSData documentation

Constructor Summary

Constructors

Constructor and Description
NSData(byte[] bytes) Creates a new NSData instance with the specified content.
NSData(File file) Creates a new NSData instance with the specified file as content.
NSData(String base64) Creates a new NSData instance with the specified Base64 encoded content.

Method Summary

Modifier and Type	Method and Description
byte[]	bytes() Returns the bytes contained in this instance.
NSData	clone() Creates and returns a deep copy of this instance.
int	compareTo(NSObject o)
boolean	equals(Object obj)
String	getBase64EncodedData() Gets the Base64 encoded data contained in this instance.
void	getBytes(ByteBuffer buf, int length) Copies data from this instance into the specified buffer.
void	getBytes(ByteBuffer buf, int rangeStart, int rangeStop) Copies data from this instance into the specified buffer.
int	hashCode()
int	length() Returns the number of bytes stored in this instance.
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.

Methods inherited from class com.dd.plist.NSObject

fromJavaObject, getLocationInformation, indent, toJavaObject, toXMLPropertyList

Methods inherited from class java.lang.Object

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

Constructor Detail

NSData

public NSData(byte[] bytes)

Creates a new NSData instance with the specified content.

Parameters:

bytes - The data content.

NSData

public NSData(String base64)
       throws IOException

Creates a new NSData instance with the specified Base64 encoded content.

Parameters:

base64 - The Base64 encoded data content.

Throws:

IOException - When the given string is not a proper Base64 formatted string.

NSData

public NSData(File file)
       throws IOException

Creates a new NSData instance with the specified file as content.

Parameters:

file - The file containing the data.

Throws:

FileNotFoundException - If the file could not be found.

IOException - If the file could not be read.

Method Detail

bytes

public byte[] bytes()

Returns the bytes contained in this instance.

Returns:

The data as bytes

length

public int length()

Returns the number of bytes stored in this instance.

Returns:

The number of bytes contained in this object.

getBytes

public void getBytes(ByteBuffer buf,
                     int length)

Copies data from this instance into the specified buffer.

Parameters:

buf - The byte buffer which will contain the data.

length - The number of bytes to copy.

getBytes

public void getBytes(ByteBuffer buf,
                     int rangeStart,
                     int rangeStop)

Copies data from this instance into the specified buffer.

Parameters:

buf - The byte buffer which will contain the data.

rangeStart - The index from which to start copying.

rangeStop - The index at which to stop copying.

getBase64EncodedData

public String getBase64EncodedData()

Gets the Base64 encoded data contained in this instance.

Returns:

The data as a Base64 encoded String.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

clone

public NSData 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.

compareTo

public int compareTo(NSObject o)

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.