DatagramPacket (Java Platform SE 7)

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 - 読み込むバイト数。
    導入されたバージョン:
    
    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、オフセット ioffset のパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラムパケットを構築します。引数 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、オフセット ioffset のパケットを指定されたホスト上の指定されたポート番号に送信するためのデータグラムパケットを構築します。引数 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 がパケットのデータバッファーの長さよりも大きい場合。
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    getLength(), setData(byte[], int, int)

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス DatagramPacket

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

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

DatagramPacket

DatagramPacket

DatagramPacket

DatagramPacket

DatagramPacket

DatagramPacket

メソッドの詳細

getAddress

getPort

getData

getOffset

getLength

setData

setAddress

setPort

setSocketAddress

getSocketAddress

setData

setLength