DatagramChannel (Java Platform SE 7)

java.lang.Object
- java.nio.channels.spi.AbstractInterruptibleChannel
- - java.nio.channels.SelectableChannel
  - - java.nio.channels.spi.AbstractSelectableChannel
    - - java.nio.channels.DatagramChannel

すべての実装されたインタフェース:: Closeable, AutoCloseable, ByteChannel, Channel, GatheringByteChannel, InterruptibleChannel, MulticastChannel, NetworkChannel, ReadableByteChannel, ScatteringByteChannel, WritableByteChannel

public abstract class DatagramChannel
extends AbstractSelectableChannel
implements ByteChannel, ScatteringByteChannel, GatheringByteChannel, MulticastChannel

データグラム型ソケットの選択可能なチャネルです。

データグラムチャネルは、このクラスの open メソッドの 1 つを呼び出すことによって作成されます。任意の既存のデータグラムソケットのチャネルを作成することはできません。新しく作成されたデータグラムチャネルはオープンですが、接続は確立されていません。send メソッドと receive メソッドを使用するために、データグラムチャネルを接続する必要はありません。セキュリティーチェックのオーバーヘッドを回避する目的で connect メソッドを呼び出すと、データグラムチャネルが接続され、送受信操作のたびにセキュリティーチェックが行われずに済みます。ソケットアドレスを受け付けない (返さない) read メソッドと write メソッドを使用するためには、データグラムチャネルを接続する必要があります。

一度接続されたデータグラムチャネルは、接続が切断されるかクローズされるまで接続されたままになります。データグラムチャネルが接続されているかどうかは、isConnected メソッドの呼び出しによって判断できます。

ソケットオプションは setOption メソッドを使用して構成されます。IP (Internet Protocol) ソケットへのデータグラムチャネルでは次のオプションがサポートされます。

オプション名説明

SO_SNDBUF ソケット送信バッファーのサイズ

SO_RCVBUF ソケット受信バッファーのサイズ

SO_REUSEADDR アドレスを再利用します

SO_BROADCAST ブロードキャストデータグラムの転送を許可します

IP_TOS IP (Internet Protocol) ヘッダーのサービスタイプ (ToS) オクテット

IP_MULTICAST_IF IP (Internet Protocol) マルチキャストデータグラムのネットワークインタフェース

IP_MULTICAST_TTL IP (Internet Protocol) マルチキャストデータグラムの有効期間

IP_MULTICAST_LOOP IP (Internet Protocol) マルチキャストデータグラムのループバック

オプション名	説明
`SO_SNDBUF`	ソケット送信バッファーのサイズ
`SO_RCVBUF`	ソケット受信バッファーのサイズ
`SO_REUSEADDR`	アドレスを再利用します
`SO_BROADCAST`	ブロードキャストデータグラムの転送を許可します
`IP_TOS`	IP (Internet Protocol) ヘッダーのサービスタイプ (ToS) オクテット
`IP_MULTICAST_IF`	IP (Internet Protocol) マルチキャストデータグラムのネットワークインタフェース
`IP_MULTICAST_TTL`	IP (Internet Protocol) マルチキャストデータグラムの有効期間
`IP_MULTICAST_LOOP`	IP (Internet Protocol) マルチキャストデータグラムのループバック

追加 (実装固有) のオプションをサポートできる場合もあります。

データグラムチャネルは、複数の並行スレッドで安全に使用できます。データグラムチャネルは並行読み込みおよび書き込みをサポートします。ただし、読み込みを行うスレッドも書き込みを行うスレッドも特定の時点では常に 1 個以下です。

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

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

コンストラクタ
修飾子コンストラクタと説明

