(Только AIR)
Пакетflash.net
Классpublic class URLRequestDefaults
НаследованиеURLRequestDefaults Inheritance Object

Версии среды выполнения: AIR 1.0

Класс URLRequestDefaults включает в себя статические свойства, настройка которых позволяет определить значения по умолчанию для свойств класса URLRequest. Оно также включает в себя статический метод URLRequestDefaults.setLoginCredentialsForHost(), позволяющий определить используемые по умолчанию учетные данные для аутентификации запросов. Класс URLRequest определяет информацию, используемую в запросе HTTP.

Любые свойства, установленные в объекте URLRequest, заменяют упомянутые статические свойства для класса URLRequestDefaults.

Параметры URLRequestDefault применяются только к содержимому в домене приложения вызывающего абонента за одним исключением: параметры, установленные путем вызова URLRequestDefaults.setLoginCredentialsForHost(), применяются в отношении всех доменов приложений в рамках запущенного в данный момент приложения.

Класс URLRequestDefaults может быть использован только содержимым Adobe® AIR, запущенным в изолированной программной среде приложения. Другое содержимое приведет к ошибке SecurityError, появляющейся при обращении к членам или свойствам данного класса.

См. также

URLRequest


Общедоступные свойства
 СвойствоОпределено
  AIR-only authenticate : Boolean
[статические] Параметр по умолчанию для свойства authenticate объектов URLRequest.
URLRequestDefaults
  AIR-only cacheResponse : Boolean
[статические] Параметр по умолчанию для свойства cacheResponse объектов URLRequest.
URLRequestDefaults
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only followRedirects : Boolean
[статические] Параметр по умолчанию для свойства followRedirects объектов URLRequest.
URLRequestDefaults
  AIR-only manageCookies : Boolean
[статические] Параметр по умолчанию для свойства manageCookies объектов URLRequest.
URLRequestDefaults
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  AIR-only useCache : Boolean
[статические] Параметр по умолчанию для свойства useCache объектов URLRequest.
URLRequestDefaults
  AIR-only userAgent : String
[статические] Параметр по умолчанию для свойства userAgent объектов URLRequest.
URLRequestDefaults
Общедоступные методы
 МетодОпределено
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
AIR-only setLoginCredentialsForHost(hostname:String, user:String, password:String):*
[статические] Задает используемые по умолчанию имя пользователя и пароль для указанного узла.
URLRequestDefaults
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве
AIR-only authenticateсвойство
authenticate:Boolean  [чтение и запись]

Версии среды выполнения: AIR 1.0

Параметр по умолчанию для свойства authenticate объектов URLRequest. Установка свойства authenticate в объекте URLRequest заменяет указанный параметр по умолчанию.

Примечание. Данный параметр не применяется в отношении объектов URLRequest, используемых при отправке файлов или в RTMP-запросах.

Значение по умолчанию true


Реализация
    public static function get authenticate():Boolean
    public function set authenticate(value:Boolean):void

Выдает
SecurityError — Вызывающий абонент не находится в изолированной программной среде AIR.

См. также

AIR-only cacheResponseсвойство 
cacheResponse:Boolean  [чтение и запись]

Версии среды выполнения: AIR 1.0

Параметр по умолчанию для свойства cacheResponse объектов URLRequest. Установка свойства cacheResponse в объекте URLRequest заменяет указанный параметр по умолчанию. Если установлено значение true, по умолчанию приложение AIR использует кэш-память HTTP операционной системы. Данный параметр не применяется в отношении объектов URLRequest, используемых при отправке файлов или в RTMP-запросах.

Значение по умолчанию true


Реализация
    public static function get cacheResponse():Boolean
    public function set cacheResponse(value:Boolean):void

Выдает
SecurityError — Вызывающий абонент не находится в изолированной программной среде AIR.

См. также

AIR-only followRedirectsсвойство 
followRedirects:Boolean  [чтение и запись]

Версии среды выполнения: AIR 1.0

