to top

Summary: Protected Ctors | Methods | Inherited Methods | [Expand All]

Added in API level 1

public abstract class

ServerSocketChannel

extends AbstractSelectableChannel

java.lang.Object
↳	java.nio.channels.spi.AbstractInterruptibleChannel
	↳	java.nio.channels.SelectableChannel
		↳	java.nio.channels.spi.AbstractSelectableChannel
			↳	java.nio.channels.ServerSocketChannel

Class Overview

A ServerSocketChannel is a partial abstraction of a selectable, stream-oriented listening socket. Binding and manipulation of socket options can only be done through the associated ServerSocket object, returned by calling socket(). ServerSocketChannels can not be constructed for an already existing server-socket, nor can a SocketImpl be assigned.

A server-socket channel is open but not bound when created by the open() method. Calling accept before bound will cause a NotYetBoundException. It can be bound by calling the bind method of a related ServerSocket instance.

Summary

Protected Constructors
	ServerSocketChannel(SelectorProvider selectorProvider) Constructs a new `ServerSocketChannel`.

Public Methods
abstract SocketChannel	accept() Accepts a connection to this server-socket channel.
static ServerSocketChannel	open() Creates an open and unbound server-socket channel.
abstract ServerSocket	socket() Return the server-socket assigned this channel, which does not declare any public methods that are not declared in `ServerSocket`.
final int	validOps() Gets the valid operations of this channel.

[Expand]

Inherited Methods

From class java.nio.channels.spi.AbstractSelectableChannel

final Object	blockingLock() Gets the object used for the synchronization of `register` and `configureBlocking`.
final SelectableChannel	configureBlocking(boolean blockingMode) Sets the blocking mode of this channel.
synchronized final void	implCloseChannel() Implements the channel closing behavior.
abstract void	implCloseSelectableChannel() Implements the closing function of the SelectableChannel.
abstract void	implConfigureBlocking(boolean blocking) Implements the configuration of blocking/non-blocking mode.
final boolean	isBlocking() Indicates whether this channel is in blocking mode.
synchronized final boolean	isRegistered() Indicates whether this channel is registered with one or more selectors.
synchronized final SelectionKey	keyFor(Selector selector) Gets this channel's selection key for the specified selector.
final SelectorProvider	provider() Returns the selector provider that has created this channel.
final SelectionKey	register(Selector selector, int interestSet, Object attachment) Registers this channel with the specified selector for the specified interest set.

From class java.nio.channels.SelectableChannel

abstract Object	blockingLock() Gets the blocking lock which synchronizes the `configureBlocking` and `register` methods.
abstract SelectableChannel	configureBlocking(boolean block) Sets the blocking mode of this channel.
abstract boolean	isBlocking() Indicates whether this channel is in blocking mode.
abstract boolean	isRegistered() Indicates whether this channel is registered with at least one selector.
abstract SelectionKey	keyFor(Selector sel) Gets this channel's selection key for the specified selector.
abstract SelectorProvider	provider() Gets the provider of this channel.
final SelectionKey	register(Selector selector, int operations) Registers this channel with the specified selector for the specified interest set.
abstract SelectionKey	register(Selector sel, int ops, Object att) Registers this channel with the specified selector for the specified interest set and an object to attach.
abstract int	validOps() Gets the set of valid `operations` of this channel.

From class java.nio.channels.spi.AbstractInterruptibleChannel

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.io.Closeable

From interface java.nio.channels.Channel

From interface java.nio.channels.InterruptibleChannel

Protected Constructors

protected ServerSocketChannel (SelectorProvider selectorProvider)

Added in API level 1

Constructs a new ServerSocketChannel.

Parameters

selectorProvider	an instance of SelectorProvider.

Public Methods

public abstract SocketChannel accept ()

Added in API level 1

Accepts a connection to this server-socket channel.

This method returns null when this channel is non-blocking and no connection is available, otherwise it blocks until a new connection is available or an I/O error occurs. The socket channel returned by this method will always be in blocking mode.

This method just executes the same security checks as the accept() method of the ServerSocket class.

Returns

the accepted SocketChannel instance, or null if the channel is non-blocking and no connection is available.

Throws

AsynchronousCloseException	if this channel is closed by another thread while this method is in operation.
ClosedByInterruptException	if another thread interrupts the calling thread while this operation is in progress. The interrupt state of the calling thread is set and the channel is closed.
ClosedChannelException	if this channel is closed.
IOException	if another I/O error occurs.
NotYetBoundException	if the socket has not yet been bound.

public static ServerSocketChannel open ()

Added in API level 1

Creates an open and unbound server-socket channel.

This channel is created by calling openServerSocketChannel method of the default SelectorProvider instance.

Returns

the new channel which is open but unbound.

Throws

IOException	if an I/O error occurs.

public abstract ServerSocket socket ()

Added in API level 1

Return the server-socket assigned this channel, which does not declare any public methods that are not declared in ServerSocket.

Returns

the server-socket assigned to this channel.

public final int validOps ()

Added in API level 1

Gets the valid operations of this channel. Server-socket channels support accepting operation, so this method returns SelectionKey.OP_ACCEPT.

Returns

the operations supported by this channel.

Results

Interfaces

Classes

Exceptions

ServerSocketChannel

Class Overview

Summary

Protected Constructors

protected ServerSocketChannel (SelectorProvider selectorProvider)

Parameters

Public Methods

public abstract SocketChannel accept ()

Returns

Throws

public static ServerSocketChannel open ()

Returns

Throws

public abstract ServerSocket socket ()

Returns

public final int validOps ()

Returns

See Also