• Another Java ME Bluechat

• Java ME Bluechat

1. Default (Inquiry for Devices -> Search for Services -> Connect and start exchanging messages)

2. AutoConnect

3. Layer

Interfaces that will have to be implemented

Before we start, Marge uses some interfaces that will be listeners in the inquiry process, message received, etc. We are going to explain each one, because they will be used in the next steps.

• CommunicationListener - It is used by both server and client device to notify received message and possible errors in receiving them.
• ConnectionListener - When a connection is established and because the server waits asynchronous, the server will be notified and returned by this interface.
• InquiryListener - The interface that returns the devices found. Used by DeviceInquirier.
• ServiceSearchListener - The interface that returns the services found. Used by ServiceSearcher.

Start a Server

Connect a client

AutoConnect

How to Start with Marge 0.5

Marge 0.5 is almost compatible with 0.4.0. Try o add the new jar and check what have changed, Currently there is two ways to have devices connected using Marge: Default and AutoConnect^?.

Default (Inquiry for Devices -> Search for Services -> Connect and start exchanging messages)

Basically you need to start a server and the client needs to inquiry for the Bluetooth devices, search for specific service in a device and then connect. After this process, the both can exchange messages.

Start a Server, communicating with the server

Basically you create a protocol factory, create a configuration for the server and send this configuration to the factory. Your server device will return by a listener. If you do not specify nothing, default stuff will be used, such as for example, a default service.

// Creating a factory using RFCOMM protocol if you want to use L2CAP protocol instead, 
//try L2CAPCommunicationFactory
CommunicationFactory factory = new RFCOMMCommunicationFactory();

// Creating a server configuration. You can set specific configurations using this class.
ServerConfiguration sconf = new ServerConfiguration(new CommunicationListenerImpl());

// Creating a server with the factory. The server device instance will be rertuned by the ConnectionListenerImpl, 
//which is a implementation of ConnectionListener.
factory.waitClients(sconf, new ConnectionListenerImpl());

Inquiry for Devices

The devices found in the inquiry process will be returned by InquiryListenerImpl^?, which is a implementation of InquiryListener^?

// Starting GIAC inquiry for devices. You can do LIAC inquiries changing the method
DeviceDiscoverer.getInstance().startInquiryGIAC(new InquiryListenerImpl());

//Cancel inquiry
DeviceDiscoverer.getInstance().cancelInquiry();

Search for Services

The devices found in the inquiry process will be returned by ServiceSearchListenerImpl^? which is a implementation of ServiceSearchListener^?. If you have not specified a specific UUID service, the default will be used, otherwise you can send as a parameter in this startSearch methods.

// Starting search for services in a found device
ServiceDiscoverer.getInstance().startSearch(remoteDeviceFound, new ServiceSearchListenerImpl());

Connect and start

//Creates a client configuration using the specific ServiceRecord found by ServiceSearcher
ClientConfiguration clientConfig = new ClientConfiguration(serviceRecord, CommunicationListenerImpl);

//Create a protocol factory to get the client
CommunicationFactory factory = new RFCOMMCommunicationFactory();

//Gets the client device instance
ClientDevice device = factory.connectToServer(clientConfig);

Exchange messages

Both server and device needs to startListening the messages and then can send messages using send method.

// Starting listening for incoming messages
device.startListening();

// Device sending a message
device.send("Test message".getBytes());

// Closing connection
device.close();

AutoConnect^?

If you do not want to program the inquiry process, you can use AutoConnect^?. Be sure the place that the application will run does not contain much Bluetooth devices and is running that the service that you want, otherwise AutoConnect^? can take a long time to response back or can connect in another same service.

Create a server

//Creates a server. The service UUID will be generated by the name. 
//The serverDevice will be returned by ConnectionListenerImpl.
AutoConnect.createServer("MargeBluechatServer", communicationListenerImpl, connectionListenerImpl);

Client connects to a server

//Creates a server. The service UUID will be generated by the name.
ClientDevice device = AutoConnect.createServer("MargeBluechatServer", communicationListenerImpl);

Layer

If you want special behavior in the messages exchanged, you can use the new concept of layer. It is still evolving to maybe something like a decorator. Currently, there is a unicast layer, if you want your device having this behavior, just extend UnicastMessageLayer^?. After that, you can instantiate it passing a device and then use its methods to have the special behavior.

//send a message yo a specific address
unicastLayer.sendMessage(stringAddress, "Marge rocks!".getBytes());

//all the names on the server will be returned by receiveNameOnServer(String address, String name) method
unicastLayer.getNamesOnServer();

//you need to implement it
public abstract void receiveMessage(String from, byte[] message);

//you need to implement it.     
public abstract void receiveNameOnServer(String address, String name);

-- Main.brunogh - 15 Mar 2008