Использование Bluetooth в J2ME приложениях. (JSR-82) - Часть 2. Обзор Connection и Device Management API

Наиболее часто используется первая форма записи. Параметр URL имеет следующий вид:

scheme://host:port;parameters

Где

• scheme - определяет тип соединения (см приведенную ниже таблицу).
• host - для клиента определяет удаленный адрес сервера; для сервера:licalhost.
• port - для клиента определяет протокол соединения; для сервера - service UUID.
• parameters - дополнительные параметры, например дружественное имя или размер MTU.

В следующей таблице приведена информация о URL схеме и типах GCF соединения, которые можно использовать для RFCOMM и L2CAP Bluetooth соединениях:

Для создания клиентского Bluetooth соединения, Вы должны указать в URL адрес удаленного устройства и канал. Например, чтобы создать RFCOMM соединение, укажите в URL btspp схему, удаленный адрес и канал сервиса:

StreamConnection con=(StreamConnection) Connector.open("btspp://0050C000321B:5");
 

Для L2CAP соединения аналогично указываем схему btl2cap, адрес и мультиплексор обслуживания протокола.

L2CAPConnection con=(L2CAPConnection) Connector.open("btl2cap://0050C000321B:1000");

Для обнаружения клиентского соединения, используйте метод ServiceRecord.getConnectionURL().

Для того чтобы создать серверное Bluetooth соединение, необходимо указать localhost, service UUID и имя. Например, для создания RFCOMM (SPP) соединения, укажите схему btspp, localhost в качестве адреса, UUID и имя:

StreamConnectionNotifier cn=(StreamConnectionNotifier)
Connector.open("btspp://localhost:"+ MY_SERVICE_NUMBER);

Здесь переменная MY_SERVICE_NUMBER содержит UUID и имя сервиса:

"3B9FA89520078C303355AAA694238F08;name=mySPPSrv".

Для создания L2CAP соединения, укажите схему btl2cap, UUID и имя:

L2CAPConnectionNotifier= cn(L2CAPConnectionNotifier)
Connector.open("btl2cap://localhost:"+ MY_SERVICE_NUMBER);
 

MY_SERVICE_NUMBER определяется аналогично случаю RFCOMM (SPP)

Перед созданием Bluetooth соединения необходимо получить ссылку на локальное устройство и сделать его доступным для поиска:

LocalDevice local= LocalDevice.getLocalDevice();
local.setDiscoverable(DiscoveryAgent.GIAC);

Ожидание соединения

Ожидание соединения складывается из

1. Создания сервера соединения, используя подходящий механизм прослушивания:
   • Для RFCOMM - StreamConnectionNotifier
   • Для L2CAP - L2CAPConnectionNotifier
2. Ожидания принятия и открытия нового соединения с помощью метода acceptAndOpen().

<b>Listing1. Обработка входящего L2CAP соединения</b>
L2CAPConnectionNotifier server=null;
byte[] data=null;
int length;
:
:
try{
// Получаем ссылку на локальное устройство и делаем его доступным для поиска
LocalDevice local= LocalDevice.getLocalDevice();
local.setDiscoverable(DiscoveryAgent.GIAC);
// Инициализируем прослушивание L2CAP соединения
server=(L2CAPConnectionNotifier)
Connector.open("btl2cap://localhost:1020304050d0708093a1b121d1e1f100");
while(!done){
L2CAPConnection conn=null;
// Ожидаем входящее L2CAP соединение
conn= server.acceptAndOpen();
// Читаем входящие данные
length= conn.getReceiveMTU();
data=new byte[length];
length= conn.receive(data);
:
:
}
} catch(Exception e){
... Обработка исключительных ситуаций
}
 

<b>Listing2. Обработка входящего потокового соединения.</b>
 
StreamConnectionNotifier server=null;
byte[] data=new byte[256];
int length;
:
:
try{
// Получаем ссылку на локальное устройство и делаем его доступным для поиска
LocalDevice local= LocalDevice.getLocalDevice();
local.setDiscoverable(DiscoveryAgent.GIAC);
// Инициализируем прослушивание потокового соединения
server=(StreamConnectionNotifier)Connector.open(
"btspp://localhost:11111111111111111111111111111111");
while(!done){
StreamConnection conn=null;
// Ожидаем входящее потоковое соединение
conn= server.acceptAndOpen();
// Читаем входящие данные
InputStream in= conn.openInputStream();
length= in.read(data);
:
:
}
} catch(Exception e){
... Обработка исключительных ситуаций
}
 

Отправка и получение данных

Для отправки и получения потоковых данных используетсяStreamConnection, а для отправки и получения L2CAP данных - L2CAPConnection

<b>Listing3. Отправка потока данных с помощью L2CAPConnection.</b>
 
String url="...";
int index=0;
L2CAPConnection con=null;
transmitBuffer[] temp=null;
byte[] data=...;
 
try{
// Открываем соединение с сервером
con=(L2CAPConnection)Connector.open(url);
// Задаем transmit MTU (максимальный размер данных, который может быть передан)
int MTUSize= con.getTransmitMTU();
// Создаем буфер размером MTU.
transmitBuffer=new byte[MaxOutBufSize];
:
:
 
while(index< data.length){
// Отправка данных ... перемещение MTUSize байт из буфера передаваемых данных
if((data.length- index)< MTUSize){
System.arraycopy(data, index, transmitBuffer,0, data.length- index);
}else{
System.arraycopy(data, index, transmitBuffer,0, MTUSize);
}
// Отправка данных и обновление индекса данных
con.send(transmitBuffer);
index+= MTUSize;
// Очищение буфера передаваемых данных
for(int=0; i<MTUSize; i++) transmitBuffer[i]=0;
}
// Закрытие исходящего соединения и потока.
con.close();
} catch(Exception e){
... Обработка исключительных ситуаций.
}
 

<b>Listing4. Отправка потока данных с помощью StreamConnection.</b>
String url= “…”;
OutputStream os=null;
StreamConnection con=null;
:
:
try{
// Открываем соединение с сервером
con=(StreamConnection)Connector.open(url);
// Открываем исходящий поток
os= con.openOutputStream();
// Отправляем поток данных на удаленное устройство
os.write(data.getBytes());
// Закрываем исходящее соединение и поток
os.close();
con.close();
} catch(Exception e){
... Обрабатываем исключительные ситуации
}
 

Обзор Device Management API

В основе механизмов управления устройством лежат классы javax.bluetooth.LocalDevice, javax.bluetooth.RemoteDevice и javax.bluetooth.DeviceClass. Реализуемые ими методы управления являются частью Generic Access Profile (GAP).

Локальное устройство

Доступ к локальному Bluetooth устройству можно получить через javax.bluetooth.LocalDevice. Этот класс предоставляет методы управления, восстановления и получения информации о локальном устройстве (например, Bluetooth адрес, класс устройства, информация об агенте поиска). Приведем наиболее часто используемые на практике методы:

• static LocalDevice getLocalDevice()- метод возвращает LocalDevice объект, представляющий локальное устройство.
• java.lang.String getBluetoothAddress()- возвращает адрес локального Bluetooth устройства. Адрес возвращается в виде Java.lang.String и состоит из 12 символов.
• java.lang.String getFriendlyName()- метод возвращает дружественное имя локального Bluetooth устройства.
• DiscoveryAgent getDiscoveryAgent()- метод возвращает агент поиска для локального устройства.
• boolean setDiscoverable(int mode)- метод задает режим доступности для поиска.
• static java.lang.String getProperty(java.lang.String property- метод возвращает системные настройки Bluetooth устройства.
• ServiceRecord getRecord(javax.microedition.io.Connection notifier) - метод возвращает запись обслуживания, соответствующую переданному механизму уведомления (btspp, btl2cap или btgoep).

<b>Listing5. Использование LocalDevice методов.</b>
import javax.microedition.io.*;
import javax.bluetooth.*;
 
LocalDevice localDevice;// Локальное устройство
String localAddress;// Адрес локального устройства
String localName;// Имя локального устройства
DiscoveryAgent agent;// Агент поиска для локального Bluetooth устройства
:
:
try{
// Получаем локальное устройство
localDevice= LocalDevice.getLocalDevice();
// Делаем его доступным для поиска
localDevice.setDiscoverable(DiscoveryAgent.GIAC);
// Получаем адрес локального Bluetooth устройства
localAddress= localDevice.getBluetoothAddress();
// Получаем имя устройства
localName= localDevice.getFriendlyName();
// Получаем объект агента поиска для изучения устройства и сервисов
agent= localDevice.getDiscoveryAgent();
} catch(Exception e){
... Обрабатываем ошибки
}
 
 

Удаленное устройство

Удаленное Bluetooth устройство доступно через javax.bluetooth.RemoteDevice. Этот класс предоставляет методы для получения RemoteDevice объекта, связанного с Bluetooth соединением; методы получения имени и адреса удаленного устройства, а также методы, относящиеся к обеспечению безопасности. Приведем наиболее используемые их них:

• static RemoteDevice getRemoveDevice(javax.microedition.io.Connection)- метод возвращает RemoteDevice объект, связанный с переданным соединением.
• java.lang.String getBluetoothAddress()- возвращает адрес удаленного Bluetooth устройства. Адрес возвращается в виде Java.lang.String и состоит из 12 символов.
• java.lang.String getFriendlyName()- метод возвращает дружественное имя удаленного Bluetooth устройства.
• boolean authenticate()- подтверждение подлинности удаленного устройства.
• boolean isAuthenticated()- определяет, прошло ли удаленное устройство проверку.
• boolean isEncrypted()- определяет, должно ли выполняться шифрование данных при обмене с удаленным устройством

<b>Listing6. Using the RemoteDevice methods.</b>
import javax.microedition.io.*;
import javax.bluetooth.*;
 
String url="...";
StreamConnection con;
RemoteDevice remoteDevice;// Удаленное устройство
String remoteAddress;// Адрес удаленного устройства
String remoteName;// Имя удаленного устройства
:
:
try{
con=(StreamConnection) Connector.open(url);
remoteDevice= RemoteDevice.getRemoteDevice(con);
// Получаем адрес удаленного устройства
remoteAddress= remoteDevice.getBluetoothAddress();
// Получаем имя удаленного устройства
remoteName= remoteDevice.getFriendlyName();
if(!remoteDevice.isEncrypted()){
// Если данные не расшифрованы, пытаемся их расшифровать.
if(!remoteDevice.authenticate()||!remoteDevice.encrypt(con,true)){
// Ошибка, невозможно расшифровать данные
return;
}
}
} catch(Exception e){
... Обработка ошибок
}
 

Класс устройства

DeviceClass представляет класс устройства (CoD) соответственно Bluetooth спецификации. Классы устройств определяются с помощью major, minor и service классов. Для DeviceClass определены следующие методы:

• int getMajorDeviceClass() - возвращает major классы устройства.
• int getMinorDeviceClass() - возвращает minor классы устройства.
• int getServiceClasses() - возвращает service классы.

<b>Listing7. Использование методов DeviceClass.</b>
static final NLDMSC=0x22000;// Networking, Limited Discoverable Major Service Class
static final PHONE_MAJOR_CLASS=0x200;
static final CELLULAR_MINOR_CLASS=0x04;
:
:
LocalDevice localDevice;
DeviceClass deviceClass;
:
:
try{
// Получаем локальное устройство
localDevice= LocalDevice.getLocalDevice();
// Получаем класс устройства для локального устройства
deviceClass= localDevice.getDeviceClass();
// В зависимости от класса устройства выполняем подходящие действия
if(deviceClass.getMajorDeviceClass()== PHONE_MAJOR_CLASS){
if(deviceClass.getMinorDeviceClass()== CELLULAR_MINOR_CLASS){
:
:
}
}
} catch(Exception e){
... Обработка ошибок
}
 

Получение информации о настройках Bluetooth устройства

Java APIs for Bluetooth определяет ряд свойств для локального Bluetooth устройства. Эти свойства могут быть получены с помощью метода LocalDevice.getProperty():

LocalDevice locaDevice= LocalDevice.getLocalDevice();
String apiVer= localDevice.getProperty(“bluetooth.api.version”);

В приведенной ниже таблице содержатся доступные свойства и их описание

Эта статья является переводом документа Developing Applications with the Java APIs for Bluetooth™ (JSR-82), найденного на сайтеhttp://developer.sonyericsson.com
Перевод:aRix.