public class OioServerSocketChannelFactory extends Object implements ServerSocketChannelFactory
ServerSocketChannelFactorywhich creates a server-side blocking I/O based
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.
There are two types of threads in a
one is boss thread and the other is worker thread.
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
Channel to one of the worker
threads that the
Channel has a dedicated worker thread, just like a
traditional blocking I/O thread model.
All threads are acquired from the
Executors which were specified
OioServerSocketChannelFactory was created. Boss threads are
acquired from the
bossExecutor, and worker threads are acquired from
workerExecutor. Therefore, you should make sure the specified
Executors 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:
RejectedExecutionExceptionand the related resources might not be released properly.
ServerSocketChannel created by this factory and its child channels
do not support asynchronous operations. Any I/O requests such as
"write" will be performed in a blocking manner.
|Constructor and Description|
Creates a new instance.
Creates a new instance.
|Modifier and Type||Method and Description|
Releases the external resources that this factory depends on to function.
Shudown the ChannelFactory and all the resource it created internal.
public OioServerSocketChannelFactory(Executor bossExecutor, Executor workerExecutor, ThreadNameDeterminer determiner)
public ServerSocketChannel newChannel(ChannelPipeline pipeline)
public void shutdown()
public void releaseExternalResources()
Executors that you specified in the factory constructor are external resources. You can call this method to release all external resources conveniently when the resources are not used by this factory or any other part of your application. An unexpected behavior will be resulted in if the resources are released when there's an open channel which is managed by this factory. This will also call
ChannelFactory.shutdown()before do any action
Copyright © 2008-2016 The Netty Project. All Rights Reserved.