java.net
クラス DatagramPacket

java.lang.Object
  java.net.DatagramPacket

public class DatagramPacket
extends Object

DatagramPacket クラスは Datagram パケットを表します。

コンストラクタの概要

DatagramPacket(byte[] buf, int length)
指定された長さのパケットを受信するための DatagramPacket を生成します。

DatagramPacket(byte[] buf, int length, InetAddress address, int port)
指定されたアドレスとポートに送信する、指定された長さの DatagramPacket を生成します。

DatagramPacket(byte[] buf, int offset, int length, InetAddress address, int port)
指定されたアドレスとポートに送信する、指定された長さの DatagramPacket を生成します。

メソッドの概要

InetAddress	getAddress() このデータグラムパケットのIPアドレスを返します。
byte[]	getData() データバッファを返します。
int	getLength() 送信するデータ長、または受信したデータ長を返します。
int	getOffset() データバッファのオフセットを返します
int	getPort() このデータグラムパケットのポート番号を返します。
void	setAddress(InetAddress iaddr) このデータグラムパケットを送信する先のIPアドレスを設定します。
void	setData(byte[] buf) このデータグラムパケットにデータバッファを設定します。
void	setLength(int length) このデータグラムパケットの長さを設定します。
void	setPort(int port) このデータグラムパケットを送信する先のポート番号を設定します。

クラス java.lang.Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait

コンストラクタの詳細

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length)

指定された長さのパケットを受信するための DatagramPacket を生成します。

各パラメータに不正な値を指定をしても例外は発生しませんが、 そのオブジェクトを使用した場合の振る舞いは保証されません。

パラメータ:

buf - 着信する datagram を保持するためのバッファ

length - 読み込むバイト長。 buf.length 以下の値でなくてはなりません

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length,
                      InetAddress address,
                      int port)

指定されたアドレスとポートに送信する、指定された長さの DatagramPacket を生成します。

各パラメータに不正な値を指定をしても例外は発生しませんが、 そのオブジェクトを使用した場合の振る舞いは保証されません。

パラメータ:

buf - 送信するパケットデータを保持する配列

length - パケット長。 buf.length 以下の値でなくてはなりません

address - 送信先アドレス

port - 送信先ポート

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      InetAddress address,
                      int port)

指定されたアドレスとポートに送信する、指定された長さの DatagramPacket を生成します。

各パラメータに不正な値を指定をしても例外は発生しませんが、 そのオブジェクトを使用した場合の振る舞いは保証されません。

パラメータ:

buf - 送信するパケットデータを保持する配列

offset - 送信するパケットデータの、配列 buf 内のオフセット

length - パケット長。 offset+length < buf.length でなくてはいけません

address - 送信先アドレス

port - 送信先ポート

メソッドの詳細

getData

public byte[] getData()

データバッファを返します。 データバッファに格納されているデータ（受信データまたは送信データ）は getOffset メソッドが返すオフセットから、 getLength メソッドが返す長さの領域にあります。

戻り値:

送信するデータ、または受信データを格納しているバッファ

setData

public void setData(byte[] buf)

このデータグラムパケットにデータバッファを設定します。 データのオフセットは 0、データ長は buf.length に設定されます。

パラメータ:

buf - データバッファ

例外:

NullPointerException - buf が null の場合

setLength

public void setLength(int length)

このデータグラムパケットの長さを設定します。 設定する長さは、このデータグラムパケットが送信用であれば送信パケットの長さ、受信用であればデータバッファ内で使用するバッファ長です。

パラメータ:

length - データグラムパケットの長さ。 「データバッファのオフセット +length < データバッファ長」 でなくてはなりません。 このパラメータに0以下を指定した場合の振る舞いは保証されません。

getLength

public int getLength()

送信するデータ長、または受信したデータ長を返します。

戻り値:

送信するデータ長、または受信したデータ長

getAddress

public InetAddress getAddress()

このデータグラムパケットのIPアドレスを返します。

戻り値:

このデータグラムパケットの送信先のIPアドレス、またはこのデータグラムパケットを受信した送信元のIPアドレス

setAddress

public void setAddress(InetAddress iaddr)

このデータグラムパケットを送信する先のIPアドレスを設定します。

パラメータ:

iaddr - 送信先IPアドレス

getPort

public int getPort()

このデータグラムパケットのポート番号を返します。

戻り値:

このデータグラムパケットの送信先のポート番号、またはこのデータグラムパケットを受信した送信元のポート番号

setPort

public void setPort(int port)

このデータグラムパケットを送信する先のポート番号を設定します。

パラメータ:

port - 送信先ポート番号。 このパラメータに有効なポート番号以外を指定した場合の振る舞いは保証されません。

getOffset

public int getOffset()

データバッファのオフセットを返します

戻り値:

送信データが格納されているオフセット位置、または受信データを格納するオフセット位置