パッケージ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 では、 イベントのタイプは httpStatushttpStatus のみが存在します。 AIR ランタイムでは、FileReference、URLLoader、URLStream のいずれかが httpResponseStatus を監視するように登録できます。このイベントは responseURL プロパティと responseHeaders プロパティを含みます。これらのプロパティは httpStatus イベントでは定義されていません。

例を表示



パブリックプロパティ
 プロパティ定義元
 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
パブリックメソッド
 メソッド定義元
  
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)
HTTP ステータスイベントに関する特定の情報を含む Event オブジェクトを作成します。
HTTPStatusEvent
  
[override] 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
  
[override] HTTPStatusEvent オブジェクトのすべてのプロパティを含むストリングを返します。
HTTPStatusEvent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
パブリック定数
 定数定義元
 InheritedACTIVATE : String = "activate"
[静的] ACTIVATE 定数は、type プロパティ(activate イベントオブジェクト)の値を定義します。
Event
 InheritedADDED : String = "added"
[静的] Event.ADDED 定数は、added イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[静的] Event.ADDED_TO_STAGE 定数は、type プロパティ (addedToStage イベントオブジェクト) の値を定義します。
Event
 InheritedCANCEL : String = "cancel"
[静的] Event.CANCEL 定数は、cancel イベントオブジェクトの type プロパティの値を定義します。
Event
 InheritedCHANGE : String = "change"
[静的] Event.CHANGE 定数は、type プロパティ (change イベントオブジェクト) の値を定義します。
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 定数は、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 定数は、type プロパティ (exiting イベントオブジェクト) の値を定義します。
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 とは異なる 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 は、要求された URI と一致する URI が見つからなかったことを示します。HTTP ステータスコードは、ftp://ftp.isi.edu/in-notes/rfc2616.txt にある HTTP 仕様書のセクション 10.4 と 10.5 に記載されています。

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)

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

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 プロパティを通じてこの情報にアクセスできます。

関連項目

メソッドの詳細
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 イベントには responseHeaders プロパティと responseURL プロパティの値が含まれます(これらは httpStatus イベントでは定義されていません)。httpResponseStatus イベントは、発生した場合、complete イベントまたは error イベントの前に、これらのイベントとは別に送信されます。

HTTPStatusEvent.HTTP_RESPONSE_STATUS 定数は、type プロパティ(httpResponseStatus イベントオブジェクト)の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
responseURL応答の返送元の URL です。
responseHeaders返された応答ヘッダ (URLRequestHeader オブジェクトの配列) です。
statusサーバーから返された HTTP ステータスコードです。
targetHTTP ステータスコードを受け取るネットワークオブジェクトです。

関連項目

HTTP_STATUS定数 
public static const HTTP_STATUS:String = "httpStatus"

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.0 Flash Player 9

HTTPStatusEvent.HTTP_STATUS 定数は、type プロパティ(httpStatus イベントオブジェクト)の値を定義します。

このイベントには、次のプロパティがあります。

プロパティ
bubblesfalse
cancelablefalse は、キャンセルするデフォルトの動作がないことを示します。
currentTargetイベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
statusサーバーから返された HTTP ステータスコードです。
targetHTTP ステータスコードを受け取るネットワークオブジェクトです。

関連項目

例の使用法
HTTPStatusEventExample.as

次の例では、存在しないファイルを http://www.[yourDomain].com のルート Web ディレクトリから読み込もうとします。これにより、ファイルが見つからなかったことを示すステータス 404 と共に httpStatusHandler イベントが送出されます。httpStatusHandler イベントは httpStatusHandler() によって処理されます。これにより、イベントに関する情報が 2 行出力されます。

メモ :

  1. この例では、[ローカルでの再生に関するセキュリティ] を [ネットワークにのみアクセスする] に設定して SWF ファイルをコンパイルし、securityError イベントを生成する必要があります。
  2. http://www.[yourDomain].com で実行し、ポート 80 でリスニングしているサーバーが必要です。これ以外の場合は、ステータスコードが 404 ではなく 0 のhttpStatusHandler イベントを受け取ります。
  3. 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);
        }
    }
}




 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/events/HTTPStatusEvent.html