Channel (Netty API Reference (4.1.22.Final))

All Superinterfaces:

AttributeMap ， ChannelOutboundInvoker ，java.lang.Comparable的< Channel >

All Known Subinterfaces:

DatagramChannel ， DomainSocketChannel ， DuplexChannel ， Http2StreamChannel ， SctpChannel ， SctpServerChannel ， ServerChannel ， ServerDomainSocketChannel ， ServerSocketChannel ， SocketChannel ， UdtChannel ， UdtServerChannel ， UnixChannel

所有已知实现类：

AbstractChannel ， AbstractEpollServerChannel ， AbstractEpollStreamChannel ， AbstractKQueueServerChannel ， AbstractKQueueStreamChannel ， AbstractNioByteChannel ， AbstractNioChannel ， AbstractNioMessageChannel ， AbstractOioByteChannel ， AbstractOioChannel ， AbstractOioMessageChannel ， AbstractServerChannel ， EmbeddedChannel ， EpollDatagramChannel ， EpollDomainSocketChannel ， EpollServerDomainSocketChannel ， EpollServerSocketChannel ， EpollSocketChannel ， KQueueDatagramChannel ， KQueueDomainSocketChannel ， KQueueServerDomainSocketChannel ， KQueueServerSocketChannel ， KQueueSocketChannel ， LocalChannel ， LocalServerChannel ， NioDatagramChannel ， NioSctpChannel ， NioSctpServerChannel ， NioServerSocketChannel ， NioSocketChannel ， NioUdtAcceptorChannel ， NioUdtByteAcceptorChannel ， NioUdtByteConnectorChannel ， NioUdtByteRendezvousChannel ， NioUdtMessageAcceptorChannel ， NioUdtMessageConnectorChannel ， NioUdtMessageRendezvousChannel ， OioByteStreamChannel ， OioDatagramChannel ， OioSctpChannel ， OioSctpServerChannel ， OioServerSocketChannel ， OioSocketChannel ， RxtxChannel
```
public interface Channel
extends AttributeMap, ChannelOutboundInvoker, java.lang.Comparable<Channel>
```
与网络套接字或能够进行I / O操作（如读取，写入，连接和绑定）的组件的关系。
一个频道为用户提供：
- 频道的当前状态（例如，它是否打开？是否连接？），
- 通道的configuration parameters （例如接收缓冲区大小），
- 通道支持的I / O操作（例如读取，写入，连接和绑定）和
- 处理所有I / O事件和与该通道相关的请求的ChannelPipeline 。
所有的I / O操作都是异步的。

Netty中的所有I / O操作都是异步的。这意味着任何I / O调用都将立即返回，不保证在呼叫结束时所请求的I / O操作已完成。相反，您将返回一个ChannelFuture实例，该实例将在请求的I / O操作成功，失败或取消时通知您。

渠道是分层的

一个Channel可以有一个parent取决于它是如何创建的。例如，被ServerSocketChannel接受的SocketChannel将返回parent()作为其母公司的ServerSocketChannel 。

层次结构的语义取决于Channel所属的传输实现。例如，您可以编写一个新的Channel实现，创建共享一个套接字连接的子通道，如BEEP和SSH 。

Downcast访问特定于传输的操作

一些运输公开了特定于运输的额外操作。将Channel向下转换为子类型以调用此类操作。例如，对于旧的I / O数据报传输，多播加入/离开操作由DatagramChannel提供。

释放资源

它打电话是重要ChannelOutboundInvoker.close()或ChannelOutboundInvoker.close(ChannelPromise)释放所有资源，一旦你与完成Channel 。这确保所有资源都以适当的方式释放，即文件句柄。

Nested Class Summary

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`Channel.Unsafe` 不应该从用户代码调用的不安全操作。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`ByteBufAllocator`	`alloc()` 返回分配的`ByteBufAllocator`这将被用于分配`ByteBuf`秒。
`long`	`bytesBeforeUnwritable()` 获取可以写入多少个字节，直到 `isWritable()`返回 `false` 。
`long`	`bytesBeforeWritable()` 从 `isWritable()`返回 `true`之前，必须从底层缓冲区中清除多少个字节。
`ChannelFuture`	`closeFuture()` 返回此通道关闭时将通知的`ChannelFuture` 。
`ChannelConfig`	`config()` 返回此频道的配置。
`EventLoop`	`eventLoop()` 返回`EventLoop`这`Channel`被注册。
`Channel`	`flush()` 请求通过此ChannelOutboundInvoker清除所有未决消息。
`ChannelId`	`id()` 返回此`Channel`的全局唯一标识符。
`boolean`	`isActive()` 如果`Channel`处于活动状态并已连接，则返回`true` 。
`boolean`	`isOpen()` 如果`Channel`已打开并且稍后可能会激活，则返回`true`
`boolean`	`isRegistered()` 如果`Channel`已注册`true`则返回true 。
`boolean`	`isWritable()` 当且仅当I / O线程将立即执行请求的写入操作时返回 `true` 。
`java.net.SocketAddress`	`localAddress()` 返回此通道绑定的本地地址。
`ChannelMetadata`	`metadata()` 返回`ChannelMetadata`的的`Channel`其描述的性质`Channel` 。
`Channel`	`parent()` 返回此频道的父级。
`ChannelPipeline`	`pipeline()` 返回分配的`ChannelPipeline` 。
`Channel`	`read()` 请求来读取数据`Channel`进入第一入缓冲区，触发`ChannelInboundHandler.channelRead(ChannelHandlerContext, Object)`如果数据读取事件，并触发`channelReadComplete`事件，这样的处理可以决定继续读书。
`java.net.SocketAddress`	`remoteAddress()` 返回此通道连接到的远程地址。
`Channel.Unsafe`	`unsafe()` 返回提供不安全操作的仅供内部使用的对象。

