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

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

public interface Datagram
extends DataInput, DataOutput

汎用データグラムインタフェースです。これは、データグラム接続からの送信または受信の対象となるデータのホルダとして機能するオブジェクトを表します。DataInput インタフェースおよび DataOutput インタフェースはこのインタフェースによって拡張され、これにより、データグラムバッファに対するバイナリデータの読み取りと書き込みが簡単になります。バッファの先頭の読み取りまたは書き込みポイントをリセットする場合は、専用の関数 reset() を呼び出すことができます。


メソッドの概要
 String getAddress()
          データグラム内のアドレスを取得します。
 byte[] getData()
          バッファを取得します。
 int getLength()
          長さを取得します。
 int getOffset()
          オフセットを取得します。
 void reset()
          読み取りおよび書き込みポインタをリセットして、オフセットと長さのパラメータをゼロにします。
 void setAddress(Datagram reference)
          データグラムアドレスを設定して、別のデータグラムからアドレスをコピーします。
 void setAddress(String addr)
          データグラムアドレスを設定します。
 void setData(byte[] buffer, int offset, int len)
          バッファ、オフセット、および長さを設定します。
 void setLength(int len)
          長さを設定します。
 
インタフェース java.io.DataInput から継承したメソッド
readBoolean, readByte, readChar, readFully, readFully, readInt, readLong, readShort, readUnsignedByte, readUnsignedShort, readUTF, skipBytes
 
インタフェース java.io.DataOutput から継承したメソッド
write, write, write, writeBoolean, writeByte, writeChar, writeChars, writeInt, writeLong, writeShort, writeUTF
 

メソッドの詳細

getAddress

public String getAddress()
データグラム内のアドレスを取得します。
戻り値:
文字列形式のアドレス。アドレスが設定されていない場合は null

getData

public byte[] getData()
バッファを取得します。
戻り値:
データバッファ

getLength

public int getLength()
長さを取得します。
戻り値:
データの長さ

getOffset

public int getOffset()
オフセットを取得します。
戻り値:
データバッファ内のオフセット

setAddress

public void setAddress(String addr)
                throws IOException
データグラムアドレスを設定します。 データグラムのターゲットを記述するパラメータの文字列に適用される形式は次のとおりです。
     {protocol}:{target}
たとえば、target は //{host}:{port} にすることができます (ただし、これに限りません)。
したがってこの例では、サーバに送信するためのデータグラム接続のアドレスを次のように指定できます。
     datagram://123.456.789.12:1234
データグラムのアドレスを指定しないと、そのアドレスのデフォルト値は接続のアドレスになります。
パラメータ:
addr - URL として指定する新しいターゲットアドレス
例外:
IllegalArgumentException - アドレスが無効な場合

setAddress

public void setAddress(Datagram reference)
データグラムアドレスを設定して、別のデータグラムからアドレスをコピーします。
パラメータ:
reference - このデータグラムの新しいターゲットアドレスとしてコピーされるアドレスを持つデータグラム
例外:
IllegalArgumentException - アドレスが無効な場合

setLength

public void setLength(int len)
長さを設定します。
パラメータ:
len - データの新しい長さ
例外:
IllegalArgumentException - 長さが負の値である場合、またはバッファより大きい場合

setData

public void setData(byte[] buffer,
                    int offset,
                    int len)
バッファ、オフセット、および長さを設定します。
パラメータ:
addr - データバッファ
offset - データバッファ内のオフセット
len - バッファ内のデータの長さ
例外:
IllegalArgumentException - 長さまたはオフセットがバッファの大きさを超える場合

reset

public void reset()
読み取りおよび書き込みポインタをリセットして、オフセットと長さのパラメータをゼロにします。