A {@link ServerSocketChannelFactory} which creates a server-side blockingI/O based {@link ServerSocketChannel}. It utilizes the good old blocking I/O API which is known to yield better throughput and latency when there are relatively small number of connections to serve.
How threads work
There are two types of threads in a {@link OioServerSocketChannelFactory}; one is boss thread and the other is worker thread.
Boss threads
Each bound {@link ServerSocketChannel} has its own boss thread.For example, if you opened two server ports such as 80 and 443, you will have two boss threads. A boss thread accepts incoming connections until the port is unbound. Once a connection is accepted successfully, the boss thread passes the accepted {@link Channel} to one of the workerthreads that the {@link OioServerSocketChannelFactory} manages.
Worker threads
Each connected {@link Channel} has a dedicated worker thread, just like atraditional blocking I/O thread model.
Life cycle of threads and graceful shutdown
All threads are acquired from the {@link Executor}s which were specified when a {@link OioServerSocketChannelFactory} was created. Boss threads areacquired from the {@code bossExecutor}, and worker threads are acquired from the {@code workerExecutor}. Therefore, you should make sure the specified {@link Executor}s are able to lend the sufficient number of threads.
Both boss and worker threads are acquired lazily, and then released when there's nothing left to process. All the related resources are also released when the boss and worker threads are released. Therefore, to shut down a service gracefully, you should do the following:
- unbind all channels created by the factory,
- close all child channels accepted by the unbound channels,
- call {@link ExecutorService#shutdownNow()} for all executors which werespecified to create the factory, and
- call {@link ExecutorService#awaitTermination(long,TimeUnit)}until it returns {@code true}.
Please make sure not to shut down the executor until all channels are closed. Otherwise, you will end up with a {@link RejectedExecutionException}and the related resources might not be released properly.
Limitation
A {@link ServerSocketChannel} created by this factory and its child channelsdo not support asynchronous operations. Any I/O requests such as {@code "write"} will be performed in a blocking manner.
@author The Netty Project (netty-dev@lists.jboss.org)
@author Trustin Lee (tlee@redhat.com)
@version $Rev: 536 $, $Date: 2008-11-28 20:18:21 +0900 (Fri, 28 Nov 2008) $
@apiviz.landmark