java.nio.channels.spi

クラス AsynchronousChannelProvider

java.lang.Object

java.nio.channels.spi.AsynchronousChannelProvider

public abstract class AsynchronousChannelProvider
extends Object

非同期チャネルのサービスプロバイダクラスです。

非同期チャネルプロバイダは、ゼロ引数コンストラクタを持ち、次の抽象メソッドを実装する、このクラスの具象サブクラスです。指定された Java 仮想マシン呼び出しは、provider メソッドによって返される、システム全体で単一のデフォルトプロバイダインスタンスを保持します。このメソッドの最初の呼び出しは、次のデフォルトプロバイダを検出します。

このクラス内のすべてのメソッドは、複数の並行スレッドで安全に使用できます。

導入されたバージョン:

1.7

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

コンストラクタ

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

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
abstract AsynchronousChannelGroup	openAsynchronousChannelGroup(ExecutorService executor, int initialSize) 指定されたスレッドプールで新しい非同期チャネルグループを構築します。
abstract AsynchronousChannelGroup	openAsynchronousChannelGroup(int nThreads, ThreadFactory threadFactory) 固定されたスレッドプールで新しい非同期チャネルグループを構築します。
abstract AsynchronousServerSocketChannel	openAsynchronousServerSocketChannel(AsynchronousChannelGroup group) 非同期のサーバーソケットチャネルを開きます。
abstract AsynchronousSocketChannel	openAsynchronousSocketChannel(AsynchronousChannelGroup group) 非同期のソケットチャネルを開きます。
static AsynchronousChannelProvider	provider() この Java 仮想マシン呼び出しのためのシステム全体のデフォルト非同期チャネルプロバイダを返します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

AsynchronousChannelProvider

protected AsynchronousChannelProvider()

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

例外:

SecurityException - セキュリティーマネージャーがインストールされており、それが RuntimePermission("asynchronousChannelProvider") を拒否した場合

メソッドの詳細

プロバイダ

public static AsynchronousChannelProvider provider()

この Java 仮想マシン呼び出しのためのシステム全体のデフォルト非同期チャネルプロバイダを返します。

このメソッドを最初に呼び出したとき、次の手順でデフォルトプロバイダオブジェクトが検出されます。

1. システムプロパティー java.nio.channels.spi.AsynchronousChannelProvider が定義されている場合、これが具象プロバイダクラスの完全修飾名と見なされます。その後、クラスがロードされ、インスタンスが作成されます。

2. システムクラスローダーの認識する jar ファイルにプロバイダクラスがインストールされていて、この jar ファイルにリソースディレクトリ META-INF/services 内のプロバイダ構成ファイル java.nio.channels.spi.AsynchronousChannelProvider が含まれている場合、そのファイルに指定されている最初のクラス名が使用されます。その後、クラスがロードされ、インスタンスが作成されます。

3. 最後に、上記の手段で指定されたプロバイダが存在しない場合は、システムのデフォルトプロバイダクラスのインスタンスが作成され、結果が返されます。

次回以降の呼び出しでも、1 回目の呼び出し時に返されたプロバイダが返されます。

戻り値:

システム全体のデフォルトの AsynchronousChannel プロバイダ

openAsynchronousChannelGroup

public abstract AsynchronousChannelGroup openAsynchronousChannelGroup(int nThreads,
                                                    ThreadFactory threadFactory)
                                                               throws IOException

固定されたスレッドプールで新しい非同期チャネルグループを構築します。

パラメータ:

nThreads - プール内のスレッド数

threadFactory - 新規スレッドの作成時に使用するファクトリ

例外:

IllegalArgumentException - nThreads <= 0 の場合:

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

関連項目:

AsynchronousChannelGroup.withFixedThreadPool(int, java.util.concurrent.ThreadFactory)

openAsynchronousChannelGroup

public abstract AsynchronousChannelGroup openAsynchronousChannelGroup(ExecutorService executor,
                                                    int initialSize)
                                                               throws IOException

指定されたスレッドプールで新しい非同期チャネルグループを構築します。

パラメータ:

executor - スレッドプール

initialSize - >=0 の値、実装固有のデフォルトの場合は負の値

例外:

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

関連項目:

AsynchronousChannelGroup.withCachedThreadPool(java.util.concurrent.ExecutorService, int)

openAsynchronousServerSocketChannel

public abstract AsynchronousServerSocketChannel openAsynchronousServerSocketChannel(AsynchronousChannelGroup group)
                                                                             throws IOException

非同期のサーバーソケットチャネルを開きます。

パラメータ:

group - チャネルのバインド先のグループ、またはデフォルトグループにバインドする場合は null

戻り値:

新しいチャネル

例外:

IllegalChannelGroupException - グループを作成したプロバイダがこのプロバイダと異なる場合

ShutdownChannelGroupException - グループがシャットダウンしている場合

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

openAsynchronousSocketChannel

public abstract AsynchronousSocketChannel openAsynchronousSocketChannel(AsynchronousChannelGroup group)
                                                                 throws IOException

非同期のソケットチャネルを開きます。

パラメータ:

group - チャネルのバインド先のグループ、またはデフォルトグループにバインドする場合は null

戻り値:

新しいチャネル

例外:

IllegalChannelGroupException - グループを作成したプロバイダがこのプロバイダと異なる場合

ShutdownChannelGroupException - グループがシャットダウンしている場合

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