Class AsynchronousChannelProvider

Constructor Detail

• AsynchronousChannelProvider

  protected AsynchronousChannelProvider()

  Initializes a new instance of this class.

  Throws:

  SecurityException - If a security manager has been installed and it denies RuntimePermission("asynchronousChannelProvider")

Method Detail

• provider

  public static AsynchronousChannelProvider provider()

  Returns the system-wide default asynchronous channel provider for this invocation of the Java virtual machine.

  The first invocation of this method locates the default provider object as follows:

  1. If the system property java.nio.channels.spi.AsynchronousChannelProvider is defined then it is taken to be the fully-qualified name of a concrete provider class. The class is loaded and instantiated; if this process fails then an unspecified error is thrown.

  2. If a provider class has been installed in a jar file that is visible to the system class loader, and that jar file contains a provider-configuration file named java.nio.channels.spi.AsynchronousChannelProvider in the resource directory META-INF/services, then the first class name specified in that file is taken. The class is loaded and instantiated; if this process fails then an unspecified error is thrown.

  3. Finally, if no provider has been specified by any of the above means then the system-default provider class is instantiated and the result is returned.

  Subsequent invocations of this method return the provider that was returned by the first invocation.

  Returns:

  The system-wide default AsynchronousChannel provider

• openAsynchronousChannelGroup

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

  Constructs a new asynchronous channel group with a fixed thread pool.

  Parameters:

  nThreads - The number of threads in the pool

  threadFactory - The factory to use when creating new threads

  Throws:

  IllegalArgumentException - If nThreads <= 0

  IOException - If an I/O error occurs

  See Also:

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

• openAsynchronousChannelGroup

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

  Constructs a new asynchronous channel group with the given thread pool.

  Parameters:

  executor - The thread pool

  initialSize - A value >=0 or a negative value for implementation specific default

  Throws:

  IOException - If an I/O error occurs

  See Also:

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

• openAsynchronousServerSocketChannel

  public abstract AsynchronousServerSocketChannel openAsynchronousServerSocketChannel(AsynchronousChannelGroup group)
                                                                               throws IOException

  Opens an asynchronous server-socket channel.

  Parameters:

  group - The group to which the channel is bound, or null to bind to the default group

  Returns:

  The new channel

  Throws:

  IllegalChannelGroupException - If the provider that created the group differs from this provider

  ShutdownChannelGroupException - The group is shutdown

  IOException - If an I/O error occurs

• openAsynchronousSocketChannel

  public abstract AsynchronousSocketChannel openAsynchronousSocketChannel(AsynchronousChannelGroup group)
                                                                   throws IOException

  Opens an asynchronous socket channel.

  Parameters:

  group - The group to which the channel is bound, or null to bind to the default group

  Returns:

  The new channel

  Throws:

  IllegalChannelGroupException - If the provider that created the group differs from this provider

  ShutdownChannelGroupException - The group is shutdown

  IOException - If an I/O error occurs