パッケージ | flash.events |
クラス | public class AVHTTPStatusEvent |
継承 | AVHTTPStatusEvent Event Object |
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9, Flash Lite 4 |
AVHTTPStatusEvent オブジェクトは、常に、エラーイベントまたは完了イベントの前に送信されます。AVHTTPStatusEvent オブジェクトは、必ずしもエラー条件を示すわけではなく、ネットワークスタックによって提供される 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 | ||
responseHeaders : Array
返された応答ヘッダー(URLRequestHeader オブジェクトの配列)です。 | AVHTTPStatusEvent | ||
responseURL : String
応答の返送元の URL です。 | AVHTTPStatusEvent | ||
status : int [読み取り専用]
サーバーから返された HTTP ステータスコードです。 | AVHTTPStatusEvent | ||
target : Object [読み取り専用]
イベントターゲットです。 | Event | ||
type : String [読み取り専用]
イベントのタイプです。 | Event |
メソッド | 定義元 | ||
---|---|---|---|
AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)
HTTP ステータスイベントに関する特定の情報を含む Event オブジェクトを作成します。 | AVHTTPStatusEvent | ||
[オーバーライド]
AVHTTPStatusEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。 | AVHTTPStatusEvent | ||
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。 | Event | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。 | Event | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。 | Event | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。 | Event | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
[オーバーライド]
AVHTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。 | AVHTTPStatusEvent | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object |
定数 | 定義元 | ||
---|---|---|---|
AV_HTTP_RESPONSE_STATUS : String = "avHttpResponseStatus" [静的]
httpStatus イベントと異なり、httpResponseStatus イベントは応答データの前に配信されます。 | AVHTTPStatusEvent |
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
AVHTTPStatusEvent | () | コンストラクター |
public function AVHTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, responseUrl:String = null, responseHeaders:Array = null)
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9, Flash Lite 4 |
HTTP ステータスイベントに関する特定の情報を含む Event オブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメーターとして渡されます。
パラメーターtype:String — イベントのタイプです。イベントリスナーは、継承された type プロパティを通じてこの情報にアクセスできます。HTTPStatus イベントのタイプは AVHTTPStatusEvent.HTTP_STATUS の 1 つのみです。
| |
bubbles:Boolean (default = false ) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。イベントリスナーは、継承された bubbles プロパティを通じてこの情報にアクセスできます。
| |
cancelable:Boolean (default = false ) — Event オブジェクトがキャンセル可能かどうかを判断します。イベントリスナーは、継承された cancelable プロパティを通じてこの情報にアクセスできます。
| |
status:int (default = 0 ) — 数値ステータスです。イベントリスナーは、status プロパティを通じてこの情報にアクセスできます。
| |
responseUrl:String (default = null )
| |
responseHeaders:Array (default = null )
|
関連する API エレメント
clone | () | メソッド |
toString | () | メソッド |
override public function toString():String
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Player 9, Flash Lite 4 |
AVHTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。
[AVHTTPStatusEvent type=value bubbles=value cancelable=value status=value]
String — AVHTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングです。
|
AV_HTTP_RESPONSE_STATUS | 定数 |
public static const AV_HTTP_RESPONSE_STATUS:String = "avHttpResponseStatus"
言語バージョン: | ActionScript 3.0 |
ランタイムバージョン: | AIR 1.0, Flash Lite 4 |
httpStatus
イベントと異なり、httpResponseStatus
イベントは応答データの前に配信されます。また、httpResponseStatus
イベントには responseHeaders
プロパティと responseURL
プロパティの値が含まれます(これらは httpStatus
イベントでは定義されていません)。httpResponseStatus
イベントは、発生した場合、complete
イベントまたは error
イベントの前に、これらのイベントとは別に送信されます。
AVHTTPStatusEvent.HTTP_RESPONSE_STATUS
定数は、type
プロパティ(httpResponseStatus
イベントオブジェクト)の値を定義します。
このイベントには、次のプロパティがあります。
プロパティ | 値 |
---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
responseURL | 応答の返送元の URL です。 |
responseHeaders | 返された応答ヘッダー(URLRequestHeader オブジェクトの配列)です。 |
status | サーバーから返された HTTP ステータスコードです。 |
target | HTTP ステータスコードを受け取るネットワークオブジェクトです。 |
関連する API エレメント
Tue Jun 12 2018, 10:34 AM Z