패키지 | flash.events |
클래스 | public class HTTPStatusEvent |
상속 | HTTPStatusEvent Event Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
오류 또는 완료 이벤트를 보낼 때에는 항상 HTTPStatusEvent 객체가 그에 앞서 보내집니다. HTTPStatusEvent 객체는 오류 상황을 나타내지 않을 수도 있으며 단순히 네트워킹 스택에서 제공된 HTTP 상태 코드(있는 경우)를 반영합니다. 일부 Flash Player 환경에서는 HTTP 상태 코드를 감지하지 못할 수 있고 이 경우 항상 상태 코드 0이 보고됩니다.
Flash Player에서 HTTPStatus 이벤트 유형은 httpStatus
한 가지 뿐입니다. AIR 런타임에서 FileReference, URLLoader 또는 URLStream은 responseURL
및 responseHeaders
속성이 포함된 httpResponseStatus
를 수신하도록 등록할 수 있습니다. 이러한 속성은 httpStatus
이벤트에 정의되어 있지 않습니다.
속성 | 정의 주체 | ||
---|---|---|---|
bubbles : Boolean [읽기 전용]
이벤트가 버블링 이벤트인지 여부를 나타냅니다. | Event | ||
cancelable : Boolean [읽기 전용]
해당 이벤트와 연관된 비헤이비어를 차단할 수 있는지 여부를 나타냅니다. | Event | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
currentTarget : Object [읽기 전용]
이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. | Event | ||
eventPhase : uint [읽기 전용]
이벤트 흐름에서 현재 단계입니다. | Event | ||
redirected : Boolean
요청이 리디렉션되었는지 여부를 나타냅니다. | HTTPStatusEvent | ||
responseHeaders : Array
URLRequestHeader 객체의 배열로 응답이 반환된 응답 헤더입니다. | HTTPStatusEvent | ||
responseURL : String
응답이 반환된 URL입니다. | HTTPStatusEvent | ||
status : int [읽기 전용]
서버에 의해 반환된 HTTP 상태 코드입니다. | HTTPStatusEvent | ||
target : Object [읽기 전용]
이벤트 대상입니다. | Event | ||
type : String [읽기 전용]
이벤트 유형입니다. | Event |
메서드 | 정의 주체 | ||
---|---|---|---|
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
HTTP 상태 이벤트에 대한 특정 정보가 포함된 Event 객체를 만듭니다. | HTTPStatusEvent | ||
[재정의]
HTTPStatusEvent 객체의 복사본을 하나 만들고 각 속성의 값을 원본과 동일하게 설정합니다. | HTTPStatusEvent | ||
사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다. | Event | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다. | Event | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다. | Event | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | ||
이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다. | Event | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
[재정의]
HTTPStatusEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. | HTTPStatusEvent | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object |
상수 | 정의 주체 | ||
---|---|---|---|
HTTP_RESPONSE_STATUS : String = "httpResponseStatus" [정적]
httpStatus 이벤트와는 달리, httpResponseStatus 이벤트는 응답 데이터 이전에 전달됩니다. | HTTPStatusEvent | ||
HTTP_STATUS : String = "httpStatus" [정적]
HTTPStatusEvent.HTTP_STATUS 상수는 httpStatus 이벤트 객체의 type 속성 값을 정의합니다. | HTTPStatusEvent |
redirected | 속성 |
responseHeaders | 속성 |
responseURL | 속성 |
status | 속성 |
status:int
[읽기 전용] 언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
서버에 의해 반환된 HTTP 상태 코드입니다. 예를 들어 값 404는 서버에서 요청된 URI와 일치하는 내용을 찾지 못했음을 나타냅니다. http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html에 나와 있는 HTTP 사양의 10.4 및 10.5 섹션에서 HTTP 상태 코드를 확인할 수 있습니다.
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, redirected:Boolean = false)
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 속성을 통해 이 정보에 액세스할 수 있습니다.
| |
redirected:Boolean (default = false ) — 요청이 리디렉션되었는지 여부입니다. 이벤트 리스너는 redirected 속성을 통해 이 정보에 액세스할 수 있습니다.
|
관련 API 요소
clone | () | 메서드 |
toString | () | 메서드 |
HTTP_RESPONSE_STATUS | 상수 |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Lite 4 |
httpStatus
이벤트와는 달리, httpResponseStatus
이벤트는 응답 데이터 이전에 전달됩니다. 또한 httpResponseStatus
이벤트에는 responseHeaders
및 responseURL
속성(httpStatus
이벤트에 대해 정의되어 있지 않음) 값이 포함되어 있습니다. httpResponseStatus
이벤트(있는 경우)는 complete
또는 error
이벤트 발생 전에 추가로 전송됩니다.
HTTPStatusEvent.HTTP_RESPONSE_STATUS
상수는 httpResponseStatus
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
responseURL | 응답이 반환된 URL입니다. |
responseHeaders | URLRequestHeader 객체의 배열로 응답이 반환된 응답 헤더입니다. |
status | 서버에 의해 반환된 HTTP 상태 코드입니다. |
redirected | 응답이 리디렉션의 결과인지 여부입니다. |
target | HTTP 상태 코드를 수신하는 네트워크 객체입니다. |
관련 API 요소
HTTP_STATUS | 상수 |
public static const HTTP_STATUS:String = "httpStatus"
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9, Flash Lite 4 |
HTTPStatusEvent.HTTP_STATUS
상수는 httpStatus
이벤트 객체의 type
속성 값을 정의합니다.
이 이벤트에는 다음과 같은 속성이 있습니다.
속성 | 값 |
---|---|
bubbles | false |
cancelable | false . 취소할 기본 비헤이비어가 없습니다. |
currentTarget | 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다. |
status | 서버에 의해 반환된 HTTP 상태 코드입니다. |
target | HTTP 상태 코드를 수신하는 네트워크 객체입니다. |
관련 API 요소
httpStatusHandler
이벤트가 전달됩니다. httpStatusHandler
이벤트는 httpStatusHandler()
에 의해 처리되며, 이벤트에 대한 정보가 두 줄로 출력됩니다.
참고:
- 이 예제에서
securityError
이벤트를 생성하려면 "로컬 재생 보안"을 "네트워크만 액세스"로 설정하여 SWF 파일을 컴파일해야 합니다. - http://www.[yourDomain].com에서 실행 중이며 포트 80에서 수신하는 서버가 필요하며, 그렇지 않은 경우에는 상태 코드가 404가 아니라 0인
httpStatusHandler
이벤트가 수신됩니다. - 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); } } }
Tue Jun 12 2018, 03:17 PM Z