ch.aplu.bluetooth

Class BluetoothClient

java.lang.Object

ch.aplu.bluetooth.BluetoothClient

public class BluetoothClient
extends java.lang.Object

Class to create a client that connects to a server via Bluetooth. Keep in mind that a server must be up and running before any client can connect.

Constructor Summary

Constructors

Constructor and Description
BluetoothClient(long serverAddress) Creates a BluetoothClient instance with given Bluetooth address that will connect to channel 1.
BluetoothClient(long serverAddress, int channel) Creates a BluetoothClient instance with given Bluetooth address that will connect using the given given channel.
BluetoothClient(javax.bluetooth.RemoteDevice remoteDevice, java.lang.String serviceName) Creates a BluetoothClient instance for the given remote device that will connect using the given service name.
BluetoothClient(java.lang.String serverName) Creates a BluetoothClient instance for the given server's Bluetooth name that will connect to Bluetooth channel 1.
BluetoothClient(java.lang.String serverName, int channel) Creates a BluetoothClient instance for the given server's Bluetooth name that will connect using the given given channel.
BluetoothClient(java.lang.String serverName, java.lang.String serviceName) Creates a BluetoothClient instance for the given server's Bluetooth name that will connect using the given service name.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	connect() Attemps to connect the client to the host.
boolean	connect(int timeout) Attemps to connect the client to the host with given timeout.
void	disconnect() Closes the opened input and output stream and releases the Bluetooth connection.
java.lang.String	getBtAddress() Returns the Bluetooth address (hex).
long	getBtAddressLong() Returns the Bluetooth address (long).
int	getDetectedServerChannel() Returns the channel number returned by the server after a service search.
java.io.InputStream	getInputStream() Returns the InputStream reference of the Bluetooth connection.
java.io.OutputStream	getOutputStream() Returns the OutputStream reference of the Bluetooth connection.
java.lang.String	getServerName() Returns the server's Bluetooth friendly name.
javax.microedition.io.StreamConnection	getStreamConnection() Returns the StreamConnection reference of the Bluetooth connection.
boolean	isConnected() Returns the connection state.
void	setVerbose(boolean isVerbose) Set the verbose mode on/off.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BluetoothClient

public BluetoothClient(java.lang.String serverName)

Creates a BluetoothClient instance for the given server's Bluetooth name that will connect to Bluetooth channel 1.

No connection is established before connect() is called.

BluetoothClient

public BluetoothClient(java.lang.String serverName,
               int channel)

Creates a BluetoothClient instance for the given server's Bluetooth name that will connect using the given given channel. The Bluetooth channel is dynamically attributed when the server starts. If you do not know the channel number, either use the server service name or spy the reachable Bluetooth servers with a Bluetooth sniffer, like RFCommBrowser from www.aplu.ch/download/RFCommBrowser.zip

No connection is established before connect() is called.

BluetoothClient

public BluetoothClient(java.lang.String serverName,
               java.lang.String serviceName)

Creates a BluetoothClient instance for the given server's Bluetooth name that will connect using the given service name. connect() may take some time, because the channel number has to be retrieved from the server by a Bluetooth service search.

No connection is established before connect() is called.

BluetoothClient

public BluetoothClient(long serverAddress)

Creates a BluetoothClient instance with given Bluetooth address that will connect to channel 1.

No connection is established before connect() is called.

BluetoothClient

public BluetoothClient(long serverAddress,
               int channel)

Creates a BluetoothClient instance with given Bluetooth address that will connect using the given given channel. The Bluetooth channel is dynamically attributed when the server starts. If you do not know the channel number, either use the server service name or spy the reachable Bluetooth servers with a Bluetooth sniffer, like RFCommBrowser from www.aplu.ch/download/RFCommBrowser.zip

No connection is established before connect() is called.

BluetoothClient

public BluetoothClient(javax.bluetooth.RemoteDevice remoteDevice,
               java.lang.String serviceName)

Creates a BluetoothClient instance for the given remote device that will connect using the given service name. connect() may take some time, because the channel number has to be retrieved from the server by a Bluetooth service search.

No connection is established a this time.

Method Detail

connect

public boolean connect(int timeout)

Attemps to connect the client to the host with given timeout.

Parameters:

timeout - in seconds

Returns:

true, if successful; false, if connection cannot be established within the given timemout or already connected

connect

public boolean connect()

Attemps to connect the client to the host.

Returns:

true, if successful; false, if connection cannot be established or already connected

disconnect

public void disconnect()

Closes the opened input and output stream and releases the Bluetooth connection. Any blocking read method of a connected server will return with an end of stream value that informs the server that the client connection is lost. Closing the input stream will cause an IOException throwed by any blocking read method.

getStreamConnection

public javax.microedition.io.StreamConnection getStreamConnection()

Returns the StreamConnection reference of the Bluetooth connection.

Returns:

StreamConnection or null, if not connected

getInputStream

public java.io.InputStream getInputStream()

Returns the InputStream reference of the Bluetooth connection.

Returns:

InputStream or null, if not connected

getOutputStream

public java.io.OutputStream getOutputStream()

Returns the OutputStream reference of the Bluetooth connection.

Returns:

OutputStream or null, if not connected

isConnected

public boolean isConnected()

Returns the connection state.

Returns:

true, if connected, otherwise false

getBtAddress

public java.lang.String getBtAddress()

Returns the Bluetooth address (hex).

Returns:

Bluetooth address as string in hex format or null, if not connected

getServerName

public java.lang.String getServerName()

Returns the server's Bluetooth friendly name. Either it is given when constructing the client or it is requested when the connection is established.

Returns:

Bluetooth friendly name or null if not connected and not given when in the contructor.

getBtAddressLong

public long getBtAddressLong()

Returns the Bluetooth address (long).

Returns:

Bluetooth address as long or -1 if not connected

getDetectedServerChannel

public int getDetectedServerChannel()

Returns the channel number returned by the server after a service search.

Returns:

Detected server channel number, -1 if no service search was performed

setVerbose

public void setVerbose(boolean isVerbose)

Set the verbose mode on/off. Log information are sent via a VerboseWriter. (By default to System.out, but may be redirected to a file.)

Parameters:

isVerbose - if true, the verbose mode is on, otherwise off

See Also:

VerboseWriter