Java Doc for AbstractSelector.java in  » 6.0-JDK-Core » io-nio » java » nio » channels » spi » Java Source Code / Java DocumentationJava Source Code and Java Documentation

This class encapsulates the low-level machinery required to implement the interruption of selection operations. A concrete selector class must invoke the AbstractSelector.begin begin and AbstractSelector.end end methods before and after, respectively, invoking an I/O operation that might block indefinitely. In order to ensure that the AbstractSelector.end end method is always invoked, these methods should be used within a try ... finally block:

 try {
 begin();
 // Perform blocking I/O operation here
 ...
 } finally {
 end();
 }

This class also defines methods for maintaining a selector's cancelled-key set and for removing a key from its channel's key set, and declares the abstract AbstractSelector.register register method that is invoked by a selectable channel's AbstractSelectableChannel.register register method in order to perform the actual work of registering a channel.

This method should be invoked in tandem with the AbstractSelector.end end method, using a try ... finally block as shown above, in order to implement interruption for this selector.

Invoking this method arranges for the selector's Selector.wakeup wakeup method to be invoked if a thread's Thread.interrupt interrupt method is invoked while the thread is blocked in an I/O operation upon the selector.

This set should only be used while synchronized upon it.

If the selector has already been closed then this method returns immediately.

This method must be invoked by the selector for each channel that it deregisters.

This method should be invoked in tandem with the AbstractSelector.begin begin method, using a try ... finally block as shown above, in order to implement interruption for this selector.

This method is invoked by the AbstractSelector.close close method in order to perform the actual work of closing the selector.

This method is invoked by a channel's AbstractSelectableChannel.register register method in order to perform the actual work of registering the channel with this selector.

This method should be invoked in tandem with the AbstractSelector.end end method, using a try ... finally block as shown above, in order to implement interruption for this selector.

Invoking this method arranges for the selector's Selector.wakeup wakeup method to be invoked if a thread's Thread.interrupt interrupt method is invoked while the thread is blocked in an I/O operation upon the selector.

This set should only be used while synchronized upon it.

If the selector has already been closed then this method returns immediately. Otherwise it marks the selector as closed and then invokes the AbstractSelector.implCloseSelector implCloseSelector method in order to complete the close operation.

This method must be invoked by the selector for each channel that it deregisters.

This method should be invoked in tandem with the AbstractSelector.begin begin method, using a try ... finally block as shown above, in order to implement interruption for this selector.

This method is invoked by the AbstractSelector.close close method in order to perform the actual work of closing the selector. This method is only invoked if the selector has not yet been closed, and it is never invoked more than once.

An implementation of this method must arrange for any other thread that is blocked in a selection operation upon this selector to return immediately as if by invoking the java.nio.channels.Selector.wakeup wakeup method.

This method is invoked by a channel's AbstractSelectableChannel.register register method in order to perform the actual work of registering the channel with this selector.