패키지flash.events
클래스public class HTTPStatusEvent
상속HTTPStatusEvent Inheritance Event Inheritance Object

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

네트워크 요청으로 HTTP 상태 코드가 반환되면 응용 프로그램이 HTTPStatusEvent 객체를 전달합니다.

오류 또는 완료 이벤트를 보낼 때에는 항상 HTTPStatusEvent 객체가 그에 앞서 보내집니다. HTTPStatusEvent 객체는 오류 상황을 나타내지 않을 수도 있으며 단순히 네트워킹 스택에서 제공된 HTTP 상태 코드(있는 경우)를 반영합니다. 일부 Flash Player 환경에서는 HTTP 상태 코드를 감지하지 못할 수 있고 이 경우 항상 상태 코드 0이 보고됩니다.

Flash Player에서 HTTPStatus 이벤트 유형은 httpStatus 한 가지 뿐입니다. AIR 런타임에서 FileReference, URLLoader 또는 URLStream은 responseURLresponseHeaders 속성이 포함된 httpResponseStatus를 수신하도록 등록할 수 있습니다. 이러한 속성은 httpStatus 이벤트에 정의되어 있지 않습니다.

예제 보기



Public 속성
 속성다음에 의해 정의됨
 Inheritedbubbles : Boolean
[읽기 전용] 이벤트가 버블링 이벤트인지 여부를 나타냅니다.
Event
 Inheritedcancelable : Boolean
[읽기 전용] 해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다.
Event
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
 InheritedcurrentTarget : Object
[읽기 전용] 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
Event
 InheritedeventPhase : uint
[읽기 전용] 이벤트 흐름에서 현재 단계입니다.
Event
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
  AIR-only responseHeaders : Array
URLRequestHeader 객체의 배열로 응답이 반환된 응답 헤더입니다.
HTTPStatusEvent
  AIR-only responseURL : String
응답이 반환된 URL입니다.
HTTPStatusEvent
  status : int
[읽기 전용] 서버에 의해 반환된 HTTP 상태 코드입니다.
HTTPStatusEvent
 Inheritedtarget : Object
[읽기 전용] 이벤트 대상입니다.
Event
 Inheritedtype : String
[읽기 전용] 이벤트 유형입니다.
Event
Public 메서드
 메서드다음에 의해 정의됨
  
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)
HTTP 상태 이벤트에 대한 특정 정보가 포함된 Event 객체를 만듭니다.
HTTPStatusEvent
  
HTTPStatusEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.
HTTPStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.
Event
 Inherited
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다.
Event
 Inherited
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.
Event
 Inherited
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
 Inherited
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.
Event
  
HTTPStatusEvent 객체의 속성이 모두 포함된 문자열을 반환합니다.
HTTPStatusEvent
 Inherited
지정된 객체의 프리미티브 값을 반환합니다.
Object
Public 상수
 상수다음에 의해 정의됨
 InheritedACTIVATE : String = "activate"
[정적] ACTIVATE 상수는 activate 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedADDED : String = "added"
[정적] Event.ADDED 상수는 added 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[정적] Event.ADDED_TO_STAGE 상수는 addedToStage 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCANCEL : String = "cancel"
[정적] Event.CANCEL 상수는 cancel 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCHANGE : String = "change"
[정적] Event.CHANGE 상수는 change 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCLEAR : String = "clear"
[정적] Event.CLEAR 상수는 clear 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCLOSE : String = "close"
[정적] Event.CLOSE 상수는 close 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only CLOSING : String = "closing"
[정적] Event.CLOSING 상수는 closing 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCOMPLETE : String = "complete"
[정적] Event.COMPLETE 상수는 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCONNECT : String = "connect"
[정적] Event.CONNECT 상수는 connect 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCOPY : String = "copy"
[정적] copy 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedCUT : String = "cut"
[정적] cut 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedDEACTIVATE : String = "deactivate"
[정적] Event.DEACTIVATE 상수는 deactivate 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedDISPLAYING : String = "displaying"
[정적] Event.DISPLAYING 상수는 displaying 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[정적] Event.ENTER_FRAME 상수는 enterFrame 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[정적] Event.EXIT_FRAME 상수는 exitFrame 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only EXITING : String = "exiting"
[정적] Event.EXITING 상수는 exiting 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[정적] Event.FRAME_CONSTRUCTED 상수는 frameConstructed 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[정적] Event.FULL_SCREEN 상수는 fullScreen 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[정적] Event.HTML_BOUNDS_CHANGE 상수는 htmlBoundsChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[정적] Event.HTML_DOM_INITIALIZE 상수는 htmlDOMInitialize 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[정적] Event.HTML_RENDER 상수는 htmlRender 이벤트 객체의 type 속성 값을 정의합니다.
Event
  AIR-only HTTP_RESPONSE_STATUS : String = "httpResponseStatus"