Methods inherited from interface io.netty.util.AttributeMap
attr, hasAttr

Methods inherited from interface io.netty.channel.ChannelOutboundInvoker
bind, bind, close, close, connect, connect, connect, connect, deregister, deregister, disconnect, disconnect, newFailedFuture, newProgressivePromise, newPromise, newSucceededFuture, voidPromise, write, write, writeAndFlush, writeAndFlush

Methods inherited from interface java.lang.Comparable
compareTo

- 方法详细信息
  - id
```
ChannelId id()
```
    返回此Channel的全局唯一标识符。
  - eventLoop
```
EventLoop eventLoop()
```
    返回EventLoop这Channel被注册。
  - parent
```
Channel parent()
```
    返回此频道的父级。
    
    结果
    
    父频道。 null如果此频道没有父频道。
  - config
```
ChannelConfig config()
```
    返回此频道的配置。
  - isOpen
```
boolean isOpen()
```
    如果Channel已打开并且稍后可能会激活，则返回true
  - isRegistered
```
boolean isRegistered()
```
    如果Channel已注册true则返回true 。
  - isActive
```
boolean isActive()
```
    如果Channel处于活动状态并已连接，则返回true 。
  - metadata
```
ChannelMetadata metadata()
```
    返回ChannelMetadata的的Channel其描述的性质Channel 。
  - localAddress
```
java.net.SocketAddress localAddress()
```
    返回此通道绑定的本地地址。返回的SocketAddress应该被下调为更具体的类型，例如InetSocketAddress以检索详细信息。
    
    结果
    
    这个频道的本地地址。 null如果这个频道没有绑定。
  - remoteAddress
```
java.net.SocketAddress remoteAddress()
```
    返回此通道连接到的远程地址。返回的SocketAddress应该被缩减为更具体的类型，例如InetSocketAddress以检索详细信息。
    
    结果
    
    该频道的远程地址。 null如果此通道未连接。如果此通道未连接，但它可以接收来自任意远程地址的消息（例如DatagramChannel ，请使用DefaultAddressedEnvelope.recipient()来确定接收消息的来源，因为此方法将返回null 。
  - closeFuture
```
ChannelFuture closeFuture()
```
    返回此通道关闭时将通知的ChannelFuture 。此方法始终返回相同的未来实例。
  - isWritable
```
boolean isWritable()
```
    当且仅当I / O线程将立即执行请求的写操作时返回true 。当此方法返回false时发出的任何写请求false排队，直到I / O线程准备好处理排队的写请求为止。
  - bytesBeforeUnwritable
```
long bytesBeforeUnwritable()
```
    获取多少个字节，直到isWritable()返回false 。这个数量永远是非负的。如果isWritable()是false 0。
  - bytesBeforeWritable
```
long bytesBeforeWritable()
```
    从isWritable()返回true之前，必须从底层缓冲区中清除多少个字节。这个数量永远是非负的。如果isWritable()是true 0。
  - unsafe
```
Channel.Unsafe unsafe()
```
    返回提供不安全操作 的仅供内部使用的对象。
  - pipeline
```
ChannelPipeline pipeline()
```
    返回分配的ChannelPipeline 。
  - alloc
```
ByteBufAllocator alloc()
```
    返回分配的ByteBufAllocator这将被用于分配ByteBuf秒。
  - read
```
Channel read()
```
    从界面复制的描述： ChannelOutboundInvoker
    
    请求来读取数据Channel进入第一入缓冲区，触发ChannelInboundHandler.channelRead(ChannelHandlerContext, Object)如果数据读取事件，并触发channelReadComplete事件，这样的处理可以决定继续读书。如果已经有待处理的读取操作，则此方法不执行任何操作。
    这将导致在具有ChannelOutboundHandler.read(ChannelHandlerContext)方法称为下一个的ChannelOutboundHandler包含在ChannelPipeline的的Channel 。
    
    Specified by:
    
    read在界面 ChannelOutboundInvoker
  - flush
```
Channel flush()
```
    从接口复制的描述： ChannelOutboundInvoker
    
    请求通过此ChannelOutboundInvoker清除所有未决消息。
    
    Specified by:
    
    flush在界面 ChannelOutboundInvoker

Interface Channel

所有的I / O操作都是异步的。

渠道是分层的

Downcast访问特定于传输的操作

释放资源

Nested Class Summary

方法摘要

Methods inherited from interface io.netty.util.AttributeMap

Methods inherited from interface io.netty.channel.ChannelOutboundInvoker

Methods inherited from interface java.lang.Comparable

方法详细信息

id

eventLoop

parent

config

isOpen

isRegistered

isActive

metadata

localAddress

remoteAddress

closeFuture

isWritable

bytesBeforeUnwritable

bytesBeforeWritable

unsafe

pipeline

alloc

read

flush