パッケージ | 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 のいずれかが httpResponseStatus
を監視するように登録できます。このイベントは responseURL
プロパティと responseHeaders
プロパティを含みます。これらのプロパティは 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 と一致する URI が見つからなかったことを示します。HTTP ステータスコードは、HTTP 仕様の 10.4 および 10.5(http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html)で確認できます。
Flash Player または AIR がサーバーからステータスコードを取得できなかった場合、またはサーバーと通信できなかった場合は、記述したコードにデフォルト値の 0 が渡されます。 値 0 は、どのプレーヤーでも生成される可能性があります(例えば、正しくない形式の URL が要求された場合など)。また、特定のブラウザーで実行される Flash Player プラグインでは、HTTP ステータスコードをプレーヤーに渡すことができないので、常に値 0 が生成されます。該当するブラウザーには、Netscape、Mozilla、Safari、Opera および Internet Explorer for the Macintosh があります。
実装
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 の 1 つのみです。
| |
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 | () | メソッド |
override public function toString():String
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9, Flash Lite 4 |
HTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。
[HTTPStatusEvent type=value bubbles=value cancelable=value status=value]
String — HTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングです。
|
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
定数は、type
プロパティ(httpResponseStatus
イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
プロパティ | 値 |
---|---|
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
定数は、type
プロパティ(httpStatus
イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
status | サーバーから返された HTTP ステータスコードです。 |
target | HTTP ステータスコードを受け取るネットワークオブジェクトです。 |
関連する API エレメント
httpStatusHandler
イベントが送出されます。httpStatusHandler
イベントは httpStatusHandler()
によって処理されます。これにより、イベントに関する情報が 2 行出力されます。
注意:
- この例では、「ローカルでの再生に関するセキュリティ」を「ネットワークにのみアクセスする」に設定して SWF ファイルをコンパイルし、
securityError
イベントを生成する必要があります。 - http://www.[yourDomain].com で実行し、ポート 80 でリスニングしているサーバーが必要です。これ以外の場合は、ステータスコードが 404 ではなく 0 の
httpStatusHandler
イベントを受け取ります。 - http://www.[yourDomain].com のルート Web ディレクトリに 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, 10:34 AM Z