패키지 | flash.net |
클래스 | public final class URLRequestHeader |
상속 | URLRequestHeader Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
requestHeaders
속성에 사용됩니다.
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
속성을 더한 길이) 또는 URLRequest.requestHeaders
속성에서 사용되는 URLRequestHeader 객체의 배열이 허용 가능한 길이를 초과하는 경우 예외가 발생합니다.
URLRequest 클래스의 requestHeaders
속성에서 ACCEPT
헤더의 설정을 지정하지 않으면 Adobe AIR에서 실행 중인 내용은 ACCEPT
헤더를 다음으로 설정합니다.
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
속성을 지원하지 않습니다.
브라우저의 제한 사항으로 인해 사용자 정의 HTTP 요청은 POST
요청에만 지원되며 GET
요청에는 지원되지 않습니다.
관련 API 요소
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
name : String
HTTP 요청 헤더 이름(예: Content-Type 또는 SOAPAction)입니다. | URLRequestHeader | ||
value : String
name 속성과 연관된 값(예: text/plain)입니다. | URLRequestHeader |
메서드 | 정의 주체 | ||
---|---|---|---|
단일 HTTP 요청 헤더를 캡슐화하는 새 URLRequestHeader 객체를 만듭니다. | 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 |
단일 HTTP 요청 헤더를 캡슐화하는 새 URLRequestHeader 객체를 만듭니다. URLRequestHeader 객체는 URLRequest 클래스의 requestHeaders
속성에 사용됩니다.
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, 03:17 PM Z