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

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

Connection

public interface DatagramConnection
extends Connection

データグラムによる接続に必要な機能を定義するインタフェースです。

接続先（アドレス）は“{protocol}:[//{host}]:{port}”という形式で記述します。

{protocol} には接続に使用するプロトコル名を指定します。 （使用可能なプロトコル名はデバイスの実装に依存します。）

[//{host}] には接続先のホストアドレスを指定します。 この記述を省略した場合、サーバー・モードによる接続となります。

{port} には接続先のポート番号を指定します。このポート番号はサーバー・モードの場合は Listen 状態に置くポート番号を指します。 クライアント・モードの場合は相手先のポート番号を指します。

サーバー・モードでは送信と受信の両方に同一のポート番号を使用します。 クライアント・モードでは使用するポートは動的にデバイス側の実装によって決定されます。

getMaximumLength

int getMaximumLength()
                     throws IOException

データグラムとして送受信可能な最大の長さを返します。

戻り値:

送受信可能な最大の長さを返します。

例外:

IOException

getNominalLength

int getNominalLength()
                     throws IOException

データグラムの公称の長さを返します。

戻り値:

公称の長さを返します。

例外:

IOException

send

void send(Datagram data)
          throws IOException

データグラムを送信します。

パラメータ:

data - 送信するデータグラムを渡します。

例外:

InterruptedIOException - タイムアウトあるいは未送信のデータが存在した状態で処理が終了した場合に throw します。

IOException - それ以外の入出力関連の問題が発生した場合に throw します。

receive

void receive(Datagram data)
             throws IOException

データグラムを受信します。

パラメータ:

data - 受信したデータグラムを受け取るオブジェクトを渡します。

例外:

InterruptedIOException - タイムアウトあるいは未受信のデータが存在した状態で処理が終了した場合に throw します。

IOException - それ以外の入出力関連の問題が発生した場合に throw します。

newDatagram

Datagram newDatagram(int size)
                     throws IOException

指定したサイズのバッファを割り当てられた、新しい Datagram オブジェクトを生成します。

パラメータ:

size - 割り当てるバッファのサイズを渡します。

戻り値:

指定されたサイズのバッファを持ったオブジェクトを返します。

例外:

IOException - 入出力関連の問題が発生した場合に throw します。

newDatagram

Datagram newDatagram(int size,
                     String address)
                     throws IOException

指定したサイズのバッファが割り当てられ、指定した宛先アドレスを持った新しい Datagram オブジェクトを生成します。

パラメータ:

size - 割り当てるバッファのサイズを渡します。

address - 宛先アドレスを渡します。

戻り値:

指定されたサイズのバッファを持ち、指定された宛先アドレスが設定されたオブジェクトを返します。

例外:

IOException - 入出力関連の問題が発生した場合に throw します。

newDatagram

Datagram newDatagram(byte[] buffer,
                     int size)
                     throws IOException

指定されたバッファとそのサイズが設定された Datagram オブジェクトを生成します。

パラメータ:

buffer - データグラムで使用するバッファを渡します。

size - データグラムに割り当てるバッファのサイズを渡します。

戻り値:

指定されたバッファとそのサイズが設定されたオブジェクトを返します。

例外:

IOException - 入出力関連の問題が発生した場合に throw します。

IllegalArgumentException - 指定されたサイズが不適切な場合に throw します。

newDatagram

Datagram newDatagram(byte[] buffer,
                     int size,
                     String address)
                     throws IOException

指定されたバッファとそのサイズおよび宛先アドレスが設定された Datagram オブジェクトを生成します。

パラメータ:

buffer - データグラムで使用するバッファを渡します。

size - データグラムに割り当てるバッファのサイズを渡します。

address - 宛先アドレスを渡します。

戻り値:

指定されたバッファとそのサイズが設定されたオブジェクトを返します。

例外:

IOException - 入出力関連の問題が発生した場合に throw します。

IllegalArgumentException - 指定されたサイズが不適切な場合に throw します。