public final class DatagramPacket extends Object
データグラム・パケットは、無接続パケット配布サービスを実装する際に使用します。 各メッセージは、パケット内に含まれている情報だけを基に、あるマシンから別のマシンへ送信されます。 あるマシンから別のマシンに複数のパケットが送信される場合、それらの各パケットは異なる経路で送信される可能性があり、その到着順序もさまざまな可能性があります。 パケットの配信は保証されません。
| コンストラクタ | 説明 | 
|---|---|
| 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アドレス+ポート番号)を設定します。 | 
public DatagramPacket(byte[] buf,
                      int offset,
                      int length)
lengthのパケットを受信するためのDatagramPacketを構築します。
 
 引数lengthの値は、buf.lengthの値以下である必要があります。
buf - 着信データグラムを保持するためのバッファ。offset - バッファへのオフセットlength - 読み込むバイト数。public DatagramPacket(byte[] buf,
                      int length)
lengthのパケットを受信するためのDatagramPacketを構築します。
 
 引数lengthの値は、buf.lengthの値以下である必要があります。
buf - 着信データグラムを保持するためのバッファ。length - 読み込むバイト数。public DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      InetAddress address,
                      int port)
length、オフセットioffsetのパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラム・パケットを構築します。 引数lengthの値は、buf.lengthの値以下である必要があります。 buf - パケット・データ。offset - パケット・データのオフセット。length - パケット・データの長さ。address - 転送先アドレス。port - 転送先ポート番号。InetAddresspublic DatagramPacket(byte[] buf,
                      int offset,
                      int length,
                      SocketAddress address)
length、オフセットioffsetのパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラム・パケットを構築します。 引数lengthの値は、buf.lengthの値以下である必要があります。 buf - パケット・データ。offset - パケット・データのオフセット。length - パケット・データの長さ。address - 転送先ソケット・アドレス。IllegalArgumentException - アドレス型がサポートされていない場合InetAddresspublic DatagramPacket(byte[] buf,
                      int length,
                      InetAddress address,
                      int port)
lengthのパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラム・パケットを構築します。 引数lengthの値は、buf.lengthの値以下である必要があります。 buf - パケット・データ。length - パケットの長さ。address - 転送先アドレス。port - 転送先ポート番号。InetAddresspublic DatagramPacket(byte[] buf,
                      int length,
                      SocketAddress address)
lengthのパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラム・パケットを構築します。 引数lengthの値は、buf.lengthの値以下である必要があります。 buf - パケット・データ。length - パケットの長さ。address - 転送先アドレス。IllegalArgumentException - アドレス型がサポートされていない場合InetAddresspublic InetAddress getAddress()
InetAddress、setAddress(java.net.InetAddress)public int getPort()
setPort(int)public byte[] getData()
offsetから始まり、lengthの長さだけ続きます。 setData(byte[], int, int)public int getOffset()
public int getLength()
setLength(int)public void setData(byte[] buf,
                    int offset,
                    int length)
buf - このパケット用として設定するバッファoffset - データへのオフセットlength - データの長さまたはデータ受信に使用するバッファの長さ、あるいはその両方NullPointerException - 引数がnullの場合getData(), getOffset(), getLength()public void setAddress(InetAddress iaddr)
iaddr - InetAddressgetAddress()public void setPort(int iport)
iport - ポート番号getPort()public void setSocketAddress(SocketAddress address)
address - SocketAddressIllegalArgumentException - アドレスがnullであるか、このソケットによってサポートされていないSocketAddressサブクラスである場合getSocketAddress()public SocketAddress getSocketAddress()
SocketAddresssetSocketAddress(java.net.SocketAddress)public void setData(byte[] buf)
bufの長さに、それぞれ設定されます。 buf - このパケット用として設定するバッファ。NullPointerException - 引数がnullの場合。getLength(), getData()public void setLength(int length)
length - このパケット用として設定する長さ。IllegalArgumentException - lengthが負の場合、またはlengthがパケットのデータ・バッファの長さよりも大きい場合。getLength(), setData(byte[], int, int) バグまたは機能を送信 
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。 
 Copyright © 1993, 2025, Oracle and/or its affiliates.  All rights reserved.  Use is subject to license terms.  Documentation Redistribution Policyも参照してください。