[정적] httpStatus 이벤트와는 달리, httpResponseStatus 이벤트는 응답 데이터 이전에 전달됩니다.
HTTPStatusEvent
  HTTP_STATUS : String = "httpStatus"
[정적] HTTPStatusEvent.HTTP_STATUS 상수는 httpStatus 이벤트 객체의 type 속성 값을 정의합니다.
HTTPStatusEvent
 InheritedID3 : String = "id3"
[정적] Event.ID3 상수는 id3 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedINIT : String = "init"
[정적] Event.INIT 상수는 init 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[정적] Event.LOCATION_CHANGE 상수는 locationChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[정적] Event.MOUSE_LEAVE 상수는 mouseLeave 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[정적] Event.NETWORK_CHANGE 상수는 networkChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedOPEN : String = "open"
[정적] Event.OPEN 상수는 open 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedPASTE : String = "paste"
[정적] Event.PASTE 상수는 paste 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedREMOVED : String = "removed"
[정적] Event.REMOVED 상수는 removed 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[정적] Event.REMOVED_FROM_STAGE 상수는 removedFromStage 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedRENDER : String = "render"
[정적] Event.RENDER 상수는 render 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedRESIZE : String = "resize"
[정적] Event.RESIZE 상수는 resize 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSCROLL : String = "scroll"
[정적] Event.SCROLL 상수는 scroll 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSELECT : String = "select"
[정적] Event.SELECT 상수는 select 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSELECT_ALL : String = "selectAll"
[정적] Event.SELECT_ALL 상수는 selectAll 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[정적] Event.SOUND_COMPLETE 상수는 soundComplete 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[정적] Event.TAB_CHILDREN_CHANGE 상수는 tabChildrenChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[정적] Event.TAB_ENABLED_CHANGE 상수는 tabEnabledChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[정적] Event.TAB_INDEX_CHANGE 상수는 tabIndexChange 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedUNLOAD : String = "unload"
[정적] Event.UNLOAD 상수는 unload 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[정적] Event.USER_IDLE 상수는 userIdle 이벤트 객체의 type 속성 값을 정의합니다.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[정적] Event.USER_PRESENT 상수는 userPresent 이벤트 객체의 type 속성 값을 정의합니다.
Event
속성 정보
AIR-only responseHeaders속성
responseHeaders:Array  [읽기/쓰기]

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

URLRequestHeader 객체의 배열로 응답이 반환된 응답 헤더입니다.



구현
    public function get responseHeaders():Array
    public function set responseHeaders(value:Array):void

참고 사항

AIR-only responseURL속성 
responseURL:String  [읽기/쓰기]

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

응답이 반환된 URL입니다. 리디렉션의 경우 요청 URL과 다릅니다.



구현
    public function get responseURL():String
    public function set responseURL(value:String):void
status속성 
status:int  [읽기 전용]

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

서버에 의해 반환된 HTTP 상태 코드입니다. 예를 들어, 값 404는 서버에서 요청된 URL과 일치하는 내용을 찾지 못했음을 나타냅니다. HTTP 상태 코드는 ftp://ftp.isi.edu/in-notes/rfc2616.txt에 있는 HTTP 사양의 10.4 및 10.5 단원에서 확인할 수 있습니다.

Flash Player 또는 AIR이 서버에서 상태 코드를 가져올 수 없거나 서버와 통신할 수 없는 경우 코드에 기본값 0이 전달됩니다. 0 값은 모든 플레이어에서 생성될 수 있으며(예: 잘못된 URL이 요청된 경우), 플레이어에 HTTP 상태 코드를 전달하지 않는 브라우저(Netscape, Mozilla, Safari, Opera 및 Macintosh용 Internet Explorer)에서 Flash Player 플러그인이 실행될 때 항상 0 값이 생성됩니다.



구현
    public function get status():int
생성자 정보
HTTPStatusEvent()생성자
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)

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

HTTP 상태 이벤트에 대한 특정 정보가 포함된 Event 객체를 만듭니다. Event 객체는 매개 변수로 이벤트 리스너에 전달됩니다.