Параметр по умолчанию для свойства followRedirects объектов URLRequest. Установка свойства followRedirects в объекте URLRequest заменяет указанный параметр по умолчанию. Данный параметр не применяется в отношении объектов URLRequest, используемых при отправке файлов или в RTMP-запросах.

Значение по умолчанию true


Реализация
    public static function get followRedirects():Boolean
    public function set followRedirects(value:Boolean):void

Выдает
SecurityError — Вызывающий абонент не находится в изолированной программной среде AIR.

См. также

AIR-only manageCookiesсвойство 
manageCookies:Boolean  [чтение и запись]

Версии среды выполнения: AIR 1.0

Параметр по умолчанию для свойства manageCookies объектов URLRequest. Установка свойства manageCookies в объекте URLRequest заменяет указанный параметр по умолчанию.

Примечание. Данный параметр не применяется в отношении объектов URLRequest, используемых при отправке файлов или в RTMP-запросах.

Значение по умолчанию true


Реализация
    public static function get manageCookies():Boolean
    public function set manageCookies(value:Boolean):void

Выдает
SecurityError — Вызывающий абонент не находится в изолированной программной среде AIR.

См. также

AIR-only useCacheсвойство 
useCache:Boolean  [чтение и запись]

Версии среды выполнения: AIR 1.0

Параметр по умолчанию для свойства useCache объектов URLRequest. Установка свойства useCache в объекте URLRequest заменяет указанный параметр по умолчанию. Данный параметр не применяется в отношении объектов URLRequest, используемых при отправке файлов или в RTMP-запросах.

Значение по умолчанию true


Реализация
    public static function get useCache():Boolean
    public function set useCache(value:Boolean):void

Выдает
SecurityError — Вызывающий абонент не находится в изолированной программной среде AIR.

См. также

AIR-only userAgentсвойство 
userAgent:String  [чтение и запись]

Версии среды выполнения: AIR 1.0

Параметр по умолчанию для свойства userAgent объектов URLRequest. Установка свойства userAgent в объекте URLRequest заменяет указанный параметр по умолчанию.

Это также является используемой по умолчанию строкой агента пользователя для всех объектов HTMLLoader (применяется при вызове метода load() объекта HTMLLoader). Установка свойства userAgent объекта HTMLLoader перезаписывает параметр URLRequestDefaults.userAgent.

Это значение по умолчанию зависит от конечной операционной системы (Mac OS или Windows), языка и версии, как указано в двух следующих примерах:


Реализация
    public static function get userAgent():String
    public function set userAgent(value:String):void

Выдает
SecurityError — Вызывающий абонент не находится в изолированной программной среде AIR.

См. также

Сведения о методе
AIR-only setLoginCredentialsForHost()метод
public static function setLoginCredentialsForHost(hostname:String, user:String, password:String):*

Версии среды выполнения: AIR 1.0

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

Примечание для приложений, запущенных в операционной системе Mac OS. При вызове этого метода в системе Mac OS приложение применяет рассматриваемые учетные данные для указанного узла до тех пор, пока приложение не будет закрыто, даже если позднее для этого же узла будет вызван метод URLRequestDefaults.setLoginCredentialsForHost(). Тем не менее, если сервер отклонит учетную запись, указанную данным методом, то последующий вызов метода URLRequestDefaults.setLoginCredentialsForHost() (для того же самого узла) будет распознан.

Примечание. Данный метод не применяется в отношении объектов URLRequest, используемых при отправке файлов или в RTMP-запросах.

Параметры

hostname:String — Имя узла, к которому применяется имя пользователя и пароль. Это может быть просто домен, например www.example.com, или домен и номер порта, например www.example.com:80. Обратите внимание на то, что example.com, www.example.com и sales.example.com рассматриваются как уникальные узлы.
 
user:String — Имя пользователя по умолчанию, используемое при аутентификации запроса для указанного узла.
 
password:String — Пароль по умолчанию, используемый при аутентификации запроса для указанного узла.

Возвращает
*

Выдает
SecurityError — Вызывающий абонент не находится в изолированной программной среде AIR.