Платформа J2Me - Автор неизвестен

Интерфейс 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) — Устанавливает значение указанного свойства общего запроса

В дополнение к этим методам интерфейс HttpConnection также определяет полную совокупность констант, представляющих коды статуса и ошибок HTTP, которые показаны в таблице 8.5. Для получения дополнительной информации о константах кода статуса смотрите HTTP 1.1, спецификацию RFC2616, которую можно найти по адресу http://www.w3c.org или на http://www.ietf.org.

Таблица 8.5. Определения констант интерфейса HttpConnection

Константа HttpConnection — Описание

static String GET — Представляет метод запроса GET

static String HEAD — Представляет метод запроса HEAD

static int HTTP_ACCEPTED — HTTP статус 202

static int HTTP_BAD_GATEWAY — HTTP статус 502

static int HTTP_BAD_METHOD — HTTP статус 405

static int HTTP_BAD_REQUEST — HTTP статус 400

static int HTTP_CLIENT_TIMEOUT — HTTP статус 408

static int HTTP_CONFLICT — HTTP статус 409

static int HTTP_CREATED — HTTP статус 201

static int HTTP_ENTITY_TOO_LARGE — HTTP статус 413

static int HTTP_EXPECT_FAILED — HTTP статус 41 7

static int HTTP_FORBIDDEN — HTTP статус 403

static int HTTP_GATEWAY_TIMEOUT — HTTP статус 504

static int HTTP_GONE — HTTP статус 410

static int HTTP_INTERNAL_ERROR — HTTP статус 500

static int HTTP_LENGTH_REQUIRED — HTTP статус 41 1

static int HTTP_MOVED_PERM — HTTP статус 301

static int HTTP_MOVED_TEMP — HTTP статус 302

static int HTTP_MULT_CHOICE — HTTP статус 300

static int HTTP_NO_CONTENT — HTTP статус 204

static int HTTP_NOT_ACCEPTABLE — HTTP статус 406

static int HTTP_NOT_AUTHORITATIVE — HTTP статус 203

static int HTTP_NOT_FOUND — HTTP статус 404

static int HTTP_NOT_IMPLEMENTED — HTTP статус 501

static int HTTP_NOT_MODIFIED — HTTP статус 304

static int HTTP_OK — HTTP статус 200

static int HTTP_PARTIAL — HTTP статус 20В

static int HTTP_PAYMENT_REQUIRED — HTTP статус 402

static int HTTP_PRECON_FAILED — HTTP статус 412

static int HTTP_PROXY_AUTH — HTTP статус 407

static int HTTP_REQ_TOO_LONG — HTTP статус 414

static int HTTP_RESET — HTTP статус 205

static int HTTP_SEE_OTHER — HTTP статус 303

static int HTTP_TEMP_REDIRECT — HTTP статус 307

static int HTTP_UNAUTHORIZED — HTTP статус 401

static int HTTP_UNAVAILABLE — HTTP статус 503

static int HTTP_UNSUPPORTED_RANGE — HTTP статус 416

static int HTTP_UNSUPPORTED_TYPE — HTTP статус 41 5

static int HTTP_USE_PROXY — HTTP статус 305

static int HTTP_VERSION — HTTP статус 505

static String_HTTP_POST — Представляет метод запроса POST

Вы можете видеть, что интерфейс HttpConnection предоставляет наибольший набор функциональных возможностей из всех интерфейсов. HTTP является протоколом уровня приложений, наиболее часто поддерживаемым реализациями MIDP.

В листингах с 8.1 по 8.4 показан исходный код для простой программы, которая демонстрирует, как пользователь мобильного устройства может запрашивать ресурс HTTP с удаленного сервера. Вы можете найти, что эта программа не работает при выполнении за пределами вашего корпоративного брандмауэра, в зависимости от конфигураций сети вашей компании, брандмауэра и прокси-сервера. Вы можете быть ограничены до посещения URI ресурсов, расположенных в пределах вашей корпоративной сети.

Протокол HTTP определяет семантику, связанную с тем, что клиентам необходимо запрашивать ресурсы через прокси-сервер. Браузер может изменять URI пользователя, основываясь на настройках его прокси, и посылать измененный запрос на прокси-сервер, который перенаправляет его на исходный сервер. Программа не делает таких изменений URI, и поэтому она не может пересылать URI, как ожидается вашим прокси-сервером. Если вы не знаете, как браузер изменяет URI, у вас могут возникнуть сложности при доступе к URI, являющимся внешним по отношению к вашей корпоративной сети. Результат выразится в том, что программа, показанная в листинге 8.1, сбросит lOException.

Программа, показанная в листинге 8.1, отображает только метаинформацию о запрошенных ресурсах и не отображает сам ресурс. Она лишь запрашивает информацию заголовка для каждого ресурса, используя метод HEAD HTTP. Написание программы, которая отображала бы произвольное содержимое, было бы равноценно написанию целого браузера, что, очевидно, лежит за пределами темы данной книги. К счастью, некоторые компании предлагают HTTP-браузеры, которые работают на устройствах MIDP, так что вам не придется проделывать эту огромную работу.

Листинг 8.1. Программа ConnectionDemo определяет MID-лет, который отображает мета-информацию протокола HTTP, а именно значения полей заголовка HTTP. Программа использует команду HEAD для получения лишь мета информации, а не всей страницы

import javax.microedition.midlet.MI Diet;

import javax.microedition.lcdui.Display;

Этот класс определяет MID-лет для демонстрационной программы, которая запрашивает у пользователя URI, затем создает соединение HTTP с исходным сервером и извлекает ресурс. Программа использует объект Form, для того чтобы дать пользователю возможность ввести URI.

*/

public class ConnectionDemo extends MID-лет

}