Socket  - AS3

入力バッファーで読み取ることができるデータのバイト数です。

コードでは、bytesAvailable にアクセスして入力バッファーの空き容量を確認してから、read メソッドの 1 つを使用してデータを読み取る必要があります。

書き込みバッファーに残っているデータのバイト数を示します。

このプロパティは OutputProgressEvent と組み合わせて使用します。OutputProgressEvent は、書き込みバッファーからネットワークにデータが書き込まれるたびにスローされます。イベントハンドラーで、bytesPending をチェックして、バッファー内で書き込みを待機しているデータ量を確認できます。bytesPending が 0 を返す場合、すべてのデータが書き込みバッファーからネットワークに送信されたことを示します。そのため、イベントハンドラーの削除、ソケット参照への null 設定、キューへの次のアップロードの開始などの処理を安全に実行できます。

関連する API エレメント

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

データのバイト順序を示します。指定できる値は flash.utils.Endian クラスの定数で、Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN です。

デフォルト値： Endian.BIG_ENDIAN。

関連する API エレメント

ローカルマシン上でこのソケットがバインドされている IP アドレス。

関連する API エレメント

ローカルマシン上でこのソケットがバインドされているポート。

関連する API エレメント

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

関連する API エレメント

このソケットが接続されているリモートマシンの IP アドレス。

このプロパティを使用して、ServerSocket オブジェクトによって ServerSocketConnectEvent 内に送出されたクライアントソケットの IP アドレスを特定します。必要な場合は、DNSResolver クラスを使用して、IP アドレスをドメイン名に変換します。

関連する API エレメント

このソケットが接続されているリモートマシンのポート。

このプロパティを使用して、ServerSocket オブジェクトによって ServerSocketConnectEvent 内に送出されたクライアントソケットのポート番号を特定します。

関連する API エレメント

接続までの待ち時間（ミリ秒数）を示します。

指定した時間内に接続できなかったときは、接続が失敗することになります。デフォルト値は 20,000 (20 秒) です。

Socket オブジェクトを新規作成します。パラメーターを指定しないと、初期状態では未接続のソケットが作成されます。パラメーターを指定すると、指定したホストおよびポートへの接続が試行されます。

注意：パラメーターを指定せずにコンストラクターフォームを使用し、さらにいずれかのイベントリスナーを追加し、connect メソッドを呼び出すことを強く推奨します（ホストおよびポートをパラメーターに指定する）。このシーケンスによって、すべてのイベントリスナーが正しく動作するようになります。

ソケットを閉じます。close() メソッドが呼び出された後は、データの読み書きはできません。

close イベントは、サーバーにより接続が閉じられたときのみ送出されます。close() メソッドを呼び出しても送出されません。

Socket オブジェクトで connect() メソッドをもう一度呼び出すことで、その Socket オブジェクトを再使用できます。

指定されたホストおよびポートにソケットを接続します。

直後に接続が失敗した場合、イベントが送出されるか例外がスローされます。ホストが指定されている場合はエラーイベントが送出され、ホストが指定されていない場合は例外がスローされます。接続が成功した場合は、接続のステータスがイベントにより報告されます。ソケットが既に接続済みの場合、最初に既存の接続が閉じられます。

パラメーター

ソケットの出力バッファーに蓄積されたデータをフラッシュします。

オペレーティングシステムによっては、flush() は実行フレーム間で自動的に呼び出されますが、Windows などのオペレーティングシステムでは、flush() を明示的に呼び出さない限り、データは送信されません。アプリケーションが確実にすべてのオペレーティングシステムで動作するようにするには、各メッセージ（または関連するデータのグループ）をソケットに書き出した後で、flush() メソッドを呼び出すことをお勧めします。

ソケットからブール値を読み取ります。1 バイトを読み取った後、メソッドはバイトがゼロ以外の場合は true、それ以外の場合は false を返します。

ソケットから符号付きバイトを読み取ります。

ソケットから、length パラメーターで指定したデータバイト数を読み取ります。このバイトは、指定したバイト配列の、offset で指定された位置以降に読み込まれます。

パラメーター

ソケットから IEEE 754 倍精度浮動小数点数を読み取ります。

ソケットから IEEE 754 単精度浮動小数点数を読み取ります。

ソケットから符号付き 32 ビット整数を読み取ります。

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

パラメーター

ソケットから AMF 直列化形式でエンコードされたオブジェクトを読み取ります。

関連する API エレメント

ソケットから符号付き 16 ビット整数を読み取ります。

ソケットから符号なしバイトを読み取ります。

ソケットから符号なし 32 ビット整数を読み取ります。

ソケットから符号なし 16 ビット整数を読み取ります。

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

ソケットから length パラメーターで指定した UTF-8 バイト数を読み取り、ストリングを返します。

パラメーター

ソケットにブール値を書き込みます。このメソッドは 1 バイトを書き込みます。1（true の場合）または 0（false の場合）のいずれかの値が使用されます。

パラメーター

関連する API エレメント

ソケットに 1 バイトを書き込みます。

パラメーター

関連する API エレメント

指定したバイト配列のバイトのシーケンスを書き込みます。書き込み操作は、offset で指定された位置から開始されます。

length パラメーターを省略するとデフォルトの長さ 0 が使用され、offset の位置からバッファー全体が書き込まれます。

offset パラメーターを省略した場合も、バッファー全体が書き込まれます。

パラメーター

関連する API エレメント

ソケットに IEEE 754 倍精度浮動小数点数を書き込みます。

パラメーター

関連する API エレメント

ソケットに IEEE 754 単精度浮動小数点数を書き込みます。

パラメーター

関連する API エレメント

ソケットに 32 ビット符号付き整数を書き込みます。

パラメーター

関連する API エレメント

指定した文字セットを使用して、バイトストリームからマルチバイトストリングを書き込みます。

パラメーター

関連する API エレメント

ソケットに AMF 直列化形式でオブジェクトを書き込みます。

パラメーター

関連する API エレメント

ソケットに 16 ビット整数を書き込みます。次のようにバイトが書き込まれます。

(v >> 8) & 0xff v & 0xff

パラメーターの下位 16 bit が使用されます。上位 16 bit は無視されます。

パラメーター

関連する API エレメント

ソケットに 32 ビット符号なし整数を書き込みます。

パラメーター

関連する API エレメント

指定された UTF-8 ストリングの長さ（バイト単位）を示す 16 ビット符号なし整数をソケットに書き込み、その後にストリング自体を書き込みます。

ストリングを書き込む前に、メソッドによってストリングのすべての文字を表すのに必要なバイト数が計算されます。

パラメーター

関連する API エレメント

ソケットに UTF-8 ストリングを書き込みます。

パラメーター

関連する API エレメント

サーバーによりソケット接続が閉じられたときに送出されます。

close イベントは、サーバーにより接続が閉じられたときのみ送出されます。Socket.close() メソッドを呼び出しても送出されません。

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

ネットワーク接続が確立されたときに送出されます。

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

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

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

ソケットによってデータが書き込みバッファーからネットワークトランスポートレイヤーに移動されるときに送出されます

Socket.connect() への呼び出しが、呼び出し元のセキュリティサンドボックスによって禁止されているサーバーまたは 1024 より下位のポートに接続しようとしたときに、そのような接続を許可するポリシーファイルが存在しない場合に送出されます。

注意： AIR アプリケーションでは、アプリケーションセキュリティサンドボックスで実行されるコンテンツはソケットポリシーファイルなしでサーバーおよびポート番号に接続できません。

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

関連する API エレメント

ソケットがデータを受信したときに送出されます。

ソケットが受信するデータは、読み込まれるまでソケットに残ります。このイベントのハンドラーで使用できるすべてのデータを読み込む必要はありません。

socketData タイプのイベントでは、ProgressEvent.bytesTotal プロパティは使用されません。

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

1. コンストラクターが CustomSocket インスタンスの socket を作成し、ホスト名 localhost とポート 80 をパラメーターとして渡します。CustomSocket は Socket を継承するので、super() を呼び出すと Socket のコンストラクターが呼び出されます。
2. 次に configureListeners() メソッドが呼び出され、このメソッドにより Socket イベントのリスナーが追加されます。
3. 最後に、ソケット connect() メソッドがホスト名 localhost、ポート番号 80 で呼び出されます。

注意：この例を実行するには、SWF が存在するドメインと同じドメインで実行され、ポート 80 でリッスンするサーバー（この例では localhost）が必要です。

package {
    import flash.display.Sprite;

    public class SocketExample extends Sprite {
        private var socket:CustomSocket;
        
        public function SocketExample() {
            socket = new CustomSocket("localhost", 80);
        }
    }
}

import flash.errors.*;
import flash.events.*;
import flash.net.Socket;

class CustomSocket extends Socket {
    private var response:String;

    public function CustomSocket(host:String = null, port:uint = 0) {
        super();
        configureListeners();
        if (host && port)  {
            super.connect(host, port);
        }
    }

    private function configureListeners():void {
        addEventListener(Event.CLOSE, closeHandler);
        addEventListener(Event.CONNECT, connectHandler);
        addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        addEventListener(ProgressEvent.SOCKET_DATA, socketDataHandler);
    }

    private function writeln(str:String):void {
        str += "\n";
        try {
            writeUTFBytes(str);
        }
        catch(e:IOError) {
            trace(e);
        }
    }

    private function sendRequest():void {
        trace("sendRequest");
        response = "";
        writeln("GET /");
        flush();
    }

    private function readResponse():void {
        var str:String = readUTFBytes(bytesAvailable);
        response += str;
    }

    private function closeHandler(event:Event):void {
        trace("closeHandler: " + event);
        trace(response.toString());
    }

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

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

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

    private function socketDataHandler(event:ProgressEvent):void {
        trace("socketDataHandler: " + event);
        readResponse();
    }
}