# Print output for @column tags ?>
Developers

- Design
- Develop
- Distribute

Developer Console

## Most visited

## Recently visited

## Results for

Summary: Protected Ctors | Methods | Inherited Methods

# Selector

`public abstract class Selector`
`extends Object` `implements Closeable`

java.lang.Object
↳ | java.nio.channels.Selector

Known direct subclasses AbstractSelector
AbstractSelector | Base implementation class for selectors.

A multiplexor of `SelectableChannel` objects.

A selector may be created by invoking the `open` method of this class, which will use the system's default `selector provider` to create a new selector. A selector may also be created by invoking the `openSelector` method of a custom selector provider. A selector remains open until it is closed via its `close` method.

A selectable channel's registration with a selector is represented by a `SelectionKey` object. A selector maintains three sets of selection keys:

- The key set contains the keys representing the current channel registrations of this selector. This set is returned by the `keys` method.

- The selected-key set is the set of keys such that each key's channel was detected to be ready for at least one of the operations identified in the key's interest set during a prior selection operation. This set is returned by the `selectedKeys` method. The selected-key set is always a subset of the key set.

- The cancelled-key set is the set of keys that have been cancelled but whose channels have not yet been deregistered. This set is not directly accessible. The cancelled-key set is always a subset of the key set.

All three sets are empty in a newly-created selector.

A key is added to a selector's key set as a side effect of registering a channel via the channel's `SelectableChannel#register(Selector,int)` method. Cancelled keys are removed from the key set during selection operations. The key set itself is not directly modifiable.

A key is added to its selector's cancelled-key set when it is cancelled, whether by closing its channel or by invoking its `SelectionKey#cancel` method. Cancelling a key will cause its channel to be deregistered during the next selection operation, at which time the key will removed from all of the selector's key sets.

Keys are added to the selected-key set by selection operations. A key may be removed directly from the selected-key set by invoking the set's `remove` method or by invoking the `remove` method of an `iterator` obtained from the set. Keys are never removed from the selected-key set in any other way; they are not, in particular, removed as a side effect of selection operations. Keys may not be added directly to the selected-key set.

## Selection

During each selection operation, keys may be added to and removed from a selector's selected-key set and may be removed from its key and cancelled-key sets. Selection is performed by the `select()`, `select(long)`, and `selectNow()` methods, and involves three steps:

1. Each key in the cancelled-key set is removed from each key set of which it is a member, and its channel is deregistered. This step leaves the cancelled-key set empty.

2. The underlying operating system is queried for an update as to the readiness of each remaining channel to perform any of the operations identified by its key's interest set as of the moment that the selection operation began. For a channel that is ready for at least one such operation, one of the following two actions is performed:

   1. If the channel's key is not already in the selected-key set then it is added to that set and its ready-operation set is modified to identify exactly those operations for which the channel is now reported to be ready. Any readiness information previously recorded in the ready set is discarded.

   2. Otherwise the channel's key is already in the selected-key set, so its ready-operation set is modified to identify any new operations for which the channel is reported to be ready. Any readiness information previously recorded in the ready set is preserved; in other words, the ready set returned by the underlying system is bitwise-disjoined into the key's current ready set.

   If all of the keys in the key set at the start of this step have empty interest sets then neither the selected-key set nor any of the keys' ready-operation sets will be updated.

3. If any keys were added to the cancelled-key set while step (2) was in progress then they are processed as in step (1).

Whether or not a selection operation blocks to wait for one or more channels to become ready, and if so for how long, is the only essential difference between the three selection methods.

## Concurrency

Selectors are themselves safe for use by multiple concurrent threads; their key sets, however, are not.

The selection operations synchronize on the selector itself, on the key set, and on the selected-key set, in that order. They also synchronize on the cancelled-key set during steps (1) and (3) above.

Changes made to the interest sets of a selector's keys while a selection operation is in progress have no effect upon that operation; they will be seen by the next selection operation.

Keys may be cancelled and channels may be closed at any time. Hence the presence of a key in one or more of a selector's key sets does not imply that the key is valid or that its channel is open. Application code should be careful to synchronize and check these conditions as necessary if there is any possibility that another thread will cancel a key or close a channel.

A thread blocked in one of the `select()` or `select(long)` methods may be interrupted by some other thread in one of three ways:

- By invoking the selector's `wakeup` method,

- By invoking the selector's `close` method, or

- By invoking the blocked thread's `interrupt` method, in which case its interrupt status will be set and the selector's `wakeup` method will be invoked.

The `close` method synchronizes on the selector and all three key sets in the same order as in a selection operation.

A selector's key and selected-key sets are not, in general, safe for use by multiple concurrent threads. If such a thread might modify one of these sets directly then access should be controlled by synchronizing on the set itself. The iterators returned by these sets' `iterator` methods are fail-fast: If the set is modified after the iterator is created, in any way except by invoking the iterator's own `remove` method, then a `ConcurrentModificationException` will be thrown.

See also:

- `SelectableChannel`
- `SelectionKey`

## Summary

### Protected constructors
`Selector()` Initializes a new instance of this class.

### Public methods
`abstract void` | `close()` Closes this selector.
`abstract boolean` | `isOpen()` Tells whether or not this selector is open.
`abstract Set<SelectionKey>` | `keys()` Returns this selector's key set.
`static Selector` | `open()` Opens a selector.
`abstract SelectorProvider` | `provider()` Returns the provider that created this channel.
`abstract int` | `select(long timeout)` Selects a set of keys whose corresponding channels are ready for I/O operations.
`abstract int` | `select()` Selects a set of keys whose corresponding channels are ready for I/O operations.
`abstract int` | `selectNow()` Selects a set of keys whose corresponding channels are ready for I/O operations.
`abstract Set<SelectionKey>` | `selectedKeys()` Returns this selector's selected-key set.
`abstract Selector` | `wakeup()` Causes the first selection operation that has not yet returned to return immediately.