protected DatagramChannel(SelectorProvider provider)
このクラスの新しいインスタンスを初期化します。

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`DatagramChannel(SelectorProvider provider)` このクラスの新しいインスタンスを初期化します。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`abstract DatagramChannel`	`bind(SocketAddress local)` チャネルのソケットをローカルアドレスにバインドします。
`abstract DatagramChannel`	`connect(SocketAddress remote)` このチャネルのソケットを接続します。
`abstract DatagramChannel`	`disconnect()` このチャネルのソケットの接続を切断します。
`abstract SocketAddress`	`getRemoteAddress()` このチャネルのソケットが接続されているリモートアドレスを返します。
`abstract boolean`	`isConnected()` このチャネルのソケットが接続されているかどうかを判断します。
`static DatagramChannel`	`open()` データグラムチャネルをオープンします。
`static DatagramChannel`	`open(ProtocolFamily family)` データグラムチャネルをオープンします。
`abstract int`	`read(ByteBuffer dst)` このチャネルからデータグラムを読み込みます。
`long`	`read(ByteBuffer[] dsts)` このチャネルからデータグラムを読み込みます。
`abstract long`	`read(ByteBuffer[] dsts, int offset, int length)` このチャネルからデータグラムを読み込みます。
`abstract SocketAddress`	`receive(ByteBuffer dst)` このチャネルからデータグラムを受信します。
`abstract int`	`send(ByteBuffer src, SocketAddress target)` このチャネルからデータグラムを送信します。
`abstract <T> DatagramChannel`	`setOption(SocketOption<T> name, T value)` ソケットオプションの値を設定します。
`abstract DatagramSocket`	`socket()` このチャネルに関連したデータグラムソケットを取得します。
`int`	`validOps()` このチャネルのサポートされている操作を識別する操作セットを返します。
`abstract int`	`write(ByteBuffer src)` このチャネルへデータグラムを書き込みます。
`long`	`write(ByteBuffer[] srcs)` このチャネルへデータグラムを書き込みます。
`abstract long`	`write(ByteBuffer[] srcs, int offset, int length)` このチャネルへデータグラムを書き込みます。

クラス java.nio.channels.spi.AbstractSelectableChannel から継承されたメソッド
blockingLock, configureBlocking, implCloseChannel, implCloseSelectableChannel, implConfigureBlocking, isBlocking, isRegistered, keyFor, provider, register

クラス java.nio.channels.SelectableChannel から継承されたメソッド
register

クラス java.nio.channels.spi.AbstractInterruptibleChannel から継承されたメソッド
begin, close, end, isOpen

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェース java.nio.channels.MulticastChannel から継承されたメソッド
close, join, join

インタフェース java.nio.channels.NetworkChannel から継承されたメソッド
getLocalAddress, getOption, supportedOptions

インタフェース java.nio.channels.Channel から継承されたメソッド
isOpen

- コンストラクタの詳細
  - DatagramChannel
```
protected DatagramChannel(SelectorProvider provider)
```
    このクラスの新しいインスタンスを初期化します。
- メソッドの詳細
  - open
```
public static DatagramChannel open()
                            throws IOException
```
    データグラムチャネルをオープンします。
    システム全体のデフォルト SelectorProvider オブジェクトの openDatagramChannel メソッドを呼び出すことで、新しいチャネルが作成されます。チャネルは接続されません。
    チャネルのソケットの ProtocolFamily は、プラットフォーム (および場合によっては構成) によって異なるため、未指定です。open を使用して、データグラムチャネルを開くときにプロトコルファミリを選択できます。IP (Internet Protocol) マルチキャストを対象とするデータグラムチャネルを開くときは、これを使用するべきです。
    
    戻り値:
    新しいデータグラムチャネル
    
    例外:
    
    IOException - 入出力エラーが発生した場合
  - open
```
public static DatagramChannel open(ProtocolFamily family)
                            throws IOException
```
    データグラムチャネルをオープンします。
    family パラメータは、ProtocolFamily を指定するために使用されます。IP マルチキャストにデータグラムチャネルを使用する場合、これは、このチャネルが参加するマルチキャストグループのアドレスタイプに対応するべきです。
    システム全体のデフォルト SelectorProvider オブジェクトの openDatagramChannel メソッドを呼び出すことで、新しいチャネルが作成されます。チャネルは接続されません。
    
    パラメータ:
    family - プロトコルファミリ
    
    戻り値:
    新しいデータグラムチャネル
    
    例外:
    
    UnsupportedOperationException - 指定されたプロトコルファミリがサポートされていない場合。たとえば、パラメータに StandardProtocolFamily.INET6 が指定されているが、IPv6 がプラットフォームで有効になっていないとします。
    
    IOException - 入出力エラーが発生した場合
    導入されたバージョン:
    
    1.7
  - validOps
