org.jboss.netty.channel

接口 ChannelFactory

所有超级接口:

ExternalResourceReleasable

所有已知子接口:

ClientSocketChannelFactory, DatagramChannelFactory, LocalClientChannelFactory, LocalServerChannelFactory, ServerChannelFactory, ServerSocketChannelFactory

所有已知实现类:

DefaultLocalClientChannelFactory, DefaultLocalServerChannelFactory, HttpTunnelingClientSocketChannelFactory, NioClientSocketChannelFactory, NioDatagramChannelFactory, NioServerSocketChannelFactory, OioClientSocketChannelFactory, OioDatagramChannelFactory, OioServerSocketChannelFactory

public interface ChannelFactory
extends ExternalResourceReleasable

The main interface to a transport that creates a Channel associated with a certain communication entity such as a network socket. For example, the NioServerSocketChannelFactory creates a channel which has a NIO-based server socket as its underlying communication entity.

Once a new Channel is created, the ChannelPipeline which was specified as a parameter in the newChannel(ChannelPipeline) is attached to the new Channel, and starts to handle all associated ChannelEvents.

Graceful shutdown

To shut down a network application service which is managed by a factory. you should follow the following steps:

1. close all channels created by the factory and their child channels usually using ChannelGroup.close(), and
2. call releaseExternalResources().

For detailed transport-specific information on shutting down a factory, please refer to the Javadoc of ChannelFactory's subtypes, such as NioServerSocketChannelFactory.

方法概要

方法

限定符和类型	方法和说明
Channel	newChannel(ChannelPipeline pipeline) Creates and opens a new Channel and attaches the specified ChannelPipeline to the new Channel.
void	releaseExternalResources() Releases the external resources that this factory depends on to function.
void	shutdown() Shudown the ChannelFactory and all the resource it created internal.

方法详细资料

newChannel

Channel newChannel(ChannelPipeline pipeline)

Creates and opens a new Channel and attaches the specified ChannelPipeline to the new Channel.

参数:

pipeline - the ChannelPipeline which is going to be attached to the new Channel

返回:

the newly open channel

抛出:

ChannelException - if failed to create and open a new channel

shutdown

void shutdown()

Shudown the ChannelFactory and all the resource it created internal.

releaseExternalResources

void releaseExternalResources()

Releases the external resources that this factory depends on to function. An external resource is a resource that this factory didn't create by itself. For example, 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 shutdown() before do any action

指定者:

releaseExternalResources 在接口中 ExternalResourceReleasable