Spec-Zone.ru › OpenJDK 25

Класс AsynchronousChannelProvider

java.lang.Object
java.nio.channels.spi.AsynchronousChannelProvider
public abstract class AsynchronousChannelProvider extends Object
Класс поставщика служб для асинхронных каналов.

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

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

Начиная с версии:
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.

Методы, объявленные в классе Object

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

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

AsynchronousChannelProvider

protected AsynchronousChannelProvider()
Инициализирует новый экземпляр этого класса.

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

provider

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

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

  1. Если задано системное свойство java.nio.channels.spi.AsynchronousChannelProvider, оно считается полным именем конкретного класса поставщика. Класс загружается и создается его экземпляр; если этот процесс завершается неудачно, возникает ошибка неопределенного типа.

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

  3. Наконец, если ни один поставщик не был указан ни одним из перечисленных выше способов, создается экземпляр системного класса поставщика по умолчанию и возвращается результат.

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

Возвращает:
Общесистемный поставщик AsynchronousChannel по умолчанию

openAsynchronousChannelGroup

public abstract AsynchronousChannelGroup openAsynchronousChannelGroup(int nThreads, ThreadFactory threadFactory) throws IOException
Создает новую группу асинхронных каналов с пулом потоков фиксированного размера.
Параметры:
nThreads — Количество потоков в пуле
threadFactory — Фабрика для создания новых потоков
Возвращает:
Новая группа асинхронных каналов
Вызывает:
IllegalArgumentException — Если nThreads <= 0
IOException — При возникновении ошибки ввода-вывода
См. также:
  • AsynchronousChannelGroup.withFixedThreadPool(int, ThreadFactory)

openAsynchronousChannelGroup

public abstract AsynchronousChannelGroup openAsynchronousChannelGroup(ExecutorService executor, int initialSize) throws IOException
Создает новую группу асинхронных каналов с заданным пулом потоков.
Параметры:
executor — Пул потоков
initialSize — Значение >=0 или отрицательное значение для использования значения по умолчанию, зависящего от реализации
Возвращает:
Новая группа асинхронных каналов
Вызывает:
IOException — При возникновении ошибки ввода-вывода
См. также:
  • AsynchronousChannelGroup.withCachedThreadPool(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 — При возникновении ошибки ввода-вывода

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.base/java/nio/channels/spi/AsynchronousChannelProvider.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API