javax.microedition.io
インタフェース UDPDatagramConnection

すべてのスーパーインタフェース:

Connection, DatagramConnection

public interface UDPDatagramConnection
extends DatagramConnection

このインタフェースは、ローカル端点アドレスを認識しているデータグラム接続を定義します。プロトコルはトランザクション指向であり、配信も重複の防止も保証されません。信頼性の高い順序付きのデータストリーム配信を必要とするアプリケーションは、SocketConnection を使用するべきです。

datagram:// URL 接続文字列をオープンする要求があった場合、それに対する応答として、Connector.open() から UDPDatagramConnection が返されます。接続文字列の URL 文字列内の host フィールドと port フィールドを両方とも省略した場合、システムによって使用可能なポートが割り当てられます。ローカルアドレスとローカルポートは、このインタフェース内のアクセス用メソッドを使用して検出できます。

ここで説明したデータグラム URL 接続文字列の構文は、送信する Datagram に宛先アドレスを割り当てるために使用する Datagram.setAddress() メソッドでも有効です (例: datagram://host:port)。

Connector.open() 文字列の BNF 形式

URI は、次に示す BNF 構文に準拠する必要があります。URI がこの構文に準拠していない場合、IllegalArgumentException がスローされます。

<datagram_connection_string>	::= "datagram://" | "datagram://"<hostport>
<hostport>	::= host ":"port
<host>	::= ホスト名または IP アドレス (着信接続では省略)
<port>	::= ポート番号の数値 (システム割り当てポートでは省略)

導入されたバージョン:

MIDP 2.0

メソッドの概要

String	getLocalAddress() データグラム接続のバインド先のローカルアドレスを取得します。
int	getLocalPort() このデータグラム接続のバインド先のローカルポートを返します。

インタフェース javax.microedition.io.DatagramConnection から継承されたメソッド

getMaximumLength, getNominalLength, newDatagram, newDatagram, newDatagram, newDatagram, receive, send

インタフェース javax.microedition.io.Connection から継承されたメソッド

close

メソッドの詳細

getLocalAddress

String getLocalAddress()
                       throws IOException

データグラム接続のバインド先のローカルアドレスを取得します。

これは、外部システムからこのデータグラム接続の端点に接続するためのホストアドレス (IP 番号) です。IP アドレスは動的に割り当て可能なので、IP 番号の再割り当てを考慮して、堅牢なリモートアプリケーションを使用する必要があります。

ローカルホスト名 (使用可能な場合) には、System.getProperty("microedition.hostname") からアクセスできます。

戻り値:

データグラム接続のバインド先のローカルアドレス

例外:

IOException - 接続が終了した場合

関連項目:

ServerSocketConnection

getLocalPort

int getLocalPort()
                 throws IOException

このデータグラム接続のバインド先のローカルポートを返します。

戻り値:

このデータグラム接続の接続先のローカルポート番号

例外:

IOException - 接続が終了した場合

関連項目:

ServerSocketConnection