モジュール java.base
パッケージ java.net

クラスDatagramPacket

java.lang.Object
java.net.DatagramPacket
public final class DatagramPacket
extends Object
このクラスはデータグラム・パケットを表します。

データグラム・パケットは、無接続パケット配布サービスを実装する際に使用します。 各メッセージは、パケット内に含まれている情報だけを基に、あるマシンから別のマシンへ送信されます。 あるマシンから別のマシンに複数のパケットが送信される場合、それらの各パケットは異なる経路で送信される可能性があり、その到着順序もさまざまな可能性があります。 パケットの配信は保証されません。

導入されたバージョン:
1.0

  • コンストラクタのサマリー

    コンストラクタ 
    コンストラクタ 説明
    DatagramPacket​(byte[] buf, int length)
    長さがlengthのパケットを受信するためのDatagramPacketを構築します。
    DatagramPacket​(byte[] buf, int offset, int length)
    バッファへのオフセットを指定して、長さがlengthのパケットを受信するためのDatagramPacketを構築します。
    DatagramPacket​(byte[] buf, int offset, int length, InetAddress address, int port)
    指定されたホスト上の指定されたポート番号にオフセットoffsetを使用してlengthの長さのパケットを送信するためにデータグラム・パケットを構築します。
    DatagramPacket​(byte[] buf, int offset, int length, SocketAddress address)
    指定されたホスト上の指定されたポート番号にオフセットoffsetを使用してlengthの長さのパケットを送信するためにデータグラム・パケットを構築します。
    DatagramPacket​(byte[] buf, int length, InetAddress address, int port)
    長さlengthのパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラム・パケットを構築します。
    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)
      指定されたホスト上の指定されたポート番号にオフセットoffsetを使用してlengthの長さのパケットを送信するためにデータグラム・パケットを構築します。 引数lengthの値は、buf.lengthの値以下である必要があります。
      パラメータ:
      buf - パケット・データ。
      offset - パケット・データのオフセット。
      length - パケット・データの長さ。
      address - 転送先アドレス。
      port - 転送先ポート番号。
      導入されたバージョン:
      1.2
      関連項目:
      InetAddress

    • DatagramPacket

      public DatagramPacket​(byte[] buf, int offset, int length, SocketAddress address)
      指定されたホスト上の指定されたポート番号にオフセットoffsetを使用してlengthの長さのパケットを送信するためにデータグラム・パケットを構築します。 引数lengthの値は、buf.lengthの値以下である必要があります。
      パラメータ:
      buf - パケット・データ。
      offset - パケット・データのオフセット。
      length - パケット・データの長さ。
      address - 転送先ソケット・アドレス。
      例外:
      IllegalArgumentException - アドレス型がサポートされていない場合
      導入されたバージョン:
      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)
      長さlengthのパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラム・パケットを構築します。 引数lengthの値は、buf.lengthの値以下である必要があります。
      パラメータ:
      buf - パケット・データ。
      length - パケットの長さ。
      address - 転送先アドレス。
      例外:
      IllegalArgumentException - アドレス型がサポートされていない場合
      導入されたバージョン:
      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
      導入されたバージョン:
      1.1
      関連項目:
      getAddress()

    • setPort

      public void setPort​(int iport)
      このデータグラムの送信先であるリモート・ホストのポート番号を設定します。
      パラメータ:
      iport - ポート番号
      導入されたバージョン:
      1.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である場合。
      導入されたバージョン:
      1.1
      関連項目:
      getLength(), getData()

    • setLength

      public void setLength​(int length)
      このパケットの長さを設定します。 パケットの長さとは、パケットのデータ・バッファ内の送信対象バイト数、パケットのデータ・バッファ内でデータ受信に使用されるバイト数、のいずれかです。 lengthは、オフセットとパケット・バッファ長を足した値以下でなければいけません。
      パラメータ:
      length - このパケット用として設定する長さ。
      例外:
      IllegalArgumentException - lengthが負の場合、またはlengthがパケットのデータ・バッファの長さよりも大きい場合。
      導入されたバージョン:
      1.1
      関連項目:
      getLength(), setData(byte[], int, int)