### Inherited methods
From class `java.lang.Object`
`Object` | `clone()` Creates and returns a copy of this object.
`boolean` | `equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void` | `finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>` | `getClass()` Returns the runtime class of this `Object`.
`int` | `hashCode()` Returns a hash code value for the object.
`final void` | `notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void` | `notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String` | `toString()` Returns a string representation of the object.
`final void` | `wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void` | `wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void` | `wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
From interface `java.io.Closeable`
`abstract void` | `close()` Closes this stream and releases any system resources associated with it.
From interface `java.lang.AutoCloseable`
`abstract void` | `close()` Closes this resource, relinquishing any underlying resources.

## Protected constructors

### Selector

    protected Selector ()

Initializes a new instance of this class.

## Public methods

### close

    public abstract void close ()

Closes this selector.

If a thread is currently blocked in one of this selector's selection methods then it is interrupted as if by invoking the selector's `wakeup` method.

Any uncancelled keys still associated with this selector are invalidated, their channels are deregistered, and any other resources associated with this selector are released.

If this selector is already closed then invoking this method has no effect.

After a selector is closed, any further attempt to use it, except by invoking this method or the `wakeup` method, will cause a `ClosedSelectorException` to be thrown.

Throws
`IOException` | If an I/O error occurs

### isOpen

    public abstract boolean isOpen ()

Tells whether or not this selector is open.

Returns
`boolean` | `true` if, and only if, this selector is open

### keys

    public abstract Set<SelectionKey> keys ()

Returns this selector's key set.

The key set is not directly modifiable. A key is removed only after it has been cancelled and its channel has been deregistered. Any attempt to modify the key set will cause an `UnsupportedOperationException` to be thrown.

The key set is not thread-safe.

Returns
`Set<SelectionKey>` | This selector's key set

Throws
`ClosedSelectorException` | If this selector is closed

### open

    public static Selector open ()

Opens a selector.

The new selector is created by invoking the `openSelector` method of the system-wide default `SelectorProvider` object.

Returns
`Selector` | A new selector

Throws
`IOException` | If an I/O error occurs

### provider

    public abstract SelectorProvider provider ()

Returns the provider that created this channel.

Returns
`SelectorProvider` | The provider that created this channel

### select

    public abstract int select (long timeout)

Selects a set of keys whose corresponding channels are ready for I/O operations.

This method performs a blocking selection operation. It returns only after at least one channel is selected, this selector's `wakeup` method is invoked, the current thread is interrupted, or the given timeout period expires, whichever comes first.

This method does not offer real-time guarantees: It schedules the timeout as if by invoking the `Object#wait(long)` method.

Parameters
`timeout` | `long`: If positive, block for up to `timeout` milliseconds, more or less, while waiting for a channel to become ready; if zero, block indefinitely; must not be negative

Returns
`int` | The number of keys, possibly zero, whose ready-operation sets were updated

Throws
`IOException` | If an I/O error occurs
`ClosedSelectorException` | If this selector is closed
`IllegalArgumentException` | If the value of the timeout argument is negative

### select

    public abstract int select ()

Selects a set of keys whose corresponding channels are ready for I/O operations.

This method performs a blocking selection operation. It returns only after at least one channel is selected, this selector's `wakeup` method is invoked, or the current thread is interrupted, whichever comes first.

Returns
`int` | The number of keys, possibly zero, whose ready-operation sets were updated

Throws
`IOException` | If an I/O error occurs
`ClosedSelectorException` | If this selector is closed

### selectNow

    public abstract int selectNow ()

Selects a set of keys whose corresponding channels are ready for I/O operations.

This method performs a non-blocking selection operation. If no channels have become selectable since the previous selection operation then this method immediately returns zero.

Invoking this method clears the effect of any previous invocations of the `wakeup` method.

Returns
`int` | The number of keys, possibly zero, whose ready-operation sets were updated by the selection operation

Throws
`IOException` | If an I/O error occurs
`ClosedSelectorException` | If this selector is closed

### selectedKeys

    public abstract Set<SelectionKey> selectedKeys ()

Returns this selector's selected-key set.

Keys may be removed from, but not directly added to, the selected-key set. Any attempt to add an object to the key set will cause an `UnsupportedOperationException` to be thrown.

The selected-key set is not thread-safe.

Returns
`Set<SelectionKey>` | This selector's selected-key set

Throws
`ClosedSelectorException` | If this selector is closed

### wakeup

    public abstract Selector wakeup ()

Causes the first selection operation that has not yet returned to return immediately.

If another thread is currently blocked in an invocation of the `select()` or `select(long)` methods then that invocation will return immediately. If no selection operation is currently in progress then the next invocation of one of these methods will return immediately unless the `selectNow()` method is invoked in the meantime. In any case the value returned by that invocation may be non-zero. Subsequent invocations of the `select()` or `select(long)` methods will block as usual unless this method is invoked again in the meantime.

Invoking this method more than once between two successive selection operations has the same effect as invoking it just once.

Returns
`Selector` | This selector

Full name *
Email address *
Company / developer name
One of your Play Store app URLs *
Which best describes your business:*
Apps
Games
Apps & Games
*
*