JavaTM 2
Platform
Std. Ed. v1.4.0

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)

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.