```
public final int validOps()
```
    このチャネルのサポートされている操作を識別する操作セットを返します。
    データグラムチャネルでは、読み取りと書き込みがサポートされるため、このメソッドは (SelectionKey.OP_READ | SelectionKey.OP_WRITE) を返します。
    
    定義:
    
    validOps、クラス: SelectableChannel
    
    戻り値:
    有効な操作セット
  - bind
```
public abstract DatagramChannel bind(SocketAddress local)
                              throws IOException
```
    インタフェースからコピーされた説明: NetworkChannel
    
    チャネルのソケットをローカルアドレスにバインドします。
    このメソッドは、ソケットとローカルアドレスとの間の関連付けを確立するために使用されます。関連付けが確立されると、ソケットはチャネルが閉じられるまでバインドされたままになります。local パラメータの値が null の場合、ソケットは自動的に割り当てられるアドレスにバインドされます。
    
    定義:
    
    bind、インタフェース: NetworkChannel
    
    パラメータ:
    local - ソケットのバインド先のアドレス、または自動的に割り当てられるソケットアドレスにソケットをバインドする場合は null
    
    戻り値:
    このチャネル
    
    例外:
    
    AlreadyBoundException - ソケットがすでにバインドされている場合
    
    UnsupportedAddressTypeException - 指定されたアドレスのタイプがサポート対象外の場合
    
    ClosedChannelException - チャネルがクローズしている場合
    
    IOException - その他の入出力エラーが発生した場合
    
    SecurityException - セキュリティーマネージャーがインストールされていて、その checkListen メソッドが操作を拒否した場合
    導入されたバージョン:
    
    1.7
    
    関連項目:
    NetworkChannel.getLocalAddress()
  - setOption
```
public abstract <T> DatagramChannel setOption(SocketOption<T> name,
                            T value)
                                   throws IOException
```
    インタフェースからコピーされた説明: NetworkChannel
    
    ソケットオプションの値を設定します。
    
    定義:
    
    setOption、インタフェース: NetworkChannel
    
    パラメータ:
    name - ソケットオプション
    value - ソケットオプションの値。一部のソケットオプションに対しては、null の値が有効な値である場合があります。
    
    戻り値:
    このチャネル
    
    例外:
    
    UnsupportedOperationException - チャネルがソケットオプションをサポートしていない場合
    
    IllegalArgumentException - 値がこのソケットオプションに対して有効な値でない場合
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    IOException - 入出力エラーが発生した場合
    導入されたバージョン:
    
    1.7
    
    関連項目:
    StandardSocketOptions
  - socket
```
public abstract DatagramSocket socket()
```
    このチャネルに関連したデータグラムソケットを取得します。
    返されるオブジェクトは、DatagramSocket クラスで宣言されていない public メソッドは宣言しません。
    
    戻り値:
    このチャネルに関連したデータグラムソケット
  - isConnected
```
public abstract boolean isConnected()
```
    このチャネルのソケットが接続されているかどうかを判断します。
    
    戻り値:
    このチャネルのソケットが open で、接続されている場合にかぎり true
  - connect
```
public abstract DatagramChannel connect(SocketAddress remote)
                                 throws IOException
```
    このチャネルのソケットを接続します。
    チャネルのソケットは、指定されたリモート「ピア」アドレス以外とはデータグラムをやりとりしないように構成されています。接続後、指定されたアドレス以外のアドレスとデータグラムがやりとりされることはありません。データグラムソケットは、接続を明示的に切断するかクローズするまで接続されたままになります。
    このメソッドは、DatagramSocket クラスの connect メソッドとまったく同じセキュリティーチェックを行います。セキュリティーマネージャーがインストールされている場合、このメソッドは、checkAccept メソッドが指定されたリモートアドレスからのデータグラムの受信を許可し、checkConnect メソッドが指定されたリモートアドレスへのデータグラムの送信を許可することを検証します。
    このメソッドはいつでも呼び出すことができます。呼び出し時に進行中の読み込み操作または書き込み操作には一切影響を及ぼしません。このチャネルのソケットがバインドされていない場合は、このメソッドは bind メソッドを null のパラメータで呼び出した場合と同様に、最初にソケットを自動的に割り当てられるアドレスにバインドします。
    
    パラメータ:
    remote - このチャネルの接続先リモートアドレス
    
    戻り値:
    このデータグラムチャネル
    
    例外:
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 接続操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 接続操作の進行中に別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    SecurityException - セキュリティーマネージャーがインストールされていて、指定されたリモートアドレスへのアクセスが許可されていない場合
    
    IOException - その他の入出力エラーが発生した場合
  - disconnect
