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 のパケットを、指定されたホストの指定されたポート番号に送信するためのデータグラムパケットを構築します。

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

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

メソッドの概要

InetAddress	getAddress() このデータグラムの送信先であるマシン、またはデータグラムの送信元であるマシンの IP アドレスを返します。
byte[]	getData() データバッファを返します。
int	getLength() 送信するデータの長さ、または受信したデータの長さを返します。
int	getOffset() 送信するデータのオフセット、または受信したデータのオフセットを返します。
int	getPort() このデータグラムの送信先、またはデータグラムの送信元の、リモートホスト上のポート番号を返します。
SocketAddress	getSocketAddress() このパケットの送信先または送信元であるリモートホストの SocketAddress (通常は IP アドレス + ポート番号) を取得します。
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) このデータグラムの送信先であるリモートホストのポート番号を設定します。
void	setSocketAddress(SocketAddress address) このデータグラムの送信先であるリモートホストの SocketAddress (通常は IP アドレス + ポート番号) を設定します。

クラス 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 offset,
                      int length,
                      SocketAddress address)
               throws SocketException

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

パラメータ:

buf - パケットデータ

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

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

address - 転送先ソケットアドレス

例外:

SocketException - アドレス型がサポートされていない場合

導入されたバージョン:

1.4

関連項目:

InetAddress

DatagramPacket

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

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

パラメータ:

buf - パケットデータ

length - パケットの長さ

address - 転送先アドレス

port - 転送先ポート番号

関連項目:

InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int length,
                      SocketAddress address)
               throws SocketException

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

パラメータ:

buf - パケットデータ

length - パケットの長さ

address - 転送先アドレス

例外:

SocketException - アドレス型がサポートされていない場合

導入されたバージョン:

1.4

関連項目:

InetAddress

メソッドの詳細

getAddress

public InetAddress getAddress()

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

戻り値:

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

関連項目:

InetAddress, setAddress(java.net.InetAddress)

getPort

public int getPort()

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

戻り値:

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

関連項目:

setPort(int)

getData

public byte[] getData()

データバッファを返します。受信したデータまたは送信するデータはバッファの offset から開始し、length の間動作します。

戻り値:

データを受信または送信するのに使うバッファ

関連項目:

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

関連項目:

getPort()

setSocketAddress

public void setSocketAddress(SocketAddress address)

このデータグラムの送信先であるリモートホストの SocketAddress (通常は IP アドレス + ポート番号) を設定します。

パラメータ:

address - SocketAddress

例外:

IllegalArgumentException - アドレスが null である場合、またはアドレスがこのソケットでサポートされていない SocketAddress サブクラスである場合

導入されたバージョン:

1.4

関連項目:

getSocketAddress()

getSocketAddress

public SocketAddress getSocketAddress()

このパケットの送信先または送信元であるリモートホストの SocketAddress (通常は IP アドレス + ポート番号) を取得します。

戻り値:

SocketAddress

導入されたバージョン:

1.4

関連項目:

setSocketAddress(java.net.SocketAddress)

setData

public void setData(byte[] buf)

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

パラメータ:

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)