com.dd.plist

Class NSData

java.lang.Object

com.dd.plist.NSObject

com.dd.plist.NSData

public class NSData
extends NSObject

NSData objects are wrappers for byte buffers.

Author:

Daniel Dreibrodt

Constructor Summary

Constructors

Constructor and Description
NSData(byte[] bytes) Creates the NSData object from the binary representation of it.
NSData(File file) Creates a NSData object from a file.
NSData(String base64) Creates a NSData object from its textual representation, which is a Base64 encoded amount of bytes.

Method Summary

Modifier and Type	Method and Description
byte[]	bytes() The bytes contained in this NSData object.
boolean	equals(Object obj)
String	getBase64EncodedData() Gets the Base64 encoded data contained in this NSData object.
void	getBytes(ByteBuffer buf, int length) Loads the bytes from this NSData object into a byte buffer
void	getBytes(ByteBuffer buf, int rangeStart, int rangeStop) Loads the bytes from this NSData object into a byte buffer
int	hashCode()
int	length() Gets the amount of data stored in this object.
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.

Methods inherited from class com.dd.plist.NSObject

fromJavaObject, toJavaObject, toJavaObject, toXMLPropertyList

Methods inherited from class java.lang.Object

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

Constructor Detail

NSData

public NSData(byte[] bytes)

Creates the NSData object from the binary representation of it.

Parameters:

bytes - The raw data contained in the NSData object.

NSData

public NSData(String base64)
       throws IOException

Creates a NSData object from its textual representation, which is a Base64 encoded amount of bytes.

Parameters:

base64 - The Base64 encoded contents of the NSData object.

Throws:

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

NSData

public NSData(File file)
       throws IOException

Creates a NSData object from a file. Using the files contents as the contents of this NSData object.

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()

The bytes contained in this NSData object.

Returns:

The data as bytes

length

public int length()

Gets the amount of data stored in this object.

Returns:

The number of bytes contained in this object.

getBytes

public void getBytes(ByteBuffer buf,
                     int length)

Loads the bytes from this NSData object into a byte buffer

Parameters:

buf - The byte buffer which will contain the data

length - The amount of data to copy

getBytes

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

Loads the bytes from this NSData object into a byte buffer

Parameters:

buf - The byte buffer which will contain the data

rangeStart - The start index

rangeStop - The stop index

getBase64EncodedData

public String getBase64EncodedData()

Gets the Base64 encoded data contained in this NSData object.

Returns:

The Base64 encoded data as a String.

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

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

Specified by:

toASCII in class NSObject

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.

Specified by:

toASCIIGnuStep in class NSObject

Parameters:

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

level - The indentation level of the object.