매개 변수
type:String — 이벤트 유형입니다. 이벤트 리스너는 상속된 type 속성을 통해 이 정보에 액세스할 수 있습니다. HTTPStatus 이벤트 유형은 HTTPStatusEvent.HTTP_STATUS 한 가지뿐입니다.
 
bubbles:Boolean (default = false) — Event 객체가 이벤트 흐름의 버블링 단계에 참여하는지 여부를 결정합니다. 이벤트 리스너는 상속된 bubbles 속성을 통해 이 정보에 액세스할 수 있습니다.
 
cancelable:Boolean (default = false) — Event 객체를 취소할 수 있는지 여부를 결정합니다. 이벤트 리스너는 상속된 cancelable 속성을 통해 이 정보에 액세스할 수 있습니다.
 
status:int (default = 0) — 숫자 형식의 상태입니다. 이벤트 리스너는 status 속성을 통해 이 정보에 액세스할 수 있습니다.

참고 사항

메서드 정보
clone()메서드
override public function clone():Event

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

HTTPStatusEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다.

반환값
Event — 원본과 동일한 속성 값을 갖는 새 HTTPStatusEvent 객체입니다.
toString()메서드 
override public function toString():String

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

HTTPStatusEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. 문자열의 형식은 다음과 같습니다.

[HTTPStatusEvent type=value bubbles=value cancelable=value status=value ]

반환값
String — HTTPStatusEvent 객체의 속성이 모두 포함된 문자열입니다.
상수 정보
AIR-only HTTP_RESPONSE_STATUS상수
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"

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

httpStatus 이벤트와는 달리, httpResponseStatus 이벤트는 응답 데이터 이전에 전달됩니다. 또한 httpResponseStatus 이벤트에는 responseHeadersresponseURL 속성(httpStatus 이벤트에 대해 정의되어 있지 않음) 값이 포함되어 있습니다. httpResponseStatus 이벤트(있는 경우)는 complete 또는 error 이벤트 발생 전에 추가로 전송됩니다.

HTTPStatusEvent.HTTP_RESPONSE_STATUS 상수는 httpResponseStatus 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
responseURL 응답이 반환된 URL입니다.
responseHeaders URLRequestHeader 객체의 배열로 응답이 반환된 응답 헤더입니다.
status 서버에 의해 반환된 HTTP 상태 코드입니다.
target HTTP 상태 코드를 수신하는 네트워크 객체입니다.

참고 사항

HTTP_STATUS상수 
public static const HTTP_STATUS:String = "httpStatus"

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

HTTPStatusEvent.HTTP_STATUS 상수는 httpStatus 이벤트 객체의 type 속성 값을 정의합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

속성
bubbles false
cancelable false; 취소할 기본 비헤이비어가 없습니다.
currentTarget 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
status 서버에 의해 반환된 HTTP 상태 코드입니다.
target HTTP 상태 코드를 수신하는 네트워크 객체입니다.

참고 사항

예제 예제 사용 방법
HTTPStatusEventExample.as

다음 예제에서는 http://www.[yourDomain].com의 루트 웹 디렉토리에서 존재하지 않는 파일을 로드하려고 시도합니다. 그러면 해당 파일을 찾을 수 없음을 나타내는 상태 코드 404의 httpStatusHandler 이벤트가 전달됩니다. httpStatusHandler 이벤트는 httpStatusHandler()에 의해 처리되며, 이벤트에 대한 정보가 두 줄로 출력됩니다.

참고:

  1. 이 예제에서 securityError 이벤트를 생성하려면 "로컬 재생 보안"을 "네트워크만 액세스"로 설정하여 SWF 파일을 컴파일해야 합니다.
  2. http://www.[yourDomain].com에서 실행 중이며 포트 80에서 수신하는 서버가 필요하며, 그렇지 않은 경우에는 상태 코드가 404가 아니라 0인 httpStatusHandler 이벤트가 수신됩니다.
  3. http://www.[yourDomain].com의 루트 웹 디렉토리에 MissingFile.html이라는 파일이 있으면 안 됩니다. 이 파일이 있으면 httpStatusHandler 이벤트가 올바르게 수신되지 않습니다.

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.HTTPStatusEvent;

    public class HTTPStatusEventExample extends Sprite {

        public function HTTPStatusEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);

            var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html");
            loader.load(request);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
            trace("status: " + event.status);
        }
    }
}