URLStream  - AS3

入力バッファーで読み取ることができるデータのバイト数を返します。bytesAvailable プロパティを呼び出して、読み取るデータが十分にあることを確認してから、いずれかの read メソッドを使用してデータを読み取るようにしてください。

この URLStream オブジェクトが現在、接続されているかどうかを示します。このプロパティの呼び出しは、URLStream オブジェクトが接続されている場合は値 true を、それ以外の場合は false を返します。

データのバイト順を示します。指定できる値は、Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN です。

デフォルト値： Endian.BIG_ENDIAN。

関連する API エレメント

オブジェクトの書き込みまたは読み取り時に使用される Action Message Format（AMF）のバージョンを制御します。

関連する API エレメント

すぐにストリームを閉じ、ダウンロード処理をキャンセルします。close() メソッドの呼び出し後は、ストリームからデータを読み込みません。

request パラメーターで指定された URL でのダウンロードを開始します。

注意：ロード中のファイルに ASCII 文字以外の文字（英語以外の多くの言語に存在する）が含まれている場合は、ASCII のような非 Unicode 形式ではなく UTF-8 または UTF-16 エンコーディング形式でファイルを保存することをお勧めします。

ロード処理がすぐに失敗すると、エラーについて説明する IOError または SecurityError（ローカルファイルのセキュリティエラーを含む）例外がスローされます。その他に、URL ダウンロードでダウンロードが正常に開始した場合は open イベントが送出され、エラーが発生した場合はエラーイベントが送出されます。

デフォルトで、呼び出し元の SWF ファイルおよびロードする URL は同じドメインに置かれている必要があります。例えば、www.adobe.com に置かれている SWF ファイルは www.adobe.com に置かれているソースからのみデータをロードできます。 異なるドメインからデータをロードするには、データをホストするサーバーに URL ポリシーファイルを配置します。

Flash Player では、一般的な予約ポートへは接続できません。遮断されたポートの詳しいリストについては、『ActionScript 3.0 開発ガイド』の「ネットワーク API の制限」を参照してください。

Flash Player では、SWF ファイルがこのメソッドを使用しないようにすることができます。そのためには、SWF コンテンツを含んでいる HTML ページに allowNetworking パラメーター（object タグおよび embed タグ）を設定します。

Flash Player 10 以降および AIR 1.5 以降では、"multipart/form-data" などのマルチパート Content-Type にアップロードが含まれていると（アップロードが含まれているかどうかは POST ボディ内の "content-disposition" ヘッダーの "filename" パラメーターで示されます）、そのアップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

• POST 処理は、マウスのクリックやキーの押下などのユーザーが開始したアクションに応答して実行する必要があります。
• POST 処理がクロスドメインである（POST ターゲットが、POST 要求を送信中の SWF ファイルと同じサーバー上にない）場合は、クロスドメインアクセスを許可する URL ポリシーファイルをターゲットサーバーが提供する必要があります。

また、すべてのマルチパート Content-Type では、RFC2046 標準に準拠した有効なシンタックスを使用する必要があります。シンタックスが有効でない場合は、アップロードに適用されるセキュリティ規則によって POST 処理が拘束されます。

これらのルールは、アプリケーションサンドボックス内にない AIR コンテンツにも適用されます。ただし、Adobe AIR では、アプリケーションサンドボックス内のコンテンツ（AIR アプリケーションと共にインストールされたコンテンツ）は、これらのセキュリティ制限による制限を受けません。

セキュリティについて詳しくは、Flash Player デベロッパーセンターのトピック：セキュリティを参照してください。

AIR では、URLRequest オブジェクトを httpResponse ステータスイベントに登録できます。httpStatus イベントと異なり、httpResponseStatus イベントは応答データの前に配信されます。また、httpResponseStatus イベントには responseHeaders プロパティと responseURL プロパティの値が含まれます（これらは httpStatus イベントでは定義されていません）。httpResponseStatus イベントは、発生した場合、complete イベントまたは error イベントの前に、これらのイベントとは別に送信されます。

httpResponseStatus イベントリスナーがある場合、応答メッセージの本文は常に送信され、HTTP ステータスコードの応答結果は常に complete イベントになります。これは、HTTP 応答ステータスコードが成功またはエラーを示しているかどうかにかかわらず当てはまります。

AIR では、このイベントリスナーが存在しない（つまり、httpResponseStatus イベントリスナーが存在しない）場合、SWF の AIR のバージョンによって動作が異なります。

• SWF 9 コンテンツでは、HTTP 応答のステータスコードが成功を示している場合のみ、HTTP 応答メッセージの本文が送信されます。それ以外（エラーがある場合）は、本文は送信されずに、URLRequest オブジェクトによって IOError イベントが送出されます。
• SWF 10 コンテンツでは、HTTP 応答メッセージの本文は必ず送信されます。エラーがある場合は、URLRequest オブジェクトによって IOError イベントが送出されます。

パラメーター

ストリームからブール値を読み取ります。1 バイトが読み取られ、バイトがゼロ以外の場合は true、それ以外の場合は false が返されます。

ストリームから符号付きバイトを読み取ります。

返される値は -128 ～ 127 の範囲です。

ストリームから length バイトのデータを読み取ります。このバイトは、bytes で指定した ByteArray オブジェクトに読み込まれます。ByteArray オブジェクトの offset バイトの位置から読み込みが開始されます。

パラメーター

ストリームから IEEE 754 倍精度浮動小数点数を読み取ります。

ストリームから IEEE 754 単精度浮動小数点数を読み取ります。

ストリームから符号付き 32 bit 整数を読み取ります。

返される値は -2147483648 ～ 2147483647 の範囲です。

指定した文字セットを使用して、バイトストリームから指定した長さのマルチバイトストリングを読み取ります。

パラメーター

ソケットから Action Message Format（AMF）形式でエンコードされたオブジェクトを読み取ります。

関連する API エレメント

ストリームから符号付き 16 bit 整数を読み取ります。

返される値は -32768 ～ 32767 の範囲です。

ストリームから符号なしバイトを読み取ります。

返される値は 0 ～ 255 の範囲です。

ストリームから符号なし 32 bit 整数を読み取ります。

返される値は 0 ～ 4294967295 の範囲です。

ストリームから符号なし 16 bit 整数を読み取ります。

返される値は 0 ～ 65535 の範囲です。

ストリームから UTF-8 ストリングを読み取ります。このストリングには、バイト単位の長さを示す符号なし short が前に付いているものと見なされます。

ストリームから length の UTF-8 バイトを読み取り、ストリングを返します。

パラメーター

データが正常にロードされたときに送出されます。

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

URLStream.load() メソッドを呼び出して HTTP を介してデータにアクセスを試み、Adobe AIR で要求のステータスコードを検出して返すことができる場合に送出されます。

URLStream オブジェクトに httpStatusEvent イベントを登録すると、エラー応答がコンテンツであるかのように配信されます。このため、URLStream は、エラーデータが URLStream にロードされると、ioError イベントを送出する代わりに progress イベントおよび complete イベントを送出します。

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

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

関連する API エレメント

URLStream.load() を呼び出して HTTP を介してデータにアクセスを試み、Flash Player または Adobe AIR で要求のステータスコードを検出して返すことができる場合に送出されます（一部のブラウザー環境ではこの情報を提供できません）。httpStatus が発生した場合は、complete イベントまたは error イベントの前に、これらのイベントとは別に送信されます。

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

関連する API エレメント

入出力エラーが発生してロード操作が失敗したときに送出されます。

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

関連する API エレメント

ロード操作が開始したときに送出されます。

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

関連する API エレメント

ダウンロード処理を実行中にデータを受信したときに送出されます。受け取ったデータは、URLStream クラスのメソッドを使用してすぐに読み取ることができます。

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

関連する API エレメント

URLStream.load() の呼び出しによってセキュリティサンドボックスの外部にあるサーバーからデータをロードしようとすると送出されます。

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

関連する API エレメント

例を実行するために、URLStreamExample.swf という名前のファイルを SWF ファイルと同じディレクトリに配置してください。

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:Event):void {
            trace("progressHandler: " + event);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

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

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}