Во многих API-интерфейсах, загружающих внешние данные, класс URLRequest используется для определения свойств необходимого сетевого запроса.
Свойства URLRequest
В изолированной программной среде можно задать следующие свойства объекта URLRequest:
| Свойство | Описание |
| contentType | MIME-тип содержимого, передаваемого с запросом URL. Если объект contentType не задан, значения отправляются в виде application/x-www-form-urlencoded. |
| с | Объект, содержащий данные, которые должны быть переданы с запросом URL. |
| digest | Строка, уникальным образом идентифицирующая подписанный компонент платформы Adobe, который должен быть сохранен (или извлечен) в кэш-памяти проигрывателя Adobe® Flash® Player. |
| method | Метод запроса HTTP, например GET или POST. (Содержимое, выполняющееся в домене безопасности приложения AIR, может указывать строки, отличные от "GET" или "POST", в качестве свойства method. Допускается использование любого глагола HTTP, а по умолчанию используется метод "GET". |
| requestHeaders | Массив заголовков запроса HTTP, который должен быть добавлен к запросу HTTP. Обратите внимание, что права на задание некоторых заголовков ограничены в проигрывателе Flash Player, а также в содержимом AIR, выполняемом за пределами изолированной программной среды приложения. |
| url | Задает запрашиваемый URL-адрес. |
В среде AIR можно задать дополнительные свойства класса URLRequest, которые доступны только для содержимого AIR, выполняемого в изолированной программной среде приложения. Содержимое в изолированной программной среде приложения может также определять URL-адреса при помощи новых схем URL-адресов (в дополнение к таким стандартным схемам, как file и http).
| Свойство | Описание | |
| followRedirects | Указывает, выполнять переход по указанному перенаправлению (true, значение по умолчанию) или нет (false). Эта возможность поддерживается только в изолированной программной среде AIR. | |
| manageCookies | Указывает, должен стек протокола HTTP управлять файлами cookie этого запроса (true, значение по умолчанию) или нет (false). Настройка этого свойства поддерживается только в изолированной программной среде AIR. | |
| authenticate | Указывает, должны ли обрабатываться запросы на проверку подлинности (true) данного запроса. Настройка этого свойства поддерживается только в изолированной программной среде AIR. По умолчанию проверка подлинности запросов выполняется — при этом может открыться диалоговое окно проверки подлинности, если для сервера необходимо указать учетные данные. Можно также задать имя пользователя и пароль с использованием класса URLRequestDefaults | |
| cacheResponse | Указывает, должны ли сохраняться в кэше данные ответа на этот запрос. Настройка этого свойства поддерживается только в изолированной программной среде AIR. По умолчанию ответ кэшируется (true). | |
| useCache | Указывает, следует ли обращаться к локальному кэшу перед выборкой данных этим URLRequest. Настройка этого свойства поддерживается только в изолированной программной среде AIR. По умолчанию (значение true) используется локальная кэшированная версия, если таковая имеется. | |
| userAgent | Указывает строку агента пользователя, используемую в запросе HTTP. |
Примечание. Класс HTMLLoader имеет связанные свойства для настроек, относящихся к содержимому, загружаемому объектом HTMLLoader.
Схемы URI
Стандартные схемы URI, например описанную ниже, можно использовать в запросах, выполняемых из любой изолированной программной среды:
http: и https:
Используйте их для стандартных URL-адресов Интернета (так же, как они используются в веб-браузере).
file:
Используйте схему file: для указания URL-адреса файла, находящегося в локальной файловой системе. Например:
file:///c:/AIR Test/test.txt
В среде AIR можно также использовать следующие схемы при определении URL-адреса для содержимого, выполняющегося в изолированной программной среде приложения:
app:
Используйте схему app:, чтобы указать путь относительно корневого каталога установленного приложения. Например, следующий путь указывает на каталог ресурсов, вложенный в каталог установленного приложения.
app:/resources
app-storage:
Используйте схему app-storage:, чтобы указать путь относительно каталога системы хранения данных приложения. Для каждого установленного приложения (и пользователя) среда AIR создает уникальный каталог хранилища приложения, в котором сохраняются все данные, относящиеся к этому приложению. Например, следующий путь указывает на файл prefs.xml в подкаталоге параметров каталога хранилища приложения:
app-storage:/settings/prefs.xml
Адрес получателя mailto:
Можно использовать схему mailto с указанием адреса получателя в объектах URLRequest, переданных функции navigateToURL().