DatagramChannel (Java Platform SE 8)

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)` このクラスの新しいインスタンスを初期化します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`abstract DatagramChannel`	`bind(SocketAddress local)` チャネルのソケットをローカル・アドレスにバインドします。
`abstract DatagramChannel`	`connect(SocketAddress remote)` このチャネルのソケットを接続します。
`abstract DatagramChannel`	`disconnect()` このチャネルのソケットの接続を切断します。
`abstract SocketAddress`	`getLocalAddress()` このチャネルのソケットがバインドされているソケット・アドレスを返します。
`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から継承されたメソッド
getOption, supportedOptions

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

- コンストラクタの詳細
  - DatagramChannel
```
protected DatagramChannel(SelectorProvider provider)
```
    このクラスの新しいインスタンスを初期化します。
    
    パラメータ:
    
    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
    
    型パラメータ:
    
    T - ソケット・オプション値のタイプ
    
    パラメータ:
    
    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 - その他の入出力エラーが発生した場合
  - getLocalAddress
```
public abstract SocketAddress getLocalAddress()
                                       throws IOException
```
    このチャネルのソケットがバインドされているソケット・アドレスを返します。
    チャネルがIP (Internet Protocol)ソケット・アドレスにバインドされている場合は、このメソッドからの戻り値の型はInetSocketAddressです。
    セキュリティ・マネージャが設定されている場合は、セキュリティ・マネージャのcheckConnectメソッドがローカル・アドレスおよび-1を引数として呼び出され、操作が許可されるかどうかが確認されます。この操作が許可されない場合は、ループバック・アドレスおよびチャネルのソケットのローカル・ポートを表すSocketAddressが返されます。
    
    定義:
    
    getLocalAddress、インタフェース: NetworkChannel
    
    戻り値:
    
    ソケットがバインドされているSocketAddress、またはセキュリティ・マネージャによって拒否された場合はループバック・アドレスを表すSocketAddress、またはチャネルのソケットがバインドされていない場合はnull
    
    例外:
    
    ClosedChannelException - チャネルがクローズしている場合
    
    IOException - 入出力エラーが発生した場合

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, 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

getLocalAddress