Справочник функций

Ваш аккаунт

Войти через: 
Забыли пароль?
Регистрация
Информацию о новых материалах можно получать и без регистрации:

Последние темы форума

Показать новые сообщения »

Почтовая рассылка

Подписчиков: 11639
Последний выпуск: 19.06.2015

Internet Explorer 8: XDomainRequest

Автор: Landgraph
Дата: 7 апреля 2008 года

Введение

Новый Internet Explorer 8 (IE8) принес с собой одно приятное нововведение, призванное, как когда-то это сделал XMLHttpRequest, облегчить жизнь программистам и дать бОльшие возможности для взаимодействия с пользователем.

Напомню, что XMLHttpRequest может работать при условии, что запрашиваемый документ и страница, с которой направлен запрос, должны быть в одном домене. Например, http://www.landgraph.ru/test/test_xml.html - страницы с кодом запроса XMLHttpRequest и http://www.landgraph.ru/test/test_xml.xml - запрашиваемый XML файл.

Новой "фишкой" восьмой версии IE8 является интерфейс XDomainRequest (IHTMLXDomainRequest), с помощью которого, в отличие от XMLHttpRequest, можно делать запросы к различным доменам. Другими словами, страница с кодом XDomainRequest может находиться по адресу http://www.landgraph.ru/test/test.html, а запрашиваемая страница - http://www.google.com/.

Описание XDomainRequest

Рассмотрим структуру интерфейса. Основные элементы интерфейса, необходимые для работы, отмечены жирным шрифтом.

Свойства

Каждый объект XDomainRequest имеет следующие свойства:

СвойствоОписание
contentTypeСвойство доступно для чтения и записи, определяет тип данных как полученных, так и передаваемых данных
responseTextСвойство доступно для чтения и содержит данные, полученные от сервера в текстовом виде
timeoutСвойство доступно для чтения и записи, содержит значение времени ожидания ответа сервера

События

Объект XDomainRequest может порождать следующие события:

СобытиеОписание
onerrorСобытие происходит, когда во время запроса произошла какая-то ошибка, кроме превышения времени ожидания ответа (см. ниже). Точнее узнать род ошибки пока не возможно.
onloadСобытие происходит, когда полностью получен ответ от сервера
onprogressСобытие происходит, когда браузер начинает получение данных от сервера
ontimeotСобытие происходит, когда превышено время ожидания ответа от сервера

Методы

Все объекты XDomainRequest обладают следующим набором методов:

МетодОписание
open

Метод создает соединение с доменом

Синтаксис:

object.open(Method, URL)

Method - строка "GET" или "POST", в зависимости от метода передачи данных серверу, обязательный аргумент

URL - адрес документа на сервере, обязательный аргумент

sendМетод отсылает запрос (с данными или без них) и начинает процесс приема данных с сервера

Синтаксис:

object.send([Data])

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

abortМетод прерывает выполнение метода send

Синтаксис:

object.abort()

Использование

Отправка запроса

Теперь перейдем к программированию. Все примеры написаны на языке JavaScript. Проверить наличие XDomainRequest можно просто:

if(window.XDomainRequest) {
	//Действия при наличии интерфейса
	}
else {
	//Действия при отсутствии интерфейса
	}

В принципе, все точно так же, как и при работе с XMLHttpRequest.

Создать объект интерфейса можно с помощью следующего кода:

	var xdr = new window.XDomainRequest;

Теперь необходимо открыть соединение с сервером. Сделать это можно с помощью метода open:

	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");

В данном случае мы указываем метод GET передачи запроса. Далее следует отослать запрос с помощью метода send:

	xdr.send("какие-то данные");

При этом, мы можем и не передавать данные, а вызвать метод без параметров:

	xdr.send();

Всё. На этом передача данных завершается. Итого у нас получился следующий код:

if(window.XDomainRequest) {
	var xdr = new window.XDomainRequest;
	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");
	xdr.send();
	}
else {
	alert("XDomainRequest отсутствует!");
	}

Получение данных

Практически всегда необходимо также получить данные от сервера. Сделать это можно, если установить обработчик события onload объекта. Напомню, что событие onload происходит, когда данные от сервера получены в полном объеме.

xdr.onload=xdrLoad;
...
function xdrLoad() {
	var data=xdr.responseText;
	//Выполнение действий с полученными данными
	}

