java.nio.channels.spi

Class SelectorProvider

java.lang.Object

java.nio.channels.spi.SelectorProvider

Direct Known Subclasses:

SelectorProviderImpl

public abstract class SelectorProvider
extends Object

SelectorProvider is an abstract base class that declares methods for providing instances of DatagramChannel, Pipe, Selector , ServerSocketChannel, and SocketChannel. All the methods of this class are thread-safe.

A provider instance can be retrieved through a system property or the configuration file in a jar file; if no provider is available that way then the system default provider is returned.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SelectorProvider() Constructs a new SelectorProvider.

Method Summary

Modifier and Type	Method and Description
Channel	inheritedChannel() Returns the channel inherited from the process that created this VM.
abstract DatagramChannel	openDatagramChannel() Creates a new open DatagramChannel.
abstract Pipe	openPipe() Creates a new Pipe.
abstract AbstractSelector	openSelector() Creates a new selector.
abstract ServerSocketChannel	openServerSocketChannel() Creates a new open ServerSocketChannel.
abstract SocketChannel	openSocketChannel() Create a new open SocketChannel.
static SelectorProvider	provider() Gets a provider instance by executing the following steps when called for the first time: if the system property "java.nio.channels.spi.SelectorProvider" is set, the value of this property is the class name of the provider returned; if there is a provider-configuration file named "java.nio.channels.spi.SelectorProvider" in META-INF/services of a jar file valid in the system class loader, the first class name is the provider's class name; otherwise, a system default provider will be returned.

Methods inherited from class java.lang.Object

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

Constructor Detail

SelectorProvider

protected SelectorProvider()

Constructs a new SelectorProvider.

Method Detail

provider

public static SelectorProvider provider()

Gets a provider instance by executing the following steps when called for the first time:

• if the system property "java.nio.channels.spi.SelectorProvider" is set, the value of this property is the class name of the provider returned;
• if there is a provider-configuration file named "java.nio.channels.spi.SelectorProvider" in META-INF/services of a jar file valid in the system class loader, the first class name is the provider's class name;
• otherwise, a system default provider will be returned.

Returns:

the provider.

openDatagramChannel

public abstract DatagramChannel openDatagramChannel()
                                             throws IOException

Creates a new open DatagramChannel.

Returns:

the new channel.

Throws:

IOException - if an I/O error occurs.

openPipe

public abstract Pipe openPipe()
                       throws IOException

Creates a new Pipe.

Returns:

the new pipe.

Throws:

IOException - if an I/O error occurs.

openSelector

public abstract AbstractSelector openSelector()
                                       throws IOException

Creates a new selector.

Returns:

the new selector.

Throws:

IOException - if an I/O error occurs.

openServerSocketChannel

public abstract ServerSocketChannel openServerSocketChannel()
                                                     throws IOException

Creates a new open ServerSocketChannel.

Returns:

the new channel.

Throws:

IOException - if an I/O error occurs.

openSocketChannel

public abstract SocketChannel openSocketChannel()
                                         throws IOException

Create a new open SocketChannel.

Returns:

the new channel.

Throws:

IOException - if an I/O error occurs.

inheritedChannel

public Channel inheritedChannel()
                         throws IOException

Returns the channel inherited from the process that created this VM. On Android, this method always returns null because stdin and stdout are never connected to a socket.

Returns:

the channel.

Throws:

IOException - if an I/O error occurs.