Android - An Open Handset Alliance Project

java.nio.channels.spi
public abstract class

java.nio.channels.spi.AbstractSelectableChannel

java.lang.Object
	java.nio.channels.spi.AbstractInterruptibleChannel			Channel InterruptibleChannel
		java.nio.channels.SelectableChannel		Channel
			java.nio.channels.spi.AbstractSelectableChannel

Abstract class for selectable channels.

In this class, there are methods about registering/deregistering a channel, about channel closing. It realize the multi-thread safe.

Known Direct Subclasses

DatagramChannel, Pipe.SinkChannel, Pipe.SourceChannel, ServerSocketChannel, SocketChannel

Summary

Protected Constructors

					AbstractSelectableChannel(SelectorProvider selectorProvider)
					Constructor for this class.

Public Methods

	final	Object	blockingLock()
			Gets the blocking lock which synchronizes the configureBlocking and register methods.
	final	SelectableChannel	configureBlocking(boolean blockingMode)
			Set the blocking mode of this channel.
	final	boolean	isBlocking()
			Returns if channel is in blocking mode.
synchronized	final	boolean	isRegistered()
			Returns if channel is registered.
synchronized	final	SelectionKey	keyFor(Selector selector)
			Gets the selection key for the channel with the given selector.
	final	SelectorProvider	provider()
			Answer the SelectorProvider of this channel.
	final	SelectionKey	register(Selector selector, int interestSet, Object attachment)
			Realize the register function.

Protected Methods

	synchronized	final	void	implCloseChannel()
				Implement the closing function.
abstract			void	implCloseSelectableChannel()
				Implement the closing function of the SelectableChannel.
abstract			void	implConfigureBlocking(boolean blockingMode)
				Implement the setting of blocking mode.

	Object	clone()
		Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
	boolean	equals(Object o)
		Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
	void	finalize()
		Called by the virtual machine when there are no longer any (non-weak) references to the receiver.
final	Class	getClass()
		Answers the unique instance of java.lang.Class which represents the class of the receiver.
	int	hashCode()
		Answers an integer hash code for the receiver.
final	void	notify()
		Causes one thread which is `wait` ing on the receiver to be made ready to run.
final	void	notifyAll()
		Causes all threads which are `wait` ing on the receiver to be made ready to run.
	String	toString()
		Answers a string containing a concise, human-readable description of the receiver.
final	void	wait(long time, int frac)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait(long time)
		Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by `notify` or `notifyAll`) or the expiration of the timeout.
final	void	wait()
		Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by `notify` or `notifyAll`).

Methods inherited from interface java.io.Closeable

Methods inherited from interface java.nio.channels.InterruptibleChannel

Methods inherited from interface java.nio.channels.Channel

close, isOpen

Details

Protected Constructors

protected AbstractSelectableChannel(SelectorProvider selectorProvider)

Constructor for this class.

Parameters

selectorProvider	A instance of SelectorProvider

Public Methods

public final Object blockingLock()

Gets the blocking lock which synchronizes the configureBlocking and register methods.

public final SelectableChannel configureBlocking(boolean blockingMode)

Set the blocking mode of this channel.

Parameters

blockingMode	`true` for blocking mode; `false` for non-blocking mode.

Throws

IOException

public final boolean isBlocking()

Returns if channel is in blocking mode.

public final synchronized boolean isRegistered()

Returns if channel is registered.

public final synchronized SelectionKey keyFor(Selector selector)

Gets the selection key for the channel with the given selector.

Parameters

selector	the selector with which this channel may register

public final SelectorProvider provider()

Answer the SelectorProvider of this channel.

Returns

The provider of this channel.

public final SelectionKey register(Selector selector, int interestSet, Object attachment)

Realize the register function.

It registers current channel to the selector, then answer the selection key. The channel must be open and the interest op set must be valid. If the current channel is already registered to the selector, the method only set the new interest op set; otherwise it will call the register in selector, and add the relative key to the key set of the current channel.

Parameters

selector	the selector with which this channel shall be registered
interestSet	the interesting operation
attachment	The attached object, which can be null

Throws

ClosedChannelException

Protected Methods

protected final synchronized void implCloseChannel()

Implement the closing function.

Throws

IOException

protected abstract void implCloseSelectableChannel()

Implement the closing function of the SelectableChannel.

Throws

IOException	If some I/O exception occurred.

protected abstract void implConfigureBlocking(boolean blockingMode)

Implement the setting of blocking mode.

Parameters

blockingMode	`true` for blocking mode; `false` for non-blocking mode.

Throws

IOException	If some I/O exception occurred.

				void	close()
					Closes an open channel.
				boolean	isOpen()
					Answers whether this channel is open or not.

DatagramChannel	A DatagramChannel is a selectable channel for part abstraction of datagram socket.
Pipe.SinkChannel	Writable sink channel for writing into.
Pipe.SourceChannel	Readable source channel for reading from.
ServerSocketChannel	A ServerSocketChannel is a partly abstracted stream-oriented listening socket which is selectable.
SocketChannel	A SocketChannel is a selectable channel for part abstraction of stream connecting socket.

		final	void	begin()
				Start an IO operation that is potentially blocking.
		final	void	close()
				Closes the channel.
		final	void	end(boolean success)
				End an IO operation that was previously started with `begin()`.
abstract			void	implCloseChannel()
				Implements the close channel behavior.
	synchronized	final	boolean	isOpen()
				Answers whether the channel is open.

				void	close()
					Close the object and release any system resources it holds.


e.g. "intent" or "activity"

Android - An Open Handset Alliance Project

Documentation

Goodies

java.nio.channels.spi.AbstractSelectableChannel

Known Direct Subclasses

Summary

Protected Constructors

Public Methods

Protected Methods

Methods inherited from class java.nio.channels.SelectableChannel

Methods inherited from class java.nio.channels.spi.AbstractInterruptibleChannel

Methods inherited from class java.lang.Object

Methods inherited from interface java.io.Closeable

Methods inherited from interface java.nio.channels.InterruptibleChannel

Methods inherited from interface java.nio.channels.Channel

Details

Protected Constructors

protected AbstractSelectableChannel(SelectorProvider selectorProvider)

Parameters

Public Methods

public final Object blockingLock()

See Also

public final SelectableChannel configureBlocking(boolean blockingMode)

Parameters

Throws

See Also

public final boolean isBlocking()

See Also

public final synchronized boolean isRegistered()

See Also

public final synchronized SelectionKey keyFor(Selector selector)

Parameters

See Also

public final SelectorProvider provider()

Returns

See Also

public final SelectionKey register(Selector selector, int interestSet, Object attachment)

Parameters

Throws

See Also

Protected Methods

protected final synchronized void implCloseChannel()

Throws

See Also

protected abstract void implCloseSelectableChannel()

Throws

protected abstract void implConfigureBlocking(boolean blockingMode)

Parameters

Throws