Например, следующий код выводит полученные данные в виде сообщения:

if(window.XDomainRequest) {
	var xdr = new window.XDomainRequest;
	xdr.onload=xdrLoad;
	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");
	xdr.send();
	}
else {
	alert("XDomainRequest отсутствует!");
	}

function xdrLoad() {
	var data=xdr.responseText;
	alert("Приняты данные следующего содержания:\r\n"+data);
	}

Обработка ошибок

Не секрет, во время работы происходят те или иные ошибки. И лучше пользователю либо узнать об их появлении, либо обработать самостоятельно. Пока что мы можем обработать только два вида ошибок: превышение времени ожидания ответа сервера и все остальные ошибки. Первые обрабатываются через событие ontimeout, вторые через событие onerror. Пример:

if(window.XDomainRequest) {
	var xdr = new window.XDomainRequest;
	xdr.onerror=xdrError;
	xdr.onerror=xdrTimeOut;
	xdr.open("get", "http://www.landgraph.ru/test/test_xdr.php");
	xdr.send();
	}
else {
	alert("XDomainRequest отсутствует!");
	}

function xdrError() {
	alert("Во время выполнения запроса произошла ошибка!");
	}

function xdrTimeOut() {
	alert("Истекло время ожидания ответа сервера, попробуйте еще раз!");
	}

Требования к серверу

При использовании интерфейса XDomainRequest, веб-серверу направляется запрос, в заголовке которого присутствует поле

XDomainRequest: 1

При получении подобного запроса, сервер обязательно должен установить поле заголовка ответа

XDomainRequestAllowed: 1

Иначе пользователь получит сообщение об ошибке! Ниже пример рабочего скрипта PHP, с помощью которого вы всегда можете проверить работоспособность своего детища. Для тестирования вы также можете воспользоваться страницей, постоянно расположеной по адресу http://www.landgraph.ru/test/test_xdr.php.

<?php
// Если к нам приходит запрос от XDomainRequest

if ($_SERVER['HTTP_XDOMAINREQUEST']=='1') {
	// Отвечаем клиенту, что мы поддерживаем XDomainRequest
	header('XDomainRequestAllowed: 1');
	echo "XDomainRequest works!"; 
	}
else {
	// Если страница запрошена не через XDomainRequest
	echo "XDomainRequest dont work!";
	}
?>

Ограничения

Как и везде, из соображений безопасности, есть ограничения. При использовании XDomainRequest протокол страницы, с которой идет запрос, и протокол загружаемой страницы должны быть идентичны. Другими словами, если вы открываете сохраненный на вашем локальном компьютере документ, то его протокол - file://, а внутри документа есть запрос к странице в Интернете по протоколу http://, то этот запрос не будет выполнен.

Следующая таблица показывает, какие возможны комбинации страниц, с которых разрешен доступ с помощью интерфейса XDomainRequest в другие зоны безопасности.

Откуда \ КудаЛокальноИнтранетДоверенный
(Интранет)
Доверенный
(Интернет)
ИнтернетОграниченный
ЛокальноРазрешеноРазрешеноРазрешеноРазрешеноРазрешеноЗапрещено
ИнтранетЗапрещеноРазрешеноРазрешеноРазрешеноРазрешеноЗапрещено
Доверенный
(Интранет)
ЗапрещеноРазрешеноРазрешеноРазрешеноРазрешеноЗапрещено
Доверенный
(Интернет)
ЗапрещеноЗапрещеноЗапрещеноРазрешеноРазрешеноЗапрещено
ИнтернетЗапрещеноЗапрещеноЗапрещеноРазрешеноРазрешеноЗапрещено
ОграниченныйЗапрещеноЗапрещеноЗапрещеноЗапрещеноЗапрещеноЗапрещено

Из таблицы видно, что страницы, расположенные локально (http://localhost/) имеют выход на все узлы, кроме ограниченных политикой безопасности. Как видите, через Интернет могут взаимодействовать любые узлы, кроме ограниченных текущей политикой безопасности.

Оставить комментарий

Комментарий:
можно использовать BB-коды
Максимальная длина комментария - 4000 символов.
 
Реклама на сайте | Обмен ссылками | Ссылки | Экспорт (RSS) | Контакты
Добавить статью | Добавить исходник | Добавить хостинг-провайдера | Добавить сайт в каталог