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) このデータグラムの送信先であるマシンの IP アドレスを設定します。
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 - 読み込むバイト数

導入されたバージョン:

JDK1.2

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 - パケットデータの長さ

address - 転送先アドレス

port - 転送先ポート番号

導入されたバージョン:

JDK1.2

関連項目:

InetAddress

DatagramPacket

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

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

パラメータ:

buf - パケットデータ

length - パケットの長さ

address - 転送先アドレス

port - 転送先ポート番号

関連項目:

InetAddress

メソッドの詳細

getAddress

public InetAddress getAddress()

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

戻り値:

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

関連項目:

InetAddress, setAddress(java.net.InetAddress)

getPort

public int getPort()

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

戻り値:

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

関連項目:

setPort(int)

getData

public byte[] getData()

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

戻り値:

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

関連項目:

setData(byte[], int, int)

getOffset

public int getOffset()

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

戻り値:

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

導入されたバージョン:

JDK1.2

getLength

public int getLength()

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

戻り値:

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

関連項目:

setLength(int)

setData

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

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

パラメータ:

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

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

length - データの長さ

例外:

NullPointerException - 引数が null の場合

導入されたバージョン:

JDK1.2

関連項目:

getData(), getOffset(), getLength()

setAddress

public void setAddress(InetAddress iaddr)

このデータグラムの送信先であるマシンの IP アドレスを設定します。

パラメータ:

iaddr - InetAddress

導入されたバージョン:

JDK1.1

関連項目:

getAddress()

setPort

public void setPort(int iport)

このデータグラムの送信先であるリモートホストのポート番号を設定します。

パラメータ:

iport - ポート番号

導入されたバージョン:

JDK1.1

関連項目:

setPort(int)

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)