```
public abstract DatagramChannel disconnect()
                                    throws IOException
```
    このチャネルのソケットの接続を切断します。
    チャネルのソケットは、インストールされているセキュリティーマネージャーから許可された場合にかぎり、あらゆるリモートアドレスとデータグラムをやりとりできます。
    このメソッドはいつでも呼び出すことができます。呼び出し時に進行中の読み込み操作または書き込み操作には一切影響を及ぼしません。
    このチャネルのソケットが接続されていない場合、またはチャネルがクローズしている場合、このメソッドを呼び出しても何の効果もありません。
    
    戻り値:
    このデータグラムチャネル
    
    例外:
    
    IOException - その他の入出力エラーが発生した場合
  - getRemoteAddress
```
public abstract SocketAddress getRemoteAddress()
                                        throws IOException
```
    このチャネルのソケットが接続されているリモートアドレスを返します。
    
    戻り値:
    リモートアドレス。チャネルのソケットが接続されていない場合は null
    
    例外:
    
    ClosedChannelException - チャネルがクローズしている場合
    
    IOException - 入出力エラーが発生した場合
    導入されたバージョン:
    
    1.7
  - receive
```
public abstract SocketAddress receive(ByteBuffer dst)
                               throws IOException
```
    このチャネルからデータグラムを受信します。
    データグラムをただちに使用できる場合 (このチャネルがブロックモードで動作していてデータグラム 1 個を使用できる場合) は、データグラムが指定された byte バッファーにコピーされたあと、ソースアドレスが返されます。このチャネルが非ブロックモードで動作していてデータグラムをすぐに使用できない場合は、ただちに null が返されます。
    データグラムは、通常の read 操作の場合と同様に、指定された byte バッファーの現在位置に転送されます。バッファー内に残っているバイト数がデータグラムの格納に必要なバイト数より少ない場合、収まりきらなかったデータグラムは通知なしで破棄されます。
    このメソッドは、DatagramSocket クラスの receive メソッドとまったく同じセキュリティーチェックを行います。ソケットが特定のリモートアドレスに接続されておらず、セキュリティーマネージャーがインストールされている場合、このメソッドは、受信されたデータグラムごとにソースのアドレスとポート番号がセキュリティーマネージャーの checkAccept メソッドによって許可されていることを検証します。このセキュリティーチェックのオーバーヘッドを回避するには、最初に connect メソッドを使ってソケットを接続します。
    このメソッドはいつでも呼び出すことができます。ただし、ほかのスレッドがこのチャネルに対して読み込み操作を開始している場合、このメソッドの呼び出しは最初の操作が終わるまでブロックされます。このチャネルのソケットがバインドされていない場合は、このメソッドは bind メソッドを null のパラメータで呼び出した場合と同様に、最初にソケットを自動的に割り当てられるアドレスにバインドします。
    
    パラメータ:
    dst - データグラムの転送先バッファー
    
    戻り値:
    データグラムのソースアドレス。または、このチャネルが非ブロックモードで動作していて、すぐに使用できるデータグラムがない場合は null
    
    例外:
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 読み取り操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 読み取り操作の進行中に、別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    SecurityException - セキュリティーマネージャーがインストールされていて、データグラムの送信側がデータグラムの受信を許可していない場合
    
    IOException - その他の入出力エラーが発生した場合
  - send
