| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public abstract class AbstractSelector extends Selector
Base implementation class for selectors.
This class encapsulates the low-level machinery required to implement
the interruption of selection operations. A concrete selector class must
invoke the {@link #begin begin} and {@link #end end} methods before and
after, respectively, invoking an I/O operation that might block
indefinitely. In order to ensure that the {@link #end end} method is always
invoked, these methods should be used within a
try ... finally block:
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 {@link #register register} method that is invoked by a
selectable channel's {@link AbstractSelectableChannel#register register}
method in order to perform the actual work of registering a channel.
try {
begin();
// Perform blocking I/O operation here
...
} finally {
end();
}
Constructor Summary | |
---|---|
protected |
AbstractSelector(SelectorProvider provider) Initializes a new instance of this class. |
Method Summary | |
---|---|
protected void |
begin() Marks the beginning of an I/O operation that might block indefinitely. |
protected Set |
Retrieves this selector's cancelled-key set. |
void |
close() Closes this selector. |
protected void |
Removes the given key from its channel's key set. |
protected void |
end() Marks the end of an I/O operation that might block indefinitely. |
protected abstract void |
Closes this selector. |
boolean |
isOpen() Tells whether or not this selector is open. |
SelectorProvider |
provider() Returns the provider that created this channel. |
protected abstract SelectionKey |
register(AbstractSelectableChannel ch, int ops, Object att) Registers the given channel with this selector. |
Methods inherited from class java.nio.channels.Selector |
---|
close, isOpen, keys, open, provider, select, select, selectedKeys, selectNow, wakeup |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected AbstractSelector(SelectorProvider provider)
provider
Method Detail |
---|
protected final void begin()
This method should be invoked in tandem with the {@link #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 {@link Selector#wakeup wakeup} method to be invoked if a thread's {@link Thread#interrupt interrupt} method is invoked while the thread is blocked in an I/O operation upon the selector.
protected final Set cancelledKeys()
This set should only be used while synchronized upon it.
public final void close() throws IOException
If the selector has already been closed then this method returns immediately. Otherwise it marks the selector as closed and then invokes the {@link #implCloseSelector implCloseSelector} method in order to complete the close operation.
close
in class Selector
IOException
- If an I/O error occursprotected final void deregister(AbstractSelectionKey key)
This method must be invoked by the selector for each channel that it deregisters.
key
- The selection key to be removedprotected final void end()
This method should be invoked in tandem with the {@link #begin begin} method, using a try ... finally block as shown above, in order to implement interruption for this selector.
protected abstract void implCloseSelector() throws IOException
This method is invoked by the {@link #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 {@link java.nio.channels.Selector#wakeup wakeup} method.
IOException
- If an I/O error occurs while closing the selectorpublic final boolean isOpen()
isOpen
in class Selector
public final SelectorProvider provider()
provider
in class Selector
protected abstract SelectionKey register(AbstractSelectableChannel ch, int ops, Object att)
This method is invoked by a channel's {@link AbstractSelectableChannel#register register} method in order to perform the actual work of registering the channel with this selector.
ch
- The channel to be registeredops
- The initial interest set, which must be validatt
- The initial attachment for the resulting key
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |