Чтение онлайн

В запросе можно определить заголовок «Authorization», но обычно в этом нет необходимости. При выполнении запроса к ресурсу, защищенному паролем, передайте имя пользователя и пароль методу

в четвертом и пятом аргументах, а объект автоматически установит соответствующие заголовки. (О третьем необязательном аргументе метода рассказывается ниже, а описание аргументов, в которых передаются имя пользователя и пароль, можно найти в справочной части книги.)

Последний этап в процедуре выполнения HTTP-запроса с помощью объекта

– передача необязательного тела запроса и отправка его серверу. Делается это с помощью метода

GET-запросы не имеют тела, и в этом случае можно передать методу значение null или вообще опустить аргумент. POST-запросы обычно имеют тело, и оно должно соответствовать заголовку «Content-Type», установленному с помощью метода

.

Пример 18.1 демонстрирует использование всех методов объекта

, описанных выше. Он отправляет серверу текстовую строку методом POST и игнорирует ответ, возвращаемый сервером.

Пример 18.1. Отправка простого текста на сервер методом POST

Обратите внимание, что вызов метода

в примере 18.1 инициирует запрос и затем возвращает управление: он не блокируется в ожидании ответа от сервера. HTTP-ответы практически всегда обрабатываются асинхронно, как будет показано в следующем разделе.

Части HTTP-запроса следуют в определенном порядке: метод запроса и URL-адрес должны определяться в первую очередь, затем должны устанавливаться заголовки запроса и, наконец, тело запроса. Обычно реализации

ничего не отправляют в сеть, пока не будет вызван метод Но прикладной интерфейс спроектирован так, как если бы каждый метод немедленно отправлял данные в сеть. Это означает, что методы объекта должны вызываться в порядке, соответствующем структуре HTTP-запроса. Например, метод должен вызываться после метода и перед методом в противном случае он возбудит исключение.

Полный HTTP-ответ содержит код состояния, набор заголовков ответа и тело ответа. Все это доступно в виде свойств и методов объекта

:

• Свойства

и возвращают код состояния HTTP в числовом и текстовом виде. Эти свойства хранят стандартные HTTP-значения, такие как 200 и «ОК» в случае успешного выполнения запроса или 404 и «Not Found» при попытке обратиться к ресурсу, отсутствующему на сервере.

• Заголовки ответа можно получить с помощью методов

и Обработка cookies выполняется объектом автоматически: он исключает заголовки «Cookie» из множества, возвращаeмого методом и возвращает null, если передать аргумент «Set-Cookie» или «Set-Cookie2» методу

• Тело ответа в текстовом виде доступно через свойство

или в виде объекта через свойство . (Выбор такого имени свойства объясняется историческими причинами: фактически оно предназначено для работы с XHTML- и XML-документами, но спецификация «ХНН2» определяет, что оно также должно работать с обычными HTML-документами.) Более подробно о свойстве рассказывается в разделе 18.1.2.2.

Обычно объект

используется в асинхронном режиме (но загляните в раздел 18.1.2.1): метод возвращает управление сразу же после отправки запроса, поэтому методы и свойства, перечисленные выше, не могут использоваться до фактического получения ответа. Чтобы определить момент получения ответа, необходимо обрабатывать событие «readystatechange» (или событие «progress», определяемое новой спецификацией «ХНН2» и описываемое в разделе 18.1.4), возбуждаемое в объекте . Но, чтобы понять, как обрабатывать это событие, необходимо сначала разобраться со свойством .

Свойство

– это целочисленное значение, определяющее код состояния HTTP-запроса; его возможные значения перечислены в табл. 18.1. Идентификаторы, указанные в первой колонке, - это константы, определяемые конструктором . Эти константы являются частью спецификации , но старые версии броузеров и ІE8 не определяют их, поэтому часто можно увидеть программный код, в котором вместо константы используется числовое значение 4.