```
public abstract int send(ByteBuffer src,
       SocketAddress target)
                  throws IOException
```
    このチャネルからデータグラムを送信します。
    チャネルの動作モードが非ブロックモードで基準となる出力バッファーの容量が十分でない場合や、動作モードがブロックモードで十分な容量がある場合、指定されたバッファー内に残っているバイトは単一のデータグラムとして指定されたターゲットアドレスへ転送されます。
    データグラムは、通常の write 操作を実行した場合と同様に、byte バッファーから転送されます。
    このメソッドは、DatagramSocket クラスの send メソッドとまったく同じセキュリティーチェックを行います。ソケットが特定のリモートアドレスに接続されておらず、セキュリティーマネージャーがインストールされている場合、このメソッドは、送信されたデータグラムごとにターゲットのアドレスとポート番号がセキュリティーマネージャーの checkConnect メソッドによって許可されていることを検証します。このセキュリティーチェックのオーバーヘッドを回避するには、最初に connect メソッドを使ってソケットを接続します。
    このメソッドはいつでも呼び出すことができます。ただし、ほかのスレッドがこのチャネルに対して書き込み操作を開始している場合、このメソッドの呼び出しは最初の操作が終わるまでブロックされます。このチャネルのソケットがバインドされていない場合は、このメソッドは bind メソッドを null のパラメータで呼び出した場合と同様に、最初にソケットを自動的に割り当てられるアドレスにバインドします。
    
    パラメータ:
    src - 送信されるデータグラムを含むバッファー
    target - データグラムの送信先アドレス
    
    戻り値:
    送信バイト数。このメソッドを呼び出したときにソースバッファー内に残っていたバイト数。このチャネルが非ブロックモードで動作しており、基準となる出力バッファーの容量が不十分なためデータグラムが収まりきらない場合はゼロ
    
    例外:
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 読み取り操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 読み取り操作の進行中に、別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    SecurityException - セキュリティーマネージャーがインストールされていて、指定されたアドレスへのデータグラムの送信が許可されていない場合
    
    IOException - その他の入出力エラーが発生した場合
  - read
```
public abstract int read(ByteBuffer dst)
                  throws IOException
```
    このチャネルからデータグラムを読み込みます。
    このメソッドは、このチャネルのソケットが接続されている場合に限り呼び出すことができ、そのソケットのピアからのデータグラムのみを受け付けます。指定されたバッファー内に残っているバイト数よりデータグラムのバイト数のほうが多い場合、収まりきらなかったバイトは通知なく破棄されます。それ以外の場合は、このメソッドは ReadableByteChannel インタフェースの指定どおりに動作します。
    
    定義:
    
    read、インタフェース: ReadableByteChannel
    
    パラメータ:
    dst - バイトの転送先バッファー
    
    戻り値:
    読み取られたバイト数。ゼロの場合もある。チャネルがストリームの終わりに達した場合は -1
    
    例外:
    
    NotYetConnectedException - このチャネルのソケットが接続されていない場合
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 読み取り操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 読み取り操作の進行中に、別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    IOException - その他の入出力エラーが発生した場合
  - read
```
public abstract long read(ByteBuffer[] dsts,
        int offset,
        int length)
                   throws IOException
```
    このチャネルからデータグラムを読み込みます。
    このメソッドは、このチャネルのソケットが接続されている場合に限り呼び出すことができ、そのソケットのピアからのデータグラムのみを受け付けます。指定されたバッファー内に残っているバイト数よりデータグラムのバイト数のほうが多い場合、収まりきらなかったバイトは通知なく破棄されます。それ以外の場合は、このメソッドは ScatteringByteChannel インタフェースの指定どおりに動作します。
    
    定義:
    
    read、インタフェース: ScatteringByteChannel
    
    パラメータ:
    dsts - バイトの転送先バッファー
    offset - 最初のバイトの転送先となるバッファー配列内のオフセット。dsts.length 以下の負でない値
    length - アクセスされる最大バッファー数。dsts.length - offset 以下の負でない値
    
    戻り値:
    読み取られたバイト数。ゼロの場合もある。チャネルがストリームの終わりに達した場合は -1
    
    例外:
    
    NotYetConnectedException - このチャネルのソケットが接続されていない場合
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 読み取り操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 読み取り操作の進行中に、別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    IOException - その他の入出力エラーが発生した場合
  - read
```
public final long read(ByteBuffer[] dsts)
                throws IOException
```
    このチャネルからデータグラムを読み込みます。
    このメソッドは、このチャネルのソケットが接続されている場合に限り呼び出すことができ、そのソケットのピアからのデータグラムのみを受け付けます。指定されたバッファー内に残っているバイト数よりデータグラムのバイト数のほうが多い場合、収まりきらなかったバイトは通知なく破棄されます。それ以外の場合は、このメソッドは ScatteringByteChannel インタフェースの指定どおりに動作します。
    
    定義:
    
    read、インタフェース: ScatteringByteChannel
    
    パラメータ:
    dsts - バイトの転送先バッファー
    
    戻り値:
    読み取られたバイト数。ゼロの場合もある。チャネルがストリームの終わりに達した場合は -1
    
    例外:
    
    NotYetConnectedException - このチャネルのソケットが接続されていない場合
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 読み取り操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 読み取り操作の進行中に、別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    IOException - その他の入出力エラーが発生した場合
  - write
```
public abstract int write(ByteBuffer src)
                   throws IOException
```
    このチャネルへデータグラムを書き込みます。
    このメソッドは、このチャネルのソケットが接続されている場合に限り呼び出すことができ、そのソケットのピアに直接データグラムを送信します。それ以外の場合は、WritableByteChannel インタフェースの指定どおりに動作します。
    
    定義:
    
    write、インタフェース: WritableByteChannel
    
    パラメータ:
    src - バイトの取得先バッファー
    
    戻り値:
    書き込まれるバイト数。ゼロの場合もある
    
    例外:
    
    NotYetConnectedException - このチャネルのソケットが接続されていない場合
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 書き込み操作の進行中に別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 書き込み中に別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    IOException - その他の入出力エラーが発生した場合
  - write
```
public abstract long write(ByteBuffer[] srcs,
         int offset,
         int length)
                    throws IOException
```
    このチャネルへデータグラムを書き込みます。
    このメソッドは、このチャネルのソケットが接続されている場合に限り呼び出すことができ、そのソケットのピアに直接データグラムを送信します。それ以外の場合は、GatheringByteChannel インタフェースの指定どおりに動作します。
    
    定義:
    
    write、インタフェース: GatheringByteChannel
    
    パラメータ:
    srcs - バイトの取得先バッファー
    offset - 最初のバイトの取得先となるバッファー配列内のオフセット。srcs.length 以下の負でない値
    length - アクセスされる最大バッファー数。srcs.length - offset 以下の負でない値
    
    戻り値:
    送信バイト数。このメソッドを呼び出したときにソースバッファー内に残っていたバイト数。このチャネルが非ブロックモードで動作しており、基準となる出力バッファーの容量が不十分なためデータグラムが収まりきらない場合はゼロ
    
    例外:
    
    NotYetConnectedException - このチャネルのソケットが接続されていない場合
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 書き込み操作の進行中に別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 書き込み中に別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    IOException - その他の入出力エラーが発生した場合
  - write
```
public final long write(ByteBuffer[] srcs)
                 throws IOException
```
    このチャネルへデータグラムを書き込みます。
    このメソッドは、このチャネルのソケットが接続されている場合に限り呼び出すことができ、そのソケットのピアに直接データグラムを送信します。それ以外の場合は、GatheringByteChannel インタフェースの指定どおりに動作します。
    
    定義:
    
    write、インタフェース: GatheringByteChannel
    
    パラメータ:
    srcs - バイトの取得先バッファー
    
    戻り値:
    送信バイト数。このメソッドを呼び出したときにソースバッファー内に残っていたバイト数。このチャネルが非ブロックモードで動作しており、基準となる出力バッファーの容量が不十分なためデータグラムが収まりきらない場合はゼロ
    
    例外:
    
    NotYetConnectedException - このチャネルのソケットが接続されていない場合
    
    ClosedChannelException - このチャネルがクローズしている場合
    
    AsynchronousCloseException - 書き込み操作の進行中に別のスレッドによってこのチャネルがクローズされた場合
    
    ClosedByInterruptException - 書き込み中に別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合
    
    IOException - その他の入出力エラーが発生した場合

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

クラス DatagramChannel

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

メソッドのサマリー

クラス java.nio.channels.spi.AbstractSelectableChannel から継承されたメソッド

クラス java.nio.channels.SelectableChannel から継承されたメソッド

クラス java.nio.channels.spi.AbstractInterruptibleChannel から継承されたメソッド

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

インタフェース java.nio.channels.MulticastChannel から継承されたメソッド

インタフェース java.nio.channels.NetworkChannel から継承されたメソッド

インタフェース java.nio.channels.Channel から継承されたメソッド

コンストラクタの詳細

DatagramChannel

メソッドの詳細

open

open

validOps

bind

setOption

socket

isConnected

connect

disconnect

getRemoteAddress

receive

send

read

read

read

write

write

write