패키지flash.net
클래스public final class URLRequestHeader
상속URLRequestHeader Inheritance Object

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

URLRequestHeader 객체는 단일 HTTP 요청 헤더를 캡슐화하며 이름/값 쌍으로 구성됩니다. URLRequestHeader 객체는 URLRequest 클래스의 requestHeaders 속성에 사용됩니다.

Adobe® AIR에서 응용 프로그램 보안 샌드박스의 내용(예: AIR 응용 프로그램과 함께 설치된 내용)은 오류 없이 모든 요청 헤더를 사용할 수 있습니다. 그러나 다른 보안 샌드박스에 있는 Adobe AIR에서 실행 중인 내용 다음 요청 헤더를 사용하면 런타임 오류가 발생하며 제한된 용어가 대/소문자를 구분하지 않습니다(예: Get, getGET은 모두 허용되지 않음).

응용 프로그램 보안 샌드박스의 외부에 있는 Flash Player 및 Adobe AIR 내용에는 다음 요청 헤더를 사용할 수 없으며 제한된 용어가 대/소문자를 구분하지 않습니다(예: Get, getGET은 모두 허용되지 않음). 또한, 하이픈이 있는 용어는 밑줄이 사용될 경우에 적용합니다(예: Content-LengthContent_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, Keep-Alive, Last-Modified, Location, Max-Forwards, Options, 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 요청에는 지원되지 않습니다.

예제 보기

참고 사항

URLRequest
URLLoader


Public 속성
 속성다음에 의해 정의됨
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  name : String
HTTP 요청 헤더 이름(예: Content-Type 또는 SOAPAction)입니다.
URLRequestHeader
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  value : String
name 속성과 연관된 값(예: text/plain)입니다.
URLRequestHeader
Public 메서드
 메서드다음에 의해 정의됨
  
URLRequestHeader(name:String = "", value:String = "")
단일 HTTP 요청 헤더를 캡슐화하는 새 URLRequestHeader 객체를 만듭니다.
URLRequestHeader
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
속성 정보
name속성
public var name:String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

HTTP 요청 헤더 이름(예: Content-Type 또는 SOAPAction)입니다.

value속성 
public var value:String

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

name 속성과 연관된 값(예: text/plain)입니다.

생성자 정보
URLRequestHeader()생성자
public function URLRequestHeader(name:String = "", value:String = "")

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

단일 HTTP 요청 헤더를 캡슐화하는 새 URLRequestHeader 객체를 만듭니다. URLRequestHeader 객체는 URLRequest 클래스의 requestHeaders 속성에 사용됩니다.

매개 변수
name:String (default = "") — HTTP 요청 헤더 이름(예: Content-Type 또는 SOAPAction)입니다.
 
value:String (default = "")name 속성과 연관된 값(예: text/plain)입니다.
예제 예제 사용 방법
URLRequestHeaderExample.as

다음 예제에서는 단일 HTTP 요청 헤더 headerrequestHeaders 속성의 배열에 추가합니다. 헤더는 요청 중인 내용의 캐시된 사본이 있더라도 응용 프로그램이 원본 서버에 요청을 전달해야 함을 나타냅니다.
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 {
        public function URLRequestHeaderExample() {
            var loader:URLLoader = 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);
        }
    }
}