Таблица 8.2. Методы интерфейса OutputConnection
Имя метода OutputConnection — Описание
DataOutputStream openDataOutputStream () — Открывает и возвращает DataOutputStream, который соединяется с сетевым ресурсом, связанным с этим соединением.
OutputStream openOutputStream () — Открывает и возвращает OutputStream, который соединяется с сетевым ресурсом, связанным с этим соединением.
Интерфейс StreamConnection происходит непосредственно из интерфейсов InputConnection и OutputConnection. Он наследует методы двух интерфейсов, описанных ранее в таблицах 8.1 и 8.2.
Интерфейс StreamConnection представляет соединение как поток данных в наиболее абстрактном смысле слова — как последовательность байтов. Это пустой интерфейс, он не привносит нового поведения в дополнение к любому из его двух вышестоящих интерфейсов. Тем не менее, его присутствие в иерархии необходимо для целей, лежащих за пределами обязанностей интерфейсов InputConnection и OutputConnection. Он работает как заполнитель, представляющий любой тип соединения, чьи данные могут быть обработаны как поток байтов.
Интерфейс StreamConnection извлекает подробную информацию о механизме соединения — протоколе, используемом в реализации определенного типа соединения, а также его синтаксисе и семантике. Например, J2ME Wireless Toolkit предоставляет две реализации StreamConnection — одну для соединения с портами связи, а другую для соединения с сокетами клиентов стиля Unix. Интерфейс StreamConnection определяет оба этих типа соединения как необработанные потоки данных без определения синтаксиса или семантики протокола. Реализации, однако, совершенно отличны. В данном разделе вы увидите, как настраивать соединение с коммуникационным портом. Затем вы узнаете, как настраивать соединение сокета.
Соединения с коммуникационными портами, как и все другие соединения, должны быть установлены путем передачи URI в Connector.open(). Вы должны указать адрес порта связи, который вы хотите открыть. Поле схемы должно иметь значение соггап, которое определяет соединение как потоковое соединение для коммуникационных портов. Полная форма адреса следующая:
address:= <схема>:<уэел>;
<параметры> cheme:= «coram»
unit:=
parameters:= <зависящие от устройства параметры конфигурации>
Например, вы могли открыть соединение с коммуникационным портом с помощью следующего оператора:
StreamConnection conn = Connector.open("comm:0;baudrate=9600");
Полный набор параметров, которые приемлемы, зависит от родной системы программного обеспечения драйвера устройства, и, в конечном счете, конечно, на устройстве, с которым соединение было установлено.
Интерфейс ContentConnection дополняет интерфейс StreamConnection. Он уточняет понятие потокового соединения. Он определяет соединения, включающие содержимое, вместо представления их как простого потока необработанных байтов или потока, чья структура должна быть отмечена как приоритетная (priori).
Конечно, все потоки содержат некоторого рода «содержимое», основная цель сообщений протокола заключается в транспортировке полезной нагрузки данными. Идея, лежащая в основе интерфейса ContentConnection, заключается в том, что он представляет соединения, которые могут описать свое содержимое некоторым образом, обычно с помощью наличия атрибутов метаинформации, определенных протоколом. Интерфейс ContentConnection предоставляет подробную информацию об извлечении этой информации из потока, так что вам не придется знать синтаксис или семантику протокола реализации.
Интерфейс ContentConnection представляет собой общие характеристики семейства протоколов уровня приложений, которые обычно определяют атрибуты, описывающие транспортируемые ими данные. Более точно, ContentConnection определяет несколько базовых атрибутов, которые являются общими для всех таких соединений содержимого соединений. В таблице 8.3 перечислены три метода, определяемые ContentConnection. Вы можете видеть, как они применяются по отношению к семейству протоколов уровня приложений.
Таблица 8.3. Методы интерфейса ContentConnection
Имя метода ContentConnection — Описание
String getEncoding() — Выдает значение поля, показывающего набор символов шифрования, используемых для представления содержимого сообщения
long getLength() — Выдает длину сообщения
String getType() — Выдает тип содержимого
Протоколы, которые могут быть представлены этим интерфейсом, обычно используют некоторого рода пометку атрибута, не зависящую от содержимого, которое они транспортируют. Примером такого протокола является протокол HTTP.
Неудивительно, что интерфейс ContentConnection имеет один подинтерфейс, HttpConnection, который представляет соединения, использующие протокол HTTP. Интерфейс HttpConnection определяется MIDP, а не CLDC. HTTP является протоколом содержимого соединений уровня приложений. Вы, несомненно, понимаете, что три метода интерфейса ContentConnection, перечисленные в таблице 8.3, применимы к HTTP.
Интерфейс HttpConnection расширяет эту абстракцию до более конкретного описания атрибутов соединений протокола HTTP. Он поддерживает передачу запросов и получение откликов, а также возможность извлекать и анализировать поля HTTP как для сообщения запроса, так и для ответа. Он также предусматривает возможность получения информации о самом соединении. В таблице 8.4 перечислены методы интерфейса HttpConnection.
Таблица 8.4. Методы интерфейса HttpConnection
Название метода HttpConnection — Описание
long getDate () — Выдает значение поля заголовка даты
long getExpiration () — Выдает значение поля заголовка Expires
String getFile () — Выдает значение поля URL данного соединения
String getHeaderField (int n) — Выдает значение части пронумерованного поля заголовка ключ-значение
String getHeaderField (String name) — Выдает значение поля заголовка с указанным именем ключа. В качестве аргумента приемлемо любое действительное имя поля HTTP
long getHeaderFieldDate (String name, long def) — Выдает значение (анализируемое как дата) поля заголовка с указанным ключом
int getHeaderFieldlnt (String name, int def) — Выдает значение (анализируемое как целое) названного поля заголовка
String getHeaderFieldKey (int n) — Выдает часть ключа пронумерованного поля заголовка
String getHost () — Выдает часть HOST URL данного соединения
long getLastModified () — Выдает значение поля LastModified URL.
int getPort () — Выдает значение поля порта URL данного соединения
String getProtocol () — Выдает имя протокола URL
String getQuery () — Выдает область запроса URL, часть после первого"?" в URL
String getReff () — Выдает часть ссылки URL
String getRequestMethod () — Выдает метод текущего запроса
String getRequestProperty (String key) — Выдает значение указанного свойства общего запроса
int getResponseCode () — Выдает код состояния отклика v HTTP
String getResponseMessage () — Выдает сообщение отклика HTTP, связанное с кодом состояния отклика
String getURL () — Выдает строковую форму URL
void setRequestMethod (String method) — Устанавливает метод для URL; приемлемыми значениями являютсяGET, POST И HEAD
void setRequestProperty (String key, String value) — Устанавливает значение указанного свойства общего запроса