JavaScript. Подробное руководство, 6-е издание

Флэнаган Дэвид

18.1.3.1. Запросы с данными в формате HTML-форм

Рассмотрим HTML-формы. Когда пользователь отправляет форму, данные в форме (имена и значения всех элементов формы) помещаются в строку и отправляются вместе с запросом. По умолчанию HTML-формы отправляются на сервер методом POST, и данные формы помещаются в тело запроса. Схема преобразования данных формы в строку относительно проста: к имени и значению каждого элемента формы применяется обычное URI-кодирование (замена специальных символов шестнадцатеричными кодами), кодированные представления имен и значений отделяются знаком равенства, а пары имя/значение - амперсандом. Представление простой формы в виде строки может выглядеть, как показано ниже:

find=pizza&zipcode=02134&radius=1km

Такой

формат представления данных формы соответствует формальному MIME-типу:

application/x-www-form-urlencoded

Этот тип следует указать в заголовке «Content-Type» запроса при отправке данных такого вида в составе запроса методом POST.

Обратите внимание, что для использования такого формата представления не требуется наличие HTML-формы, и в действительности в этой главе мы не будем работать с формами непосредственно. В Ajax-приложениях чаще всего у вас будет иметься некоторый JavaScript-объект, который необходимо отправить на сервер. (Этот объект может быть создан из полей ввода HTML-формы, но в данном случае это не имеет значения.) Данные, показанные выше, могут оказаться представлением следующего JavaScript-объекта:

{

find: "pizza", zipcode: 02134, radius: "1km"

}

Формат представления данных форм настолько широко используется во Всемирной паутине и настолько хорошо поддерживается всеми языками программирования для создания серверных сценариев, что его применение для представления данных, никак не связанных с формами, часто оказывается наиболее простым и удобным. Пример 18.4 демонстрирует, как преобразовать свойства объекта в формат представления формы.

Пример 18.4. Преобразование объекта в формат для отправки в НТТР-запросе

/**

* Представляет свойства объекта, как если бы они были парами имя/значение

* HTML-формы, с использованием формата application/x-www-form-urlencoded */

function encodeFormData(data) {

if (!data) return // Всегда возвращать строку

var pairs = []; // Для пар имя/значение

for(var name in data) { // Для каждого имени

if (!data.hasOwnProperty(name)) continue; // Пропустить унаслед.

if (typeof data[name] === "function") continue;// Пропустить методы

var value = data[name].toString; // Знач, в виде строки

name = encodeURIComponent(name.replace(”%20”, "+”)); // Кодировать имя

value = encodeURIComponent(value.replace("%20". "+")); // Кодировать значение

pairs.push(name + "=” + value); // Сохранить пару имя/значение

}

return pairs.join('&’); // Объединить пары знаком & и вернуть

}

С

помощью этой функции

encodeFormData

легко можно создавать утилиты, такие как функция

postData,

представленная в примере 18.5. Обратите внимание, что для простоты эта функция

postData

(и аналогичные ей функции в примерах ниже) не обрабатывает ответ сервера. При получении ответа она передает объект

XMLHttpRequest

целиком указанной функции обратного вызова. Эта функция обратного вызова сама должна проверять код состояния ответа и извлекать содержимое ответа.

Пример 18.5. Выполнение запроса HTTP POST с данными в формате представления форм

function postData(url, data, callback) {

var request = new XMLHttpRequest;

request.open("POST", url); // Методом POST на указ, url

request.onreadystatechange = function { // Простой обработчик

if (request.readyState === 4 && callback) // При получении ответа

callback(request); // вызвать указанную функцию

};

request.setRequestHeader("Content-Type", // Установить "Content-Type"

"application/x-www-form-urlencoded");

request.send(encodeFormData(data)); // Отправить данные

} // в представлении форм

Данные формы также могут быть отправлены посредством GET-запроса, и когда цель формы состоит в том, чтобы определить параметры операции чтения, метод GET лучше соответствует назначению формы, чем метод POST. GET-запросы не имеют тела, поэтому «полезный груз» с данными формы отправляется серверу в виде строки запроса в адресе URL (следующей за знаком вопроса). Утилита

encodeFormData

может также пригодиться для отправки подобных GET-запросов, и пример 18.6 демонстрирует такое ее применение.

Пример 18.6. Выполнение GET-запроса с данными в формате представления форм

function getData(url, data, callback) {

var request = new XMLHttpRequest;

request.open("GET", url + // Методом GET на указанный url

"?" + encodeFormData(data)); // с добавлением данных

request.onreadystatechange = function { // Простой обработчик событий

if (request.readyState === 4 && callback) callback(request);

};

request.send(null); // Отправить запрос

}

Для добавления данных в URL-адреса HTML-формы используют строки запросов, но использование объекта

XMLHttpRequest

дает свободу представления данных.

При наличии соответствующей поддержки на сервере наш запрос на поиск пиццерии можно оформить в виде более удобочитаемого URL-адреса, такого как показано ниже: