java.net
クラス DatagramPacket

java.lang.Object
  |
  +--java.net.DatagramPacket

public final class DatagramPacket

extends Object

このクラスはデータグラムパケットを表します。

データグラムパケットは、無接続パケット配布サービスを実装する際に使用します。各メッセージは、パケット内に含まれている情報だけを基に、あるマシンから別のマシンへ送信されます。あるマシンから別のマシンに複数のパケットを送信する場合、各パケットは異なる経路で送信される可能性があり、宛先には無作為の順序で到達する可能性があります。

導入されたバージョン:

JDK1.0

コンストラクタの概要

DatagramPacket(byte[] buf, int length)
長さが length のパケットを受信するための DatagramPacket を構築します。

DatagramPacket(byte[] buf, int length, InetAddress address, int port)
指定されたホストの指定されたポート番号に長さ length のパケットを送信するための、データグラムパケットを構築します。

DatagramPacket(byte[] buf, int offset, int length)
バッファへのオフセットを指定して、長さが length のパケットを受信するための DatagramPacket を構築します。

DatagramPacket(byte[] buf, int offset, int length, InetAddress address, int port)
長さが length でオフセットが ioffset のパケットを、指定されたホストの指定されたポート番号に送信するためのデータグラムパケットを構築します。

メソッドの概要

InetAddress	getAddress() このデータグラムの送信先であるマシン、またはデータグラムの送信元であるマシンの IP アドレスを返します。
byte[]	getData() 受信したデータまたは送信するデータを返します。
int	getLength() 送信するデータの長さ、または受信したデータの長さを返します。
int	getOffset() 送信するデータのオフセット、または受信したデータのオフセットを返します。
int	getPort() このデータグラムの送信先、またはデータグラムの送信元の、リモートホスト上のポート番号を返します。
void	setAddress(InetAddress iaddr)
void	setData(byte[] buf) このパケット用のデータバッファを設定します。
void	setData(byte[] buf, int offset, int length) このパケット用のデータバッファを設定します。
void	setLength(int length) このパケットの長さを設定します。
void	setPort(int iport)

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

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

コンストラクタの詳細

DatagramPacket

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

バッファへのオフセットを指定して、長さが length のパケットを受信するための DatagramPacket を構築します。

引数 length の値は、buf.length の値以下でなければなりません。

パラメータ:

buf - 着信データグラムを保持するためのバッファ

offset - バッファへのオフセット

length - 読み込むバイト数

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length)

長さが length のパケットを受信するための DatagramPacket を構築します。

引数 length の値は、buf.length の値以下でなければなりません。

パラメータ:

buf - 着信データグラムを保持するためのバッファ

length - 読み込むバイト数

DatagramPacket

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

長さが length でオフセットが ioffset のパケットを、指定されたホストの指定されたポート番号に送信するためのデータグラムパケットを構築します。引数 length の値は、buf.length の値以下でなければなりません。

パラメータ:

buf - パケットデータ

offset - パケットデータのオフセット

length - パケットデータの長さ

addr - 宛先アドレス

port - 宛先ポート番号

関連項目:

InetAddress

DatagramPacket

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

指定されたホストの指定されたポート番号に長さ length のパケットを送信するための、データグラムパケットを構築します。引数 length の値は、buf.length の値以下でなければなりません。

パラメータ:

buf - パケットデータ

length - パケットの長さ

addr - 宛先アドレス

port - 宛先ポート番号

関連項目:

InetAddress

メソッドの詳細

getAddress

public InetAddress getAddress()

このデータグラムの送信先であるマシン、またはデータグラムの送信元であるマシンの IP アドレスを返します。

戻り値:

このデータグラムの送信先であるマシン、またはデータグラムの送信元であるマシンの IP アドレス

関連項目:

InetAddress

getPort

public int getPort()

このデータグラムの送信先、またはデータグラムの送信元の、リモートホスト上のポート番号を返します。

戻り値:

このデータグラムの送信先、またはデータグラムの送信元の、リモートホスト上のポート番号

getData

public byte[] getData()

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

戻り値:

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

getOffset

public int getOffset()

送信するデータのオフセット、または受信したデータのオフセットを返します。

戻り値:

送信するデータのオフセット、または受信したデータのオフセット

getLength

public int getLength()

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

戻り値:

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

setData

public void setData(byte[] buf,
                    int offset,
                    int length)

このパケット用のデータバッファを設定します。パケットのデータ、長さ、およびオフセットを設定します。

パラメータ:

buf - このパケット用として設定するバッファ

offset - データへのオフセット

length - データの長さ

例外:

NullPointerException - 引数が null の場合

導入されたバージョン:

JDK1.1

関連項目:

getData(), getOffset(), getLength()

setAddress

public void setAddress(InetAddress iaddr)

導入されたバージョン:

JDK1.1

setPort

public void setPort(int iport)

導入されたバージョン:

JDK1.1

setData

public void setData(byte[] buf)

このパケット用のデータバッファを設定します。パケットの length による長さの値がこのメソッドの length 引数よりも大きい場合、パケットの length はこの引数の length の値に設定し直されます。

パラメータ:

buf - このパケット用として設定するバッファ

例外:

NullPointerException - 引数が null の場合

導入されたバージョン:

JDK1.1

関連項目:

getLength(), getData()

setLength

public void setLength(int length)

このパケットの長さを設定します。パケットの長さは、送信されるパケットのデータバッファにあるバイト数、あるいはデータの受信に使うパケット用データバッファのバイト数です。length の値は、パケットのバッファの length の値以下でなければなりません。

パラメータ:

length - このパケット用として設定する長さ

例外:

IllegalArgumentException - length が負の値の場合、あるいはパケットのデータバッファより大きい場合

導入されたバージョン:

JDK1.1

関連項目:

getLength(), setData(byte[], int, int)