| パッケージ | flash.net |
| public class Socket | |
| 継承 | Socket EventDispatcher Object |
| 実装 | IDataInput, IDataOutput |
Socket クラスは、バイナリプロトコルを使用するサーバーとの通信に役立ちます。
このクラスを使用するときは、Flash Player セキュリティモデルを考慮してください。
詳細については、次のトピックを参照してください。
関連項目
| プロパティ | 定義 | ||
|---|---|---|---|
| bytesAvailable : uint
[read-only]
入力バッファで読み取ることができるデータのバイト数です。
| Socket | ||
| connected : Boolean
[read-only]
この Socket オブジェクトが現在、接続されているかどうかを示します。
| Socket | ||
![]() | constructor : Object
特定のオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
| Object | |
| endian : String
データのバイト順序を示します。指定できる値は flash.utils.Endian クラスの定数で、
Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN です。 | Socket | ||
| objectEncoding : uint
オブジェクトの書き込みまたは読み取り時に使用される AMF のバージョンを制御します。
| Socket | ||
![]() | prototype : Object
[static]
クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
| Object | |
| メソッド | 定義 | ||
|---|---|---|---|
| Socket(host:String = null, port:int = 0)
Socket オブジェクトを作成します。
| Socket | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
| EventDispatcher | |
| close():void
ソケットを閉じます。
| Socket | ||
| connect(host:String, port:int):void
指定されたホストおよびポートにソケットを接続します。
| Socket | ||
![]() | dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
| EventDispatcher | |
| flush():void
ソケットの出力バッファに蓄積されたデータをフラッシュします。
| Socket | ||
![]() | hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
| EventDispatcher | |
![]() | hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
| Object | |
![]() | isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
| Object | |
![]() | propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙可能かどうかを示します。
| Object | |
| readBoolean():Boolean
ソケットからブール値を読み取ります。
| Socket | ||
| readByte():int
ソケットから符号付きバイトを読み取ります。
| Socket | ||
| readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
ソケットから、
length パラメータで指定したデータバイト数を読み取ります。 | Socket | ||
| readDouble():Number
ソケットから IEEE 754 倍精度浮動小数点数を読み取ります。
| Socket | ||
| readFloat():Number
ソケットから IEEE 754 単精度浮動小数点数を読み取ります。
| Socket | ||
| readInt():int
ソケットから符号付き 32 ビット整数を読み取ります。
| Socket | ||
| readMultiByte(length:uint, charSet:String):String
指定した文字セットを使用して、バイトストリームからマルチバイトストリングを読み取ります。
| Socket | ||
| readObject():*
ソケットから AMF 直列化形式でエンコードされたオブジェクトを読み取ります。
| Socket | ||
| readShort():int
ソケットから符号付き 16 ビット整数を読み取ります。
| Socket | ||
| readUnsignedByte():uint
ソケットから符号なしバイトを読み取ります。
| Socket | ||
| readUnsignedInt():uint
ソケットから符号なし 32 ビット整数を読み取ります。
| Socket | ||
| readUnsignedShort():uint
ソケットから符号なし 16 ビット整数を読み取ります。
| Socket | ||
| readUTF():String
ソケットから UTF-8 ストリングを読み取ります。
| Socket | ||
| readUTFBytes(length:uint):String
ソケットから
length パラメータで指定した UTF-8 バイト数を読み取り、ストリングを返します。 | Socket | ||
![]() | removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
| EventDispatcher | |
![]() | setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
| Object | |
![]() | toString():String
指定されたオブジェクトのストリング表現を返します。
| Object | |
![]() | valueOf():Object
指定されたオブジェクトのプリミティブ値を返します。
| Object | |
![]() | willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
| EventDispatcher | |
| writeBoolean(value:Boolean):void
ソケットにブール値を書き込みます。
| Socket | ||
| writeByte(value:int):void
ソケットに書き込むバイトです。
| Socket | ||
| writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
指定したバイト配列のバイトのシーケンスを書き込みます。
| Socket | ||
| writeDouble(value:Number):void
ソケットに IEEE 754 倍精度浮動小数点数を書き込みます。
| Socket | ||
| writeFloat(value:Number):void
ソケットに IEEE 754 単精度浮動小数点数を書き込みます。
| Socket | ||
| writeInt(value:int):void
ソケットに 32 ビット符号付き整数を書き込みます。
| Socket | ||
| writeMultiByte(value:String, charSet:String):void
指定した文字セットを使用して、バイトストリームからマルチバイトストリングを書き込みます。
| Socket | ||
| writeObject(object:*):void
ソケットに AMF 直列化形式でオブジェクトを書き込みます。
| Socket | ||
| writeShort(value:int):void
ソケットに 16 ビット整数を書き込みます。
| Socket | ||
| writeUnsignedInt(value:uint):void
ソケットに 32 ビット符号なし整数を書き込みます。
| Socket | ||
| writeUTF(value:String):void
ソケットに 16 ビット符号なし整数を書き込みます。これによって指定された UTF-8 ストリングの長さがバイト単位で示され、その後にストリングが続きます。
| Socket | ||
| writeUTFBytes(value:String):void
ソケットに UTF-8 ストリングを書き込みます。
| Socket | ||
| イベント | 一覧 | 定義 | ||
|---|---|---|---|---|
| close | サーバーによりソケット接続が閉じられたときに送出されます。 | Socket | ||
| connect | ネットワーク接続が確立されたときに送出されます。 | Socket | ||
| ioError | 入出力エラーが発生して送信またはロード操作が失敗したときに送出されます。 | Socket | ||
| securityError |
Socket.connect() の呼び出しによって、呼び出し元のセキュリティサンドボックスの外にあるサーバーや 1024 未満のポート番号に対して接続しようとしたときに送出されます。 | Socket | ||
| socketData | ソケットがデータを受信したときに送出されます。 | Socket | ||
| bytesAvailable | プロパティ |
bytesAvailable:uint [read-only]入力バッファで読み取ることができるデータのバイト数です。
read メソッドの 1 つを使用してデータを読み取る前に、コードで bytesAvailable にアクセスして、入力バッファの空き容量を確認する必要があります。
public function get bytesAvailable():uint
| connected | プロパティ |
connected:Boolean [read-only]
この Socket オブジェクトが現在、接続されているかどうかを示します。このプロパティの呼び出しによって、現在ソケットが接続されている場合は true の値を、それ以外の場合は false の値を返します。
public function get connected():Boolean
| endian | プロパティ |
endian:String [read-write]
データのバイト順序を示します。指定できる値は flash.utils.Endian クラスの定数で、Endian.BIG_ENDIAN または Endian.LITTLE_ENDIAN です。
デフォルト値Endian.BIG_ENDIAN.
public function get endian():String
public function set endian(value:String):void
関連項目
| objectEncoding | プロパティ |
objectEncoding:uint [read-write]オブジェクトの書き込みまたは読み取り時に使用される AMF のバージョンを制御します。
実装 public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
関連項目
| Socket | () | コンストラクタ |
public 関数 Socket(host:String = null, port:int = 0)Socket オブジェクトを作成します。パラメータを指定しないと、初期状態では未接続のソケットが作成されます。パラメータを指定すると、指定したホストおよびポートへの接続が試行されます。
パラメータhost:String (default = null) — 接続するホスト名です。このパラメータを指定しないと、初期状態では未接続のソケットが作成されます。
|
|
port:int (default = 0) — 接続先のポート番号です。このパラメータを指定しないと、初期状態では未接続のソケットが作成されます。
|
connect:Event — ネットワーク接続が確立されたときに送出されます。 |
|
ioError:IOErrorEvent — 入出力エラーが発生して接続が失敗すると送信されます。 |
|
securityError:SecurityErrorEvent — Socket.connect() の呼び出しによって、呼び出し元のセキュリティサンドボックスの外にあるサーバーや 1024 未満のポート番号に対して接続しようとしたときに送出されます。いずれの問題も、サーバー上でクロスドメインポリシーファイルを使用することで回避できます。ソケット用のポリシーファイルの詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。 |
SecurityError — このエラーは、次の理由で発生する可能性があります。
|
| close | () | メソッド |
public function close():void
ソケットを閉じます。close() メソッドが呼び出された後は、データの読み書きはできません。
close イベントは、サーバーにより接続が閉じられたときのみ送出されます。close() メソッドを呼び出しても送出されません。
Socket オブジェクトで connect() メソッドをもう一度呼び出すことで、その Socket オブジェクトを再使用できます。
IOError — ソケットを閉じることができないか、またはソケットが開いていません。
|
| connect | () | メソッド |
public function connect(host:String, port:int):void指定されたホストおよびポートにソケットを接続します。直後に接続が失敗した場合、イベントが送出されるか例外がスローされます。ホストが指定されている場合はエラーイベントが送出され、ホストが指定されていない場合は例外がスローされます。接続が成功した場合は、接続のステータスがイベントにより報告されます。ソケットが既に接続済みの場合、最初に既存の接続が閉じられます。
デフォルトでは、host に渡す値は同じドメインに置かれている必要があり、port に渡す値は 1024 以上である必要があります。たとえば、adobe.com に置かれている SWF ファイルは、adobe.com 上で実行されるサーバーデーモンにしか接続できません。接続している SWF ファイルが置かれているホストとは異なるホスト上にあるソケットに接続する場合、または任意のホストでポート番号が 1024 より小さいポートに接続する場合は、接続するホストから xmlsocket: ポリシーファイルを取得する必要があります。詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。
host:String — 接続するホスト名です。ホストを指定しないと、接続するホストは、呼び出す SWF ファイルが存在するホストになります。ホストを指定しない場合は、イベントリスナーを使用して接続が成功したかどうか判定します。
|
|
port:int — 接続先のポート番号です。
|
connect:Event — ネットワーク接続が確立されたときに送出されます。 |
|
ioError:IOErrorEvent — ホストが指定されていて、入出力エラーが発生して接続が失敗した場合に送出されます。 |
|
securityError:SecurityErrorEvent — Socket.connect() の呼び出しによって、呼び出し元のセキュリティサンドボックスの外にあるサーバーや 1024 未満のポート番号に対して接続しようとしたときに送出されます。いずれの問題も、サーバー上でクロスドメインポリシーファイルを使用することで回避できます。詳細については、『ActionScript 3.0 のプログラミング』の「Flash Player セキュリティ」の章を参照してください。 |
IOError — ホストが指定されていないため、接続に失敗しました。
|
|
SecurityError — このエラーは、次の理由で発生する可能性があります。
|
| flush | () | メソッド |
public function flush():void
ソケットの出力バッファに蓄積されたデータをフラッシュします。write メソッドで書き込まれるデータは、すぐには転送されません。 flush() メソッドが呼び出されるまでキューに置かれます。
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readBoolean | () | メソッド |
public function readBoolean():Boolean
ソケットからブール値を読み取ります。1 バイトを読み取られた後、メソッドはバイトがゼロ以外の場合は true、それ以外の場合は false を返します。
Boolean —
バイトの読み取る値がゼロ以外の場合は true、それ以外の場合は false になります。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readByte | () | メソッド |
public function readByte():intソケットから符号付きバイトを読み取ります。
戻り値int —
値は -128 ~ 127 です。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readBytes | () | メソッド |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
ソケットから、length パラメータで指定したデータバイト数を読み取ります。このバイトは、指定したバイト配列の offset で指定された開始位置に読み込まれます。
bytes:ByteArray — データの読み込み先の ByteArray オブジェクトです。
|
|
offset:uint (default = 0) — バイト配列でデータの読み取りが開始するオフセットです。
|
|
length:uint (default = 0) — 読み取るバイト数です。デフォルト値の 0 に設定すると、すべてのデータが読み取られます。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readDouble | () | メソッド |
public function readDouble():Numberソケットから IEEE 754 倍精度浮動小数点数を読み取ります。
戻り値Number |
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readFloat | () | メソッド |
public function readFloat():Numberソケットから IEEE 754 単精度浮動小数点数を読み取ります。
戻り値Number |
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readInt | () | メソッド |
public function readInt():intソケットから符号付き 32 ビット整数を読み取ります。
戻り値int —
値は -2147483648 ~ 2147483647 です。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readMultiByte | () | メソッド |
public function readMultiByte(length:uint, charSet:String):String指定した文字セットを使用して、バイトストリームからマルチバイトストリングを読み取ります。
パラメータlength:uint — バイトストリームから読み取るバイト数です。
|
|
charSet:String — バイトの解釈に使用する文字セットを表すストリングです。文字セットのストリングには、"shift_jis"、"CN-GB"、および "iso-8859-1" があります。完全な一覧については、「サポートする文字セット」を参照してください。
|
String —
UTF-8 エンコードされたストリングです。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
| readObject | () | メソッド |
public function readObject():*ソケットから AMF 直列化形式でエンコードされたオブジェクトを読み取ります。
戻り値* — 非直列化されたオブジェクトです。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| readShort | () | メソッド |
public function readShort():intソケットから符号付き 16 ビット整数を読み取ります。
戻り値int —
値は -32768 ~ 32767 です。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readUnsignedByte | () | メソッド |
public function readUnsignedByte():uintソケットから符号なしバイトを読み取ります。
戻り値uint —
値は 0 ~ 255 です。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readUnsignedInt | () | メソッド |
public function readUnsignedInt():uintソケットから符号なし 32 ビット整数を読み取ります。
戻り値uint —
値は 0 ~ 4294967295 です。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readUnsignedShort | () | メソッド |
public function readUnsignedShort():uintソケットから符号なし 16 ビット整数を読み取ります。
戻り値uint —
値は 0 ~ 65535 です。
|
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readUTF | () | メソッド |
public function readUTF():Stringソケットから UTF-8 ストリングを読み取ります。このストリングには、バイト単位で長さを示す符号なし short 型整数が接頭辞として付くことが前提となっています。
戻り値String |
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| readUTFBytes | () | メソッド |
public function readUTFBytes(length:uint):String
ソケットから length パラメータで指定した UTF-8 バイト数を読み取り、ストリングを返します。
length:uint — 読み取るバイト数です。
|
String |
EOFError — 読み取り可能なデータが十分ではありません。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
| writeBoolean | () | メソッド |
public function writeBoolean(value:Boolean):void
ソケットにブール値を書き込みます。このメソッドは 1 バイトを書き込みます。true の場合は 1 を、false の場合は 0 を書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:Boolean — ソケットに書き込まれる値は、1 (true の場合) または 0 (false の場合) です。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeByte | () | メソッド |
public function writeByte(value:int):voidソケットに書き込むバイトです。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:int — ソケットに書き込む値です。値の下位 8 ビットが使用されます。上位 24 ビットは無視されます。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeBytes | () | メソッド |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
指定したバイト配列のバイトのシーケンスを書き込みます。書き込み操作は、offset で指定された位置から開始されます。
length パラメータを省略すると、デフォルトの配列の長さ 0 が使用され、メソッドによって offset から開始されるバッファ全体が書き込まれます。
offset パラメータも省略した場合は、バッファ全体が書き込まれます。
offset または length が範囲外の場合は、bytes 配列の最初と最後に調整されます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
bytes:ByteArray — データの書き込み元の ByteArray オブジェクトです。
|
|
offset:uint (default = 0) — データの書き込みが開始する、bytes ByteArray オブジェクトへのゼロから始まるオフセットです。
|
|
length:uint (default = 0) — 書き込むバイト数です。デフォルト値の 0 に設定すると、offset パラメータで指定した値で開始するバッファ全体が書き込まれます。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeDouble | () | メソッド |
public function writeDouble(value:Number):voidソケットに IEEE 754 倍精度浮動小数点数を書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:Number — ソケットに書き込む値です。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeFloat | () | メソッド |
public function writeFloat(value:Number):voidソケットに IEEE 754 単精度浮動小数点数を書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:Number — ソケットに書き込む値です。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeInt | () | メソッド |
public function writeInt(value:int):voidソケットに 32 ビット符号付き整数を書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:int — ソケットに書き込む値です。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeMultiByte | () | メソッド |
public function writeMultiByte(value:String, charSet:String):void指定した文字セットを使用して、バイトストリームからマルチバイトストリングを書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:String — 書き込まれるストリング値です。
|
|
charSet:String — バイトの解釈に使用する文字セットを表すストリングです。文字セットのストリングには、"shift_jis"、"CN-GB"、および "iso-8859-1" があります。完全な一覧については、「サポートする文字セット」を参照してください。
|
関連項目
| writeObject | () | メソッド |
public function writeObject(object:*):voidソケットに AMF 直列化形式でオブジェクトを書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
object:* — 直列化されるオブジェクトです。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeShort | () | メソッド |
public function writeShort(value:int):voidソケットに 16 ビット整数を書き込みます。次のバイトが書き込まれます。
(v >> 8) & 0xff v & 0xff
パラメータの下位 16 ビットが使用されます。上位 16 ビットは無視されます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:int — ソケットに書き込む値です。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeUnsignedInt | () | メソッド |
public function writeUnsignedInt(value:uint):voidソケットに 32 ビット符号なし整数を書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:uint — ソケットに書き込む値です。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeUTF | () | メソッド |
public function writeUTF(value:String):voidソケットに 16 ビット符号なし整数を書き込みます。これによって指定された UTF-8 ストリングの長さがバイト単位で示され、その後にストリングが続きます。
ストリングを書き込む前に、メソッドによってストリングのすべての文字を表すのに必要なバイト数が計算されます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:String — ソケットに書き込むストリングです。
|
RangeError — 長さが 65535 を超えています。
|
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| writeUTFBytes | () | メソッド |
public function writeUTFBytes(value:String):voidソケットに UTF-8 ストリングを書き込みます。
メモ:このメソッドで書き込まれるデータは、すぐには転送されません。flush() メソッドが呼び出されるまでキューに置かれます。
value:String — ソケットに書き込むストリングです。
|
IOError — ソケットで I/O エラーが発生したか、ソケットが開いていません。
|
関連項目
| close | event |
flash.events.Event
flash.events.Event.CLOSE
サーバーによりソケット接続が閉じられたときに送出されます。close イベントは、サーバーにより接続が閉じられたときのみ送出されます。Socket.close() メソッドを呼び出しても送出されません。
close イベントオブジェクトの type プロパティの値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target | 接続が閉じられたオブジェクトです。 |
| connect | event |
flash.events.Event
flash.events.Event.CONNECT
ネットワーク接続が確立されたときに送出されます。
connect イベントオブジェクトの type プロパティの値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target | ネットワーク接続を確立した Socket オブジェクトまたは XMLSocket オブジェクトです。 |
| ioError | event |
flash.events.IOErrorEvent
flash.events.IOErrorEvent.IO_ERROR
入出力エラーが発生して送信またはロード操作が失敗したときに送出されます。
ioError イベントオブジェクトの type プロパティの値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target | 入出力エラーが発生したネットワークオブジェクトです。 |
text | エラーメッセージとして表示されるテキストです。 |
| securityError | event |
flash.events.SecurityErrorEvent
flash.events.SecurityErrorEvent.SECURITY_ERROR
Socket.connect() の呼び出しによって、呼び出し元のセキュリティサンドボックスの外にあるサーバーや 1024 未満のポート番号に対して接続しようとしたときに送出されます。
SecurityErrorEvent.SECURITY_ERROR 定数は、securityError イベントオブジェクトの type プロパティ値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。 |
target | セキュリティエラーを報告するネットワークオブジェクトです。 |
text | エラーメッセージとして表示されるテキストです。 |
関連項目
| socketData | event |
flash.events.ProgressEvent
flash.events.ProgressEvent.SOCKET_DATA
ソケットがデータを受信したときに送出されます。socketData タイプのイベントでは、ProgressEvent.bytesTotal プロパティは使用されません。
socketData イベントオブジェクトの type プロパティの値を定義します。
このイベントには、次のプロパティがあります。
| プロパティ | 値 |
|---|---|
bubbles | false |
cancelable | false は、キャンセルするデフォルトの動作がないことを示します。 |
currentTarget | Event をアクティブに処理しているオブジェクトです。 |
bytesLoaded | リスナーがイベントを処理しているときにロードされたアイテム数またはバイト数です。 |
bytesTotal | 0。このプロパティは、socketData イベントオブジェクトによって使用されません。 |
target | 進行状況をレポートする Socket オブジェクトです。 |
socket という名前の CustomSocket インスタンスが作成され、
ホスト名 localhost とポート 80 がパラメータとして渡されます。CustomSocket は Socket を拡張したものなので、
super() の呼び出しでは、
ホスト名として localhost を使用し、ポート番号として 80 を使用して、Socket のコンストラクタが呼び出されます。configureListeners() メソッドが
呼び出されます。 メモ:この例を実行するには、
SWF が存在するドメインと同じドメインで実行される、ポート 80 でリッスンするサーバー (この例では、localhost) が必要です。
package {
import flash.display.Sprite;
public class SocketExample extends Sprite {
public function SocketExample() {
var socket:CustomSocket = 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(host, port);
configureListeners();
}
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();
}
}