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

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

public interface DatagramConnection
extends Connection

このインタフェースでは、データグラム接続に必要な機能を定義します。

接続先を記述するパラメータの文字列に適用される形式は次のとおりです。

{protocol}:[//{host}]:{port}
データグラム接続は、「クライアント」モードと「サーバ」モードのどちらでも開始できます。//{host} を省略すると、接続は「サーバ」モードで開始されます (「サーバ」モードとは、クライアントのアプリケーションによって通信が開始されるという意味です)。//{host} を指定すると、接続はクライアントモードで開始されます。

データグラムを受信するためのデータグラム接続
datagram://:1234

サーバに送信するためのデータグラム接続
datagram://123.456.789.12:1234

「サーバモード」 (ホスト名の指定なし) のポート番号は、受信ポートのポート番号です。「クライアントモード」 (ホスト名の指定あり) のポート番号は、宛先ポートのポート番号です。どちらの場合も応答先ポートは指定されません。「サーバモード」では、送信と受信の両方に同じポートを使用します。「クライアントモード」では、応答先ポートは必ず動的に割り当てられます。


メソッドの概要
 int getMaximumLength()
          データグラムがとり得る最大の長さを取得します。
 int getNominalLength()
          データグラムの標準の長さを取得します。
 Datagram newDatagram(byte[] buf, int size)
          新しいデータグラムオブジェクトを作成します。
 Datagram newDatagram(byte[] buf, int size, String addr)
          新しいデータグラムオブジェクトを作成します。
 Datagram newDatagram(int size)
          新しいデータグラムオブジェクトに対して自動的にバッファを割り当てます。
 Datagram newDatagram(int size, String addr)
          新しいデータグラムオブジェクトを作成します。
 void receive(Datagram dgram)
          データグラムを受信します。
 void send(Datagram dgram)
          データグラムを送信します。
 
インタフェース javax.microedition.io.Connection から継承したメソッド
close
 

メソッドの詳細

getMaximumLength

public int getMaximumLength()
                     throws IOException
データグラムがとり得る最大の長さを取得します。
戻り値:
長さ

getNominalLength

public int getNominalLength()
                     throws IOException
データグラムの標準の長さを取得します。
戻り値:
長さ

send

public void send(Datagram dgram)
          throws IOException
データグラムを送信します。
パラメータ:
dgram - データグラム
例外:
IOException - 入出力エラーが発生した場合
InterruptedIOException - タイムアウトまたは未処理の入出力を伴う接続の終了

receive

public void receive(Datagram dgram)
             throws IOException
データグラムを受信します。
パラメータ:
dgram - データグラム
例外:
IOException - 入出力エラーが発生した場合
InterruptedIOException - タイムアウトまたは未処理の入出力を伴う接続の終了

newDatagram

public Datagram newDatagram(int size)
                     throws IOException
新しいデータグラムオブジェクトに対して自動的にバッファを割り当てます。
パラメータ:
size - データグラムに割り当てられるバッファの長さ
戻り値:
新しいデータグラム

newDatagram

public Datagram newDatagram(int size,
                            String addr)
                     throws IOException
新しいデータグラムオブジェクトを作成します。
パラメータ:
size - 使用されるのバッファの長さ
addr - データグラムの送信先アドレス
戻り値:
新しいデータグラム

newDatagram

public Datagram newDatagram(byte[] buf,
                            int size)
                     throws IOException
新しいデータグラムオブジェクトを作成します。
パラメータ:
buf - データグラム内で使用されるバッファ
size - データグラムに割り当てられるバッファの長さ
戻り値:
新しいデータグラム
例外:
IllegalArgumentException - 長さが負の値である場合、またはバッファより大きい場合

newDatagram

public Datagram newDatagram(byte[] buf,
                            int size,
                            String addr)
                     throws IOException
新しいデータグラムオブジェクトを作成します。
パラメータ:
buf - データグラム内で使用されるバッファ
size - 使用されるバッファの長さ
addr - データグラムの送信先アドレス
戻り値:
新しいデータグラム
例外:
IllegalArgumentException - 長さが負の値である場合、またはバッファより大きい場合