net.sf.plist

Class NSData

java.lang.Object

net.sf.plist.NSObject

net.sf.plist.NSData

public final class NSData
extends NSObject

Represents a binary blob.

In this implementation, a primitive byte array or a ByteArrayInputStream is used to represent the NSData.

See Also:

ByteArrayInputStream

Constructor Summary

Constructors

Constructor and Description
NSData(byte[] theData) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
java.io.ByteArrayInputStream	getValue() Get the unmodifiable value of this object.
boolean	isTrue() Return whether or not the value evaluates to true.
byte[]	toBytes() Return the contents of this object as primitive array.
double	toDouble() Return the value as a double.
long	toLong() Get the length of the content in bytes.
byte[]	toObject() Converts this NSObject to a normal Java object.
java.io.ByteArrayInputStream	toStream() Get a ByteArrayInputStream which can be used to read the contents of this object.
java.lang.String	toString() Returns an formatted hexadecimal representation of the content.

Methods inherited from class net.sf.plist.NSObject

equals, fromObject, hashCode, toBoolean, toDate, toInteger, toList, toListObject, toMap, toMapObject, toNumber

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

NSData

public NSData(byte[] theData)

Constructor.

Parameters:

theData - value of the new object

Method Detail

getValue

public java.io.ByteArrayInputStream getValue()

Get the unmodifiable value of this object.

Specified by:

getValue in class NSObject

Returns:

the unmodifiable value of this object

See Also:

toStream()

toStream

public java.io.ByteArrayInputStream toStream()

Get a ByteArrayInputStream which can be used to read the contents of this object. This is the most cost-efficient way to retrieve the value contained in an NSData object.

Overrides:

toStream in class NSObject

Returns:

the ByteArrayInputStream

toBytes

public byte[] toBytes()

Return the contents of this object as primitive array.
Because the array is copied to keep this object immutable, it's recommended to use toStream() instead.

Specified by:

toBytes in class NSObject

Returns:

the array

toObject

public byte[] toObject()

Converts this NSObject to a normal Java object. The result of this method can be used as an argument in NSObject.fromObject(Object) which will convert the object back to an NSObject. Note: This method will NOT convert NSUID objects, because there is no Java equivalent for those.

Overrides:

toObject in class NSObject

Returns:

a standard Java object

isTrue

public boolean isTrue()

Return whether or not the value evaluates to true.

A value returns to true if and only if

• it is the NSBoolean type NSBoolean.TRUE
• It is an NSString which has a length greater than zero and does not equal "NO" or "False" (case insensitive)
• It is an NSNumber greater than 0
• It is an NSCollection which contains more than zero elements
• It is an NSDate
• It is an NSData with a length greater than 0

Specified by:

isTrue in class NSObject

Returns:

the value evaluates to true

toString

public java.lang.String toString()

Returns an formatted hexadecimal representation of the content. The formatting is equal to the one used by XCode.

Overrides:

toString in class NSObject

Returns:

the hexadecimal string

See Also:

Object.toString()

toLong

public long toLong()

Get the length of the content in bytes.

Specified by:

toLong in class NSObject

Returns:

the length

toDouble

public double toDouble()

Return the value as a double. If this is not a NSReal the double value is derived from the actual value.

Specified by:

toDouble in class NSObject

Returns:

the double