NetChannel (Neta Core 1.0.3 API)

java.lang.Object
- net.hasor.neta.channel.AttributeChannel<NetChannel>
- - net.hasor.neta.channel.NetChannel

所有已实现的接口:

NetDuplexChannel<NetChannel>, SoChannel<NetChannel>
```
public class NetChannel
extends AttributeChannel<NetChannel>
implements NetDuplexChannel<NetChannel>
```
A tcp network channel the channel that binds to the Application layer network protocol stack.

版本:

: 2023-09-24

作者:

赵永春 (zyc@hasor.net)

字段概要

字段
限定符和类型	字段和说明
`protected net.hasor.neta.channel.SoAsyncChannel`	`channel`
`protected net.hasor.cobble.concurrent.future.Future<NetChannel>`	`closeFuture`
`protected AtomicBoolean`	`closeStatus`
`protected net.hasor.neta.channel.SoContextImpl`	`context`
`protected PipeContextImpl`	`pipeCtx`
`protected Pipeline<ByteBuf>`	`pipeline`
`protected net.hasor.neta.channel.SoRcvCompletionHandler`	`rHandler`
`protected net.hasor.neta.channel.SoSndContext`	`wContext`
`protected net.hasor.neta.channel.SoSndCompletionHandler`	`wHandler`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`net.hasor.cobble.concurrent.future.Future<NetChannel>`	`close()` close this channel.
`net.hasor.cobble.concurrent.future.Future<NetChannel>`	`closeNow()` close this channel now.
`<T> T`	`findPipeContext(Class<T> serviceType)` Get the attachment for `PipeContext`
`net.hasor.cobble.concurrent.future.Future<NetChannel>`	`flush()` flash
`net.hasor.cobble.concurrent.future.Future<?>`	`flush(String pipeName)` sent data to remote, The network IO transfer operation is performed asynchronously.
`long`	`getChannelID()` channel id
`SoContext`	`getContext()` get context
`long`	`getCreatedTime()` channel accept time
`long`	`getLastActiveTime()` The last time data was received or sent
`long`	`getLastRcvTime()` last received data time
`long`	`getLastSndTime()` last sent data time
`NetListen`	`getListen()` Returns the `NetListen` that accepts this channel
`SocketAddress`	`getLocalAddr()` local `SocketAddress`
`int`	`getRcvBufferSize()` Returns the received buffer size.
`int`	`getRcvBufferUsed()` Returns the size of the received buffer used.
`long`	`getRcvBytes()` Number of bytes received
`SoHandlerStatus`	`getRcvHandlerStatus()` Returns the receiving Handler state
`int`	`getRcvSlotSize()` Returns the number of pipeline received slots.
`SocketAddress`	`getRemoteAddr()` get remote address of the channel
`int`	`getSndBufferSize()` Returns the send buffer size.
`int`	`getSndBufferUsed()` Returns the size of the send buffer used.
`long`	`getSndBytes()` Number of bytes send
`SoHandlerStatus`	`getSndHandlerStatus()` Returns the send Handler state
`int`	`getSndSlotSize()` Returns the number of pipeline send slots.
`void`	`ignoreReadEofFlag()` When shutdownOutput is called remotely, an end of read flag was encountered, which usually means closing the channel.
`protected void`	`initChannel(PipeContextImpl pipeContext, Pipeline<ByteBuf> pipeline)`
`boolean`	`isClient()` a connect `NetChannel`
`boolean`	`isClose()` return close status.
`boolean`	`isListen()` a `NetListen`
`boolean`	`isServer()` an accept `NetChannel`
`boolean`	`isShutdownInput()` Returns whether the read channel is closed.
`boolean`	`isShutdownOutput()` Returns whether the write channel is closed.
`void`	`printStackTrace()` Prints this pipline status and its backtrace to the System.out.
`void`	`printStackTrace(PrintStream s)` Prints this pipline status and its backtrace to the specified print stream.
`net.hasor.cobble.concurrent.future.Future<?>`	`sendData(Object writeData)` sent data to remote, The network IO transfer operation is performed asynchronously.
`net.hasor.cobble.concurrent.future.Future<NetChannel>`	`sendData(Object writeData, String pipeName)` sent data to remote, The network IO transfer operation is performed asynchronously.
`void`	`setReadTimeout()` Sets a timer that will fire readTimeout if no network data is received within a specified amount of time.
`void`	`setReadTimeout(int timeout, TimeUnit unit)` Sets a timer that will fire readTimeout if no network data is received within a specified amount of time.
`void`	`shutdownInput()` Shutdown the connection for reading without closing the channel.
`void`	`shutdownOutput()` Shutdown the connection for write without closing the channel.
`void`	`waitReceive()` expect new data to be received within SoReadTimeoutMs
`void`	`waitReceive(int timeout, TimeUnit unit)` expect new data to be received within timeout.

从类继承的方法 net.hasor.neta.channel.AttributeChannel
getAttribute, setAttribute

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 net.hasor.neta.channel.SoChannel
getAttribute, setAttribute

- 字段详细资料
  - channel
```
protected final net.hasor.neta.channel.SoAsyncChannel channel
```
  - wContext
```
protected final net.hasor.neta.channel.SoSndContext wContext
```
  - context
```
protected final net.hasor.neta.channel.SoContextImpl context
```
  - rHandler
```
protected final net.hasor.neta.channel.SoRcvCompletionHandler rHandler
```
  - wHandler
```
protected final net.hasor.neta.channel.SoSndCompletionHandler wHandler
```
  - pipeCtx
```
protected PipeContextImpl pipeCtx
```
  - pipeline
```
protected Pipeline<ByteBuf> pipeline
```
  - closeStatus
```
protected final AtomicBoolean closeStatus
```
  - closeFuture
```
protected final net.hasor.cobble.concurrent.future.Future<NetChannel> closeFuture
```
- 方法详细资料
  - initChannel
```
protected void initChannel(PipeContextImpl pipeContext,
                           Pipeline<ByteBuf> pipeline)
```
  - getChannelID
```
public long getChannelID()
```
    从接口复制的说明: SoChannel
    
    channel id
    
    指定者:
    
    getChannelID 在接口中 SoChannel<NetChannel>
  - isListen
```
public boolean isListen()
```
    从接口复制的说明: SoChannel
    
    a NetListen
    
    指定者:
    
    isListen 在接口中 SoChannel<NetChannel>
  - getCreatedTime
```
public long getCreatedTime()
```
    从接口复制的说明: SoChannel
    
    channel accept time
    
    指定者:
    
    getCreatedTime 在接口中 SoChannel<NetChannel>
  - getLastActiveTime
```
public long getLastActiveTime()
```
    从接口复制的说明: SoChannel
    
    The last time data was received or sent
    
    指定者:
    
    getLastActiveTime 在接口中 SoChannel<NetChannel>
  - getLastSndTime
```
public long getLastSndTime()
```
    last sent data time
  - getLastRcvTime
```
public long getLastRcvTime()
```
    last received data time
  - getRcvHandlerStatus
```
public SoHandlerStatus getRcvHandlerStatus()
```
    Returns the receiving Handler state
  - getSndHandlerStatus
```
public SoHandlerStatus getSndHandlerStatus()
```
    Returns the send Handler state
  - isServer
```
public boolean isServer()
```
    从接口复制的说明: SoChannel
    
    an accept NetChannel
    
    指定者:
    
    isServer 在接口中 SoChannel<NetChannel>
  - isClient
```
public boolean isClient()
```
    从接口复制的说明: SoChannel
    
    a connect NetChannel
    
    指定者:
    
    isClient 在接口中 SoChannel<NetChannel>
  - isShutdownInput
```
public boolean isShutdownInput()
```
    从接口复制的说明: NetDuplexChannel
    
    Returns whether the read channel is closed.
    
    指定者:
    
    isShutdownInput 在接口中 NetDuplexChannel<NetChannel>
  - ignoreReadEofFlag
```
public void ignoreReadEofFlag()
```
    从接口复制的说明: NetDuplexChannel
    
    When shutdownOutput is called remotely, an end of read flag was encountered, which usually means closing the channel. But the remote still has the ability to receive data.
    
    so use NetDuplexChannel.ignoreReadEofFlag() method, keep the channel state and continue to send data
    
    Once NetDuplexChannel.ignoreReadEofFlag() is activated, the release of remote connections needs to be managed manually, leading to NetChannel leakage if not released in time
    
    指定者:
    
    ignoreReadEofFlag 在接口中 NetDuplexChannel<NetChannel>
  - shutdownInput
```
public void shutdownInput()
```
    从接口复制的说明: NetDuplexChannel
    
    Shutdown the connection for reading without closing the channel.
    
    指定者:
    
    shutdownInput 在接口中 NetDuplexChannel<NetChannel>
  - isShutdownOutput
```
public boolean isShutdownOutput()
```
    从接口复制的说明: NetDuplexChannel
    
    Returns whether the write channel is closed.
    
    指定者:
    
    isShutdownOutput 在接口中 NetDuplexChannel<NetChannel>
  - shutdownOutput
```
public void shutdownOutput()
```
    从接口复制的说明: NetDuplexChannel
    
    Shutdown the connection for write without closing the channel.
    
    指定者:
    
    shutdownOutput 在接口中 NetDuplexChannel<NetChannel>
  - getLocalAddr
```
public SocketAddress getLocalAddr()
```
    从接口复制的说明: SoChannel
    
    local SocketAddress
    
    指定者:
    
    getLocalAddr 在接口中 SoChannel<NetChannel>
  - getRemoteAddr
```
public SocketAddress getRemoteAddr()
```
    从接口复制的说明: SoChannel
    
    get remote address of the channel
    
    指定者:
    
    getRemoteAddr 在接口中 SoChannel<NetChannel>
  - getContext
```
public SoContext getContext()
```
    从接口复制的说明: SoChannel
    
    get context
    
    指定者:
    
    getContext 在接口中 SoChannel<NetChannel>
  - findPipeContext
```
public <T> T findPipeContext(Class<T> serviceType)
```
    从接口复制的说明: SoChannel
    
    Get the attachment for PipeContext
    
    指定者:
    
    findPipeContext 在接口中 SoChannel<NetChannel>
  - getListen
```
public NetListen getListen()
```
    Returns the NetListen that accepts this channel
  - isClose
```
public boolean isClose()
```
    从接口复制的说明: SoChannel
    
    return close status.
    
    指定者:
    
    isClose 在接口中 SoChannel<NetChannel>
  - close
```
public net.hasor.cobble.concurrent.future.Future<NetChannel> close()
```
    从接口复制的说明: SoChannel
    
    close this channel.
  - For the Listen channel, listening is turned off.
  - For the Socket channel, will be closed after all data are written.

指定者:: close 在接口中 SoChannel<NetChannel>

closeNow
```
public net.hasor.cobble.concurrent.future.Future<NetChannel> closeNow()
```
从接口复制的说明: SoChannel

close this channel now.

指定者:

closeNow 在接口中 SoChannel<NetChannel>

getRcvBytes
```
public long getRcvBytes()
```
Number of bytes received

getSndBytes
```
public long getSndBytes()
```
Number of bytes send

getRcvBufferSize
```
public int getRcvBufferSize()
```
Returns the received buffer size.

getSndBufferSize
```
public int getSndBufferSize()
```
Returns the send buffer size.

getRcvBufferUsed
```
public int getRcvBufferUsed()
```
Returns the size of the received buffer used.

getSndBufferUsed
```
public int getSndBufferUsed()
```
Returns the size of the send buffer used.

getRcvSlotSize
```
public int getRcvSlotSize()
```
Returns the number of pipeline received slots.

getSndSlotSize
```
public int getSndSlotSize()
```
Returns the number of pipeline send slots.

sendData
```
public net.hasor.cobble.concurrent.future.Future<?> sendData(Object writeData)
```
sent data to remote, The network IO transfer operation is performed asynchronously.
data goes through the application layer network protocol stack

sendData

public net.hasor.cobble.concurrent.future.Future<NetChannel> sendData(Object writeData,
                                                                      String pipeName)

sent data to remote, The network IO transfer operation is performed asynchronously.

data goes through the application layer network protocol stack

flush

public net.hasor.cobble.concurrent.future.Future<NetChannel> flush()

flash

flush
```
public net.hasor.cobble.concurrent.future.Future<?> flush(String pipeName)
```
sent data to remote, The network IO transfer operation is performed asynchronously.
data goes through the application layer network protocol stack

setReadTimeout
```
public void setReadTimeout()
```
Sets a timer that will fire readTimeout if no network data is received within a specified amount of time.

另请参阅:

SoConfig.getSoReadTimeoutMs()

setReadTimeout
```
public void setReadTimeout(int timeout,
                           TimeUnit unit)
```
Sets a timer that will fire readTimeout if no network data is received within a specified amount of time.

waitReceive
```
public void waitReceive()
                 throws InterruptedException,
                        SoReadTimeoutException
```
expect new data to be received within SoReadTimeoutMs

抛出:

InterruptedException

SoReadTimeoutException

另请参阅:

SoConfig.getSoReadTimeoutMs()

waitReceive

public void waitReceive(int timeout,
                        TimeUnit unit)
                 throws InterruptedException,
                        SoReadTimeoutException

expect new data to be received within timeout.

抛出:: InterruptedException; SoReadTimeoutException
另请参阅:: SoConfig.getSoReadTimeoutMs()

printStackTrace
```
public void printStackTrace()
```
Prints this pipline status and its backtrace to the System.out.

printStackTrace
```
public void printStackTrace(PrintStream s)
```
Prints this pipline status and its backtrace to the specified print stream.

参数:

s - PrintStream to use for output

类 NetChannel

字段概要

方法概要

从类继承的方法 net.hasor.neta.channel.AttributeChannel

从类继承的方法 java.lang.Object

从接口继承的方法 net.hasor.neta.channel.SoChannel

字段详细资料

channel

wContext

context

rHandler

wHandler

pipeCtx

pipeline

closeStatus

closeFuture

方法详细资料

initChannel

getChannelID

isListen

getCreatedTime

getLastActiveTime

getLastSndTime

getLastRcvTime

getRcvHandlerStatus

getSndHandlerStatus

isServer

isClient

isShutdownInput

ignoreReadEofFlag

shutdownInput

isShutdownOutput

shutdownOutput

getLocalAddr

getRemoteAddr

getContext

findPipeContext

getListen

isClose

close

closeNow

getRcvBytes

getSndBytes

getRcvBufferSize

getSndBufferSize

getRcvBufferUsed

getSndBufferUsed

getRcvSlotSize

getSndSlotSize

sendData

sendData

flush

flush

setReadTimeout

setReadTimeout

waitReceive

waitReceive

printStackTrace

printStackTrace