Пакет | flash.net |
Класс | public final class URLRequestHeader |
Наследование | URLRequestHeader Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
requestHeaders
класса URLRequest.
В Adobe® AIR® содержимое в изолированной программной среде безопасности приложения (содержимое, установленное с приложением AIR) может использовать любые заголовки запросов, не вызывая ошибки. Однако в случае с содержимым, выполняющимся в Adobe AIR и находящимся в другой изолированной программной среде безопасности, или в случае с содержимым, выполняющимся в проигрывателе Flash® Player, использование следующих заголовков запросов приводит к ошибке времени выполнения, причем запрещенные термины не зависят от регистра (например, варианты Get
, get
и GET
в равной степени недопустимы):
В содержимом Flash Player и Adobe AIR за пределами изолированной программной среды безопасности приложения нельзя использовать следующие заголовки запросов, причем запрещенные термины не зависят от регистра (например, варианты Get
, get
и GET
в равной степени недопустимы). Вдобавок, написанные через дефис термины применяются, если используется символ подчеркивания (например, Content-Length
и Content_Length
недопустимы):
Accept-Charset
, Accept-Encoding
, Accept-Ranges
, Age
, Allow
, Allowed
, Authorization
, Charge-To
, Connect
, Connection
, Content-Length
, Content-Location
, Content-Range
, Cookie
, Date
, Delete
, ETag
, Expect
, Get
, Head
, Host
, If-Modified-Since
, Keep-Alive
, Last-Modified
, Location
, Max-Forwards
, Options
, Origin
, Post
, Proxy-Authenticate
, Proxy-Authorization
, Proxy-Connection
, Public
, Put
, Range
, Referer
, Request-Range
, Retry-After
, Server
, TE
, Trace
, Trailer
, Transfer-Encoding
, Upgrade
, URI
, User-Agent
, Vary
, Via
, Warning
, WWW-Authenticate
, x-flash-version
.
Объекты URLRequestHeader имеют ограниченную длину. Если суммарная длина объекта URLRequestHeader (длина свойства name
плюс свойства value
) или массива объектов URLRequestHeader, использованных в свойстве URLRequest.requestHeaders
, превышает допустимую длину, выдается исключение.
Содержимое, выполняющееся в Adobe AIR, задает для заголовка ACCEPT
следующее значение, если для заголовка ACCEPT
в свойстве requestHeaders
класса URLRequest не задано значение:
text/xml, application/xml, application/xhtml+xml, text/html;q=0.9, text/plain;q=0.8, image/png, application/x-shockwave-flash, video/mp4;q=0.9, flv-application/octet-stream;q=0.8, video/x-flv;q=0.7, audio/mp4, */*;q=0.5
Не все методы, принимающие параметры URLRequest, поддерживают свойство requestHeaders
. Дополнительные сведения см. в описании вызываемого метода. Например, методы FileReference.upload()
и FileReference.download()
не поддерживают свойство URLRequest.requestHeaders
.
Вследствие ограниченных возможностей обозревателей пользовательские заголовки запросов НТТР поддерживаются только для запросов POST
, а для GET
не поддерживаются.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
name : String
Имя заголовка HTTP-запроса (например, Content-Type или SOAPAction). | URLRequestHeader | ||
value : String
Значение, связанное со свойством name (например, text/plain). | URLRequestHeader |
Метод | Определено | ||
---|---|---|---|
Создает новый объект URLRequestHeader, инкапсулирующий одиночный заголовок запроса HTTP. | URLRequestHeader | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object |
name | свойство |
public var name:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Имя заголовка HTTP-запроса (например, Content-Type
или SOAPAction
).
value | свойство |
public var value:String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Значение, связанное со свойством name
(например, text/plain
).
URLRequestHeader | () | Конструктор |
public function URLRequestHeader(name:String = "", value:String = "")
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Создает новый объект URLRequestHeader, инкапсулирующий одиночный заголовок запроса HTTP. Объекты URLRequestHeader используются в свойстве requestHeaders
класса URLRequest.
name:String (default = " ") — Имя заголовка HTTP-запроса (например, Content-Type или SOAPAction ).
| |
value:String (default = " ") — Значение, связанное со свойством name (например, text/plain ).
|
header
добавляется в массив для свойства requestHeaders
. Заголовок указывает, что приложение должно переправить запрос на исходный сервер, даже если оно имеет кэшированную копию запрашиваемого объекта.
package { import flash.display.Sprite; import flash.events.*; import flash.net.URLLoader; import flash.net.URLRequest; import flash.net.URLRequestHeader; import flash.net.URLRequestMethod; import flash.net.URLVariables; public class URLRequestHeaderExample extends Sprite { private var loader:URLLoader; public function URLRequestHeaderExample() { loader = new URLLoader(); configureListeners(loader); var header:URLRequestHeader = new URLRequestHeader("pragma", "no-cache"); var request:URLRequest = new URLRequest("http://www.[yourdomain].com/greeting.cfm"); request.data = new URLVariables("name=John+Doe"); request.method = URLRequestMethod.POST; request.requestHeaders.push(header); try { loader.load(request); } catch (error:Error) { trace("Unable to load requested document."); } } private function configureListeners(dispatcher:IEventDispatcher):void { dispatcher.addEventListener(Event.COMPLETE, completeHandler); dispatcher.addEventListener(Event.OPEN, openHandler); dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler); dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler); dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler); } private function completeHandler(event:Event):void { var loader:URLLoader = URLLoader(event.target); trace("completeHandler: " + loader.data); } private function openHandler(event:Event):void { trace("openHandler: " + event); } private function progressHandler(event:ProgressEvent):void { trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function httpStatusHandler(event:HTTPStatusEvent):void { trace("httpStatusHandler: " + event); } private function ioErrorHandler(event:IOErrorEvent):void { trace("ioErrorHandler: " + event); } } }
Tue Jun 12 2018, 11:34 AM Z