JavaTM Platform
Standard Ed. 6

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、オフセット offset のパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラムパケットを構築します。
DatagramPacket(byte[] buf, int offset, int length, SocketAddress address)
          長さ length、オフセット offset のパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラムパケットを構築します。
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 - 読み込むバイト数
導入されたバージョン:
1.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、オフセット offset のパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラムパケットを構築します。引数 length の値は、buf.length の値以下でなければなりません。

パラメータ:
buf - パケットデータ
offset - パケットデータのオフセット
length - パケットデータの長さ
address - 転送先アドレス
port - 転送先ポート番号
導入されたバージョン:
1.2
関連項目:
InetAddress

DatagramPacket

public DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      SocketAddress address)
               throws SocketException
長さ length、オフセット offset のパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラムパケットを構築します。引数 length の値は、buf.length の値以下でなければなりません。

パラメータ:
buf - パケットデータ
offset - パケットデータのオフセット
length - パケットデータの長さ
address - 転送先ソケットアドレス
例外:
IllegalArgumentException - アドレス型がサポートされていない場合
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 - 転送先アドレス
例外:
IllegalArgumentException - アドレス型がサポートされていない場合
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()
送信するデータのオフセット、または受信したデータのオフセットを返します。

戻り値:
送信するデータのオフセット、または受信したデータのオフセット
導入されたバージョン:
1.2

getLength

public int getLength()
送信するデータの長さ、または受信したデータの長さを返します。

戻り値:
送信するデータの長さ、または受信したデータの長さ
関連項目:
setLength(int)

setData

public void setData(byte[] buf,
                    int offset,
                    int length)
このパケットのデータバッファーを設定します。これにより、パケットのデータ、長さ、およびオフセットが設定されます。

パラメータ:
buf - このパケット用として設定するバッファー
offset - データへのオフセット
length - データの長さまたはデータ受信に使用するバッファーの長さ、あるいはその両方
例外:
NullPointerException - 引数が null の場合
導入されたバージョン:
1.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 - このパケット用として設定する長さ
例外:
IllegalArgumentException - length が負の場合、または length がパケットのデータバッファーよりも大きい場合 length
導入されたバージョン:
JDK1.1
関連項目:
getLength(), setData(byte[], int, int)

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。