モジュール java.base

パッケージ java.nio.channels

クラスDatagramChannel

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メソッドを使用して構成されます。 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)	このクラスの新しいインスタンスを初期化します。

メソッドのサマリー

修飾子と型	メソッド	説明
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)	このチャネルからデータグラムを読み込みます。
final 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()	このチャネルに関連したデータグラム・ソケットを取得します。
final int	validOps()	このチャネルのサポートされている操作を識別する操作セットを返します。
abstract int	write(ByteBuffer src)	このチャネルへデータグラムを書き込みます。
final 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.Channelで宣言されたメソッド

isOpen

インタフェースjava.nio.channels.MulticastChannelで宣言されたメソッド

close, join, join

インタフェースjava.nio.channels.NetworkChannelで宣言されたメソッド

getOption, supportedOptions

コンストラクタの詳細

DatagramChannel

protected DatagramChannel(SelectorProvider provider)

このクラスの新しいインスタンスを初期化します。

パラメータ:

provider - このチャネルの作成元プロバイダ

メソッドの詳細

open

public static DatagramChannel open() throws IOException

データグラム・チャネルをオープンします。

システム全体のデフォルトSelectorProviderオブジェクトのopenDatagramChannelメソッドを呼び出すことで、新しいチャネルが作成されます。 チャネルは接続されません。

チャネルのソケットのProtocolFamilyは、プラットフォーム(および場合によっては構成)によって異なるため、未指定です。 openを使用して、データグラム・チャネルを開くときにプロトコル・ファミリを選択できます。Internet Protocolマルチキャストを対象とするデータグラム・チャネルを開くときは、これを使用する必要があります。

戻り値:

新しいデータグラム・チャネル

例外:

IOException - 入出力エラーが発生した場合

関連項目:

• java.net.preferIPv4Stackシステム・プロパティ

open

public static DatagramChannel open(ProtocolFamily family) throws IOException

データグラム・チャネルをオープンします。

familyパラメータは、ProtocolFamilyを指定するために使用されます。 IPマルチキャストにデータグラム・チャネルを使用する場合、これは、このチャネルが参加するマルチキャスト・グループのアドレス・タイプに対応する必要があります。

システム全体のデフォルトSelectorProviderオブジェクトのopenDatagramChannelメソッドを呼び出すことで、新しいチャネルが作成されます。 チャネルは接続されません。

APIのノート:

「Unixドメイン」ソケットはサポートされていません。

パラメータ:

family - プロトコル・ファミリ

戻り値:

新しいデータグラム・チャネル

例外:

UnsupportedOperationException - 指定されたプロトコル・ファミリがサポートされていない場合。 たとえば、パラメータにStandardProtocolFamily.INET6が指定されているが、IPv6がプラットフォームで有効になっていないとします。

IOException - 入出力エラーが発生した場合

導入されたバージョン:

1.7

関連項目:

• java.net.preferIPv4Stackシステム・プロパティ

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()

このチャネルに関連したデータグラム・ソケットを取得します。

戻り値:

このチャネルに関連したデータグラム・ソケット

isConnected

public abstract boolean isConnected()

このチャネルのソケットが接続されているかどうかを判断します。

戻り値:

このチャネルのソケットがopenで、接続されている場合にかぎりtrue

connect

public abstract DatagramChannel connect(SocketAddress remote) throws IOException

このチャネルのソケットを接続します。

チャネルのソケットは、指定されたリモート「ピア」アドレス以外とはデータグラムをやりとりしないように構成されています。 接続後、指定されたアドレス以外のアドレスとデータグラムがやりとりされることはありません。 このメソッドを呼び出す前にreceivedではなかったチャネル「ソケット受信バッファ」のデータグラムは破棄される可能性があります。 チャネル・ソケットは、明示的に切断されるか、閉じられるまで接続されたままになります。

このメソッドは、DatagramSocketクラスのconnectメソッドとまったく同じセキュリティ・チェックを行います。 セキュリティ・マネージャがインストールされている場合、このメソッドは、checkAcceptメソッドが指定されたリモート・アドレスからのデータグラムの受信を許可し、checkConnectメソッドが指定されたリモート・アドレスへのデータグラムの送信を許可することを検証します。 接続されると、指定されたリモート・アドレスから受信、またはそのアドレスに送信されたデータグラムに対して、それ以上のセキュリティ・チェックは実行されません。 接続先のデータグラム・チャネルが信頼できないコードと共有されないように注意する必要があります。

このメソッドはいつでも呼び出すことができます。 別のスレッドがこのチャネルで読取りまたは書込み操作をすでに開始している場合、このメソッドの呼出しはこのような操作が完了するまでブロックされます。 このチャネルのソケットがバインドされていない場合は、このメソッドはbindメソッドをnullのパラメータで呼び出した場合と同様に、最初にソケットを自動的に割り当てられるアドレスにバインドします。

パラメータ:

remote - このチャネルの接続先リモート・アドレス

戻り値:

このデータグラム・チャネル

例外:

AlreadyConnectedException - このチャネルがすでに接続されている場合

ClosedChannelException - このチャネルがクローズしている場合

AsynchronousCloseException - 接続操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合

ClosedByInterruptException - 接続操作の進行中に別のスレッドからの割込みがあったためにチャネルがクローズし、現在のスレッドの割込みステータスが設定された場合

UnresolvedAddressException - 指定されたリモート・アドレスが完全に解決されない場合

UnsupportedAddressTypeException - 指定されたリモート・アドレスのタイプがサポート対象外の場合

SecurityException - セキュリティ・マネージャがインストールされており、指定されたリモート・アドレスへのアクセスを許可されていない場合、またはバインドされていない場合、セキュリティ・マネージャcheckListenメソッドは操作を拒否

IOException - その他の入出力エラーが発生した場合

disconnect

public abstract DatagramChannel disconnect() throws IOException

このチャネルのソケットの接続を切断します。

チャネルのソケットは、インストールされているセキュリティ・マネージャから許可された場合にかぎり、あらゆるリモート・アドレスとデータグラムをやりとりできます。

このメソッドはいつでも呼び出すことができます。 別のスレッドがこのチャネルで読取りまたは書込み操作をすでに開始している場合、このメソッドの呼出しはこのような操作が完了するまでブロックされます。

このチャネルのソケットが接続されていない場合、またはチャネルがクローズしている場合、このメソッドを呼び出しても何の効果もありません。

APIのノート:

このメソッドが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

例外:

IllegalArgumentException - バッファが読取り専用である場合

ClosedChannelException - このチャネルがクローズしている場合

AsynchronousCloseException - 読取り操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合

ClosedByInterruptException - 読取り操作の進行中に、別のスレッドからの割込みがあったためにチャネルがクローズし、現在のスレッドの割込みステータスが設定された場合

SecurityException - バインドされていない状態でセキュリティ・マネージャがインストールされており、そのcheckListenメソッドは操作を拒否

IOException - その他の入出力エラーが発生した場合

send

public abstract int send(ByteBuffer src, SocketAddress target) throws IOException

このチャネルからデータグラムを送信します。

チャネルの動作モードが非ブロック・モードで基準となる出力バッファの容量が十分でない場合や、動作モードがブロック・モードで十分な容量がある場合、指定されたバッファ内に残っているバイトは単一のデータグラムとして指定されたターゲット・アドレスへ転送されます。

データグラムは、通常のwrite操作を実行した場合と同様に、byteバッファから転送されます。

このメソッドは、DatagramSocketクラスのsendメソッドとまったく同じセキュリティ・チェックを行います。 ソケットが特定のリモート・アドレスに接続されておらず、セキュリティ・マネージャがインストールされている場合、このメソッドは、送信されたデータグラムごとにターゲットのアドレスとポート番号がセキュリティ・マネージャのcheckConnectメソッドによって許可されていることを検証します。 このセキュリティ・チェックのオーバーヘッドを回避するには、最初にconnectメソッドを使ってソケットを接続します。

このメソッドはいつでも呼び出すことができます。 ただし、ほかのスレッドがこのチャネルに対して書込み操作を開始している場合、このメソッドの呼出しは最初の操作が終わるまでブロックされます。 このチャネルのソケットがバインドされていない場合は、このメソッドはbindメソッドをnullのパラメータで呼び出した場合と同様に、最初にソケットを自動的に割り当てられるアドレスにバインドします。

パラメータ:

src - 送信されるデータグラムを含むバッファ

target - データグラムの送信先アドレス

戻り値:

送信バイト数。このメソッドを呼び出したときにソース・バッファ内に残っていたバイト数。このチャネルが非ブロック・モードで動作しており、基準となる出力バッファの容量が不十分なためデータグラムが収まりきらない場合はゼロ

例外:

AlreadyConnectedException - このチャネルがtargetで指定されたものとは異なるアドレスに接続されている場合

ClosedChannelException - このチャネルがクローズしている場合

AsynchronousCloseException - 読取り操作の進行中に、別のスレッドによってこのチャネルがクローズされた場合

ClosedByInterruptException - 読取り操作の進行中に、別のスレッドからの割込みがあったためにチャネルがクローズし、現在のスレッドの割込みステータスが設定された場合

UnresolvedAddressException - 指定されたリモート・アドレスが完全に解決されない場合

UnsupportedAddressTypeException - 指定されたリモート・アドレスのタイプがサポート対象外の場合

SecurityException - セキュリティ・マネージャがインストールされており、指定されたアドレスへのデータグラム送信を許可されていない場合、またはバインドされていない場合、セキュリティ・マネージャcheckListenメソッドは操作を拒否

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

このチャネルのソケットがバインドされているソケット・アドレスを返します。

チャネルがInternet Protocolソケット・アドレスにバインドされている場合は、このメソッドからの戻り値の型はInetSocketAddressです。

チャネルのソケットが最初にワイルドカード・アドレスにバインドされ、現在はconnectedの場合、返されるアドレスは、ワイルドカード・アドレスではなく、このチャネルを介して送信されるデータグラムのソース・アドレスとして選択されたローカル・アドレスになります。 disconnect()がコールされると、バインドされたアドレスはワイルドカード・アドレスに戻ります。

セキュリティ・マネージャが設定されている場合は、セキュリティ・マネージャのcheckConnectメソッドがローカル・アドレスおよび-1を引数として呼び出され、操作が許可されるかどうかが確認されます。 この操作が許可されない場合は、ループバック・アドレスおよびチャネルのソケットのローカル・ポートを表すSocketAddressが返されます。

定義:

getLocalAddress、インタフェースNetworkChannel

戻り値:

ソケットがバインドされているSocketAddress、またはセキュリティ・マネージャによって拒否された場合はループバック・アドレスを表すSocketAddress、またはチャネルのソケットがバインドされていない場合はnull

例外:

ClosedChannelException - チャネルがクローズしている場合

IOException - 入出力エラーが発生した場合