Класс AsynchronousChannelProvider

java.lang.Object

java.nio.channels.spi.AsynchronousChannelProvider

public abstract class AsynchronousChannelProvider extends Object

Класс-провайдер для асинхронных каналов.

Провайдер асинхронных каналов — это конкретный подкласс этого класса, имеющий конструктор без аргументов и реализующий абстрактные методы, указанные ниже. В данном вызове виртуальной машины Java поддерживается один системный провайдер по умолчанию, который возвращается методом provider. Первый вызов этого метода найдет провайдера по умолчанию, как указано ниже.

Все методы в этом классе безопасны для использования в нескольких потоках одновременно.

Since:: 1.7

Краткое описание конструкторов

AsynchronousChannelProvider()

Модификатор	Конструктор	Описание
`protected`	Инициализирует новый экземпляр этого класса.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract AsynchronousChannelGroup`	`openAsynchronousChannelGroup(int nThreads, ThreadFactory threadFactory)`	Создаёт новый асинхронный канал группы с фиксированным пулом потоков.
`abstract AsynchronousChannelGroup`	`openAsynchronousChannelGroup(ExecutorService executor, int initialSize)`	Создаёт новый асинхронный канал группы с заданным пулом потоков.
`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")

Подробное описание методов

provider

public static AsynchronousChannelProvider provider()

Возвращает системный асинхронный провайдер канала по умолчанию для данного вызова виртуальной машины Java.

Первый вызов этого метода ищет объект провайдера по умолчанию следующим образом:

Если системная переменная java.nio.channels.spi.AsynchronousChannelProvider определена, она рассматривается как полное имя класса конкретного провайдера. Класс загружается и инициализируется; если этот процесс завершается неудачей, выбрасывается неопределённая ошибка.
Если класс провайдера был установлен в файле jar, видимом для системного загрузчика классов, и этот файл jar содержит файл конфигурации провайдера, названный java.nio.channels.spi.AsynchronousChannelProvider в каталоге ресурсов META-INF/services, то имя первого класса, указанного в этом файле, используется. Класс загружается и инициализируется; если этот процесс завершается неудачей, выбрасывается неопределённая ошибка.
Наконец, если ни один провайдер не был указан ни одним из вышеперечисленных способов, то инициализируется системный провайдер по умолчанию, и результат возвращается.

Последующие вызовы этого метода возвращают провайдера, который был возвращен при первом вызове.

Возвращает:: Системный асинхронный провайдер канала по умолчанию

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 - Если произошла ошибка ввода-вывода

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/nio/channels/spi/AsynchronousChannelProvider.html