ej.bluetooth

Class BluetoothAddress

java.lang.Object

ej.bluetooth.BluetoothAddress

public class BluetoothAddress
extends Object

The BluetoothAddress class represents the address of a Bluetooth device.

Addresses may be created by using the class constructor or retrieved by listening to connection events while scanning.

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

Constructor Summary

Constructors

Constructor and Description
BluetoothAddress(byte[] bytes, int offset, boolean isPublic) Creates an address from the given byte array.
BluetoothAddress(String string, boolean isPublic) Creates an address from the given string.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj) Returns whether this address is equal to the given object.
void	getBytes(byte[] buffer, int offset) Writes this address to the given byte array.
int	hashCode() Returns the hash code value of this address.
boolean	isPublic() Returns whether this address is a public address.
String	toString() Returns a string representation of this address (in big-endian).

Methods inherited from class java.lang.Object

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

Constructor Detail

BluetoothAddress

public BluetoothAddress(byte[] bytes,
                        int offset,
                        boolean isPublic)

Creates an address from the given byte array.

Parameters:

bytes - a byte array containing a Bluetooth address (in big-endian).

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

isPublic - true to create a public address, false to create a private address.

Throws:

ArrayIndexOutOfBoundsException - if the given byte array is not 6 bytes long.

BluetoothAddress

public BluetoothAddress(String string,
                        boolean isPublic)

Creates an address from the given string.

Parameters:

string - a string representing a Bluetooth address (in big-endian).

isPublic - true to create a public address, false to create a private address.

Throws:

IllegalArgumentException - if the given string does not represent a Bluetooth address.

Method Detail

equals

public boolean equals(@Nullable
                      Object obj)

Returns whether this address 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

getBytes

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

Writes this address 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 address.

hashCode

public int hashCode()

Returns the hash code value of this address.

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)

isPublic

public boolean isPublic()

Returns whether this address is a public address.

Returns:

true if this address is a public address, false if it is private.

toString

public String toString()

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

Overrides:

toString in class Object

Returns:

a string representation of the object.