ej.bluetooth

Class BluetoothUuid

java.lang.Object

ej.bluetooth.BluetoothUuid

public class BluetoothUuid
extends Object

The BluetoothUuid class represents the UUID of a service or attribute.

UUIDs may be created from byte arrays or strings representing 128-bit UUIDs or from integers representing 16-bit Bluetooth UUIDs.

A string representation of a UUID may be retrieved by calling the toString() method of the object. The equals(Object) method may be used in order to check if a UUID is equal to an other.

Constructor Summary

Constructors

Constructor and Description
BluetoothUuid(byte[] bytes, int offset) Creates a UUID from a byte array.
BluetoothUuid(int value) Creates a UUID from an integer.
BluetoothUuid(String string) Creates a UUID from a string.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj) Returns whether this UUID is equal to the given object.
short	get16BitValue() Returns the integer representing this 16-bit Bluetooth UUID.
void	getBytes(byte[] buffer, int offset) Writes this UUID to the given byte array.
int	hashCode() Returns the hash code value of this UUID.
boolean	is16Bit() Returns whether this UUID is a 16-bit Bluetooth UUID.
String	toString() Returns a string representation of this UUID (in big-endian).

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

BluetoothUuid

public BluetoothUuid(byte[] bytes,
                     int offset)

Creates a UUID from a byte array.

Parameters:

bytes - a byte array containing a 128-bit UUID (in big-endian).

offset - the offset of the UUID in the byte array.

Throws:

IllegalArgumentException - if the given byte array is not 16 bytes long.

BluetoothUuid

public BluetoothUuid(int value)

Creates a UUID from an integer.

Parameters:

value - an integer representing a 16-bit Bluetooth UUID.

BluetoothUuid

public BluetoothUuid(String string)

Creates a UUID from a string.

Parameters:

string - a string representing a 128-bit UUID (in big-endian).

Throws:

IllegalArgumentException - if the given string does not represent a 128-bit UUID.

Method Detail

equals

public boolean equals(@Nullable
                      Object obj)

Returns whether this UUID is equal to the given object.

Overrides:

equals in class Object

Parameters:

obj - the reference object with which to compare.

Returns:

true if this object is the same as the obj argument; false otherwise.

See Also:

Object.hashCode(), HashMap

get16BitValue

public short get16BitValue()

Returns the integer representing this 16-bit Bluetooth UUID.

Returns:

the integer representing this 16-bit Bluetooth UUID.

Throws:

IllegalStateException - if this UUID is not a 16-bit Bluetooth UUID.

getBytes

public void getBytes(byte[] buffer,
                     int offset)

Writes this UUID to the given byte array.

Parameters:

buffer - the buffer to write to (in big-endian).

offset - the index in the buffer to write at.

Throws:

ArrayIndexOutOfBoundsException - if the given buffer is not big enough to hold the UUID.

hashCode

public int hashCode()

Returns the hash code value of this UUID.

Overrides:

hashCode in class Object

Returns:

a hash code value for this object.

See Also:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

is16Bit

public boolean is16Bit()

Returns whether this UUID is a 16-bit Bluetooth UUID.

Returns:

true if this UUID is a 16-bit Bluetooth UUID, false otherwise.

toString

public String toString()

Returns a string representation of this UUID (in big-endian).

Overrides:

toString in class Object

Returns:

a string representation of the object.