All Superinterfaces:

ChannelInboundInvoker, ChannelOutboundInvoker, FuturePromiseFactory

All Known Implementing Classes:

DelegatingChannelHandlerContext
```
public interface ChannelHandlerContext
extends ChannelInboundInvoker, ChannelOutboundInvoker
```
Enables a ChannelHandler to interact with its ChannelPipeline and other handlers. Among other things a handler can notify the next ChannelHandler in the ChannelPipeline as well as modify the ChannelPipeline it belongs to dynamically.
Notify
You can notify the closest handler in the same ChannelPipeline by calling one of the various methods provided here. Please refer to ChannelPipeline to understand how an event flows.
Modifying a pipeline
You can get the ChannelPipeline your handler belongs to by calling pipeline(). A non-trivial application could insert, remove, or replace handlers in the pipeline dynamically at runtime.
Retrieving for later use
You can keep the ChannelHandlerContext for later use, such as triggering an event outside the handler methods, even from a different thread.
```
 public class MyHandler extends ChannelHandler {

     private ChannelHandlerContext ctx;

     public void handlerAdded(ChannelHandlerContext ctx) {
         this.ctx = ctx;
     }

     public void login(String username, password) {
         ctx.write(new LoginMessage(username, password));
     }
     ...
 }
 
```
A handler can have more than one context
Please note that a ChannelHandler instance can be added to more than one ChannelPipeline. It means a single ChannelHandler instance can have more than one ChannelHandlerContext and therefore the single instance can be invoked with different ChannelHandlerContexts if it is added to one or more ChannelPipelines more than once.
Additional resources worth reading

Please refer to the ChannelHandler, and ChannelPipeline to find out more about inbound and outbound operations, what fundamental differences they have, how they flow in a pipeline, and how to handle the operation in your application.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method	Description
`default BufferAllocator`	`bufferAllocator()`	Return the assigned `BufferAllocator` which will be used to allocate `Buffer`s.
`default Channel`	`channel()`	Return the `Channel` which is bound to the `ChannelHandlerContext`.
`ChannelHandlerContext`	`fireChannelActive()`	A `Channel` is active now, which means it is connected.
`ChannelHandlerContext`	`fireChannelExceptionCaught(Throwable cause)`	A `Channel` received an `Throwable` in one of its inbound operations.
`ChannelHandlerContext`	`fireChannelInactive()`	A `Channel` is inactive now, which means it is closed.
`ChannelHandlerContext`	`fireChannelInboundEvent(Object evt)`	A `Channel` received a custom defined inbound event.
`ChannelHandlerContext`	`fireChannelRead(Object msg)`	A `Channel` received a message.
`ChannelHandlerContext`	`fireChannelReadComplete()`	Triggers an `ChannelHandler.channelReadComplete(ChannelHandlerContext)` event to the next `ChannelHandler` in the `ChannelPipeline`.
`ChannelHandlerContext`	`fireChannelRegistered()`	A `Channel` was registered to its `EventLoop`.
`ChannelHandlerContext`	`fireChannelShutdown(ChannelShutdownDirection direction)`	A `Channel` was shutdown in a specific direction.
`ChannelHandlerContext`	`fireChannelUnregistered()`	A `Channel` was unregistered from its `EventLoop`.
`ChannelHandlerContext`	`fireChannelWritabilityChanged()`	Triggers an `ChannelHandler.channelWritabilityChanged(ChannelHandlerContext)` event to the next `ChannelHandler` in the `ChannelPipeline`.
`ChannelHandlerContext`	`flush()`	Request to flush all pending messages via this ChannelOutboundInvoker.
`ChannelHandler`	`handler()`	The `ChannelHandler` that is bound this `ChannelHandlerContext`.
`boolean`	`isRemoved()`	Return `true` if the `ChannelHandler` which belongs to this context was removed from the `ChannelPipeline`.
`String`	`name()`	The unique name of the `ChannelHandlerContext`.The name was used when then `ChannelHandler` was added to the `ChannelPipeline`.
`ChannelPipeline`	`pipeline()`	Return the assigned `ChannelPipeline`
`ChannelHandlerContext`	`read()`	Request to Read data from the `Channel` into the first inbound buffer, triggers an `ChannelHandler.channelRead(ChannelHandlerContext, Object)` event if data was read, and triggers a `channelReadComplete` event so the handler can decide to continue reading.

Methods inherited from interface io.netty5.channel.ChannelOutboundInvoker
bind, close, connect, connect, deregister, disconnect, executor, newFailedFuture, newPromise, newSucceededFuture, newSucceededFuture, register, sendOutboundEvent, shutdown, write, writeAndFlush

- Method Detail
  - channel
```
default Channel channel()
```
    Return the Channel which is bound to the ChannelHandlerContext.
  - name
```
String name()
```
    The unique name of the ChannelHandlerContext.The name was used when then ChannelHandler was added to the ChannelPipeline. This name can also be used to access the registered ChannelHandler from the ChannelPipeline.
  - handler
```
ChannelHandler handler()
```
    The ChannelHandler that is bound this ChannelHandlerContext.
  - isRemoved
```
boolean isRemoved()
```
    Return true if the ChannelHandler which belongs to this context was removed from the ChannelPipeline.
  - fireChannelRegistered
```
ChannelHandlerContext fireChannelRegistered()
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel was registered to its EventLoop. This will result in having the ChannelHandler.channelRegistered(ChannelHandlerContext) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelRegistered in interface ChannelInboundInvoker
  - fireChannelUnregistered
```
ChannelHandlerContext fireChannelUnregistered()
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel was unregistered from its EventLoop. This will result in having the ChannelHandler.channelUnregistered(ChannelHandlerContext) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelUnregistered in interface ChannelInboundInvoker
  - fireChannelActive
```
ChannelHandlerContext fireChannelActive()
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel is active now, which means it is connected. This will result in having the ChannelHandler.channelActive(ChannelHandlerContext) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelActive in interface ChannelInboundInvoker
  - fireChannelInactive
```
ChannelHandlerContext fireChannelInactive()
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel is inactive now, which means it is closed. This will result in having the ChannelHandler.channelInactive(ChannelHandlerContext) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelInactive in interface ChannelInboundInvoker
  - fireChannelShutdown
```
ChannelHandlerContext fireChannelShutdown(ChannelShutdownDirection direction)
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel was shutdown in a specific direction. This will result in having the ChannelHandler.channelShutdown(ChannelHandlerContext, ChannelShutdownDirection) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelShutdown in interface ChannelInboundInvoker
  - fireChannelExceptionCaught
```
ChannelHandlerContext fireChannelExceptionCaught(Throwable cause)
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel received an Throwable in one of its inbound operations. This will result in having the ChannelHandler.channelExceptionCaught(ChannelHandlerContext, Throwable) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelExceptionCaught in interface ChannelInboundInvoker
  - fireChannelInboundEvent
```
ChannelHandlerContext fireChannelInboundEvent(Object evt)
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel received a custom defined inbound event. This will result in having the ChannelHandler.channelInboundEvent(ChannelHandlerContext, Object) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelInboundEvent in interface ChannelInboundInvoker
  - fireChannelRead
```
ChannelHandlerContext fireChannelRead(Object msg)
```
    Description copied from interface: ChannelInboundInvoker
    
    A Channel received a message. This will result in having the ChannelHandler.channelRead(ChannelHandlerContext, Object) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    fireChannelRead in interface ChannelInboundInvoker
  - fireChannelReadComplete
```
ChannelHandlerContext fireChannelReadComplete()
```
    Description copied from interface: ChannelInboundInvoker
    
    Triggers an ChannelHandler.channelReadComplete(ChannelHandlerContext) event to the next ChannelHandler in the ChannelPipeline.
    
    Specified by:
    
    fireChannelReadComplete in interface ChannelInboundInvoker
  - fireChannelWritabilityChanged
```
ChannelHandlerContext fireChannelWritabilityChanged()
```
    Description copied from interface: ChannelInboundInvoker
    
    Triggers an ChannelHandler.channelWritabilityChanged(ChannelHandlerContext) event to the next ChannelHandler in the ChannelPipeline.
    
    Specified by:
    
    fireChannelWritabilityChanged in interface ChannelInboundInvoker
  - read
```
ChannelHandlerContext read()
```
    Description copied from interface: ChannelOutboundInvoker
    
    Request to Read data from the Channel into the first inbound buffer, triggers an ChannelHandler.channelRead(ChannelHandlerContext, Object) event if data was read, and triggers a channelReadComplete event so the handler can decide to continue reading. If there's a pending read operation already, this method does nothing.
    This will result in having the ChannelHandler.read(ChannelHandlerContext) method called of the next ChannelHandler contained in the ChannelPipeline of the Channel.
    
    Specified by:
    
    read in interface ChannelOutboundInvoker
  - flush
```
ChannelHandlerContext flush()
```
    Description copied from interface: ChannelOutboundInvoker
    
    Request to flush all pending messages via this ChannelOutboundInvoker.
    
    Specified by:
    
    flush in interface ChannelOutboundInvoker
  - pipeline
```
ChannelPipeline pipeline()
```
    Return the assigned ChannelPipeline
  - bufferAllocator
```
default BufferAllocator bufferAllocator()
```
    Return the assigned BufferAllocator which will be used to allocate Buffers.

Interface ChannelHandlerContext

Notify

Modifying a pipeline

Retrieving for later use

A handler can have more than one context

Additional resources worth reading

Method Summary

Methods inherited from interface io.netty5.channel.ChannelOutboundInvoker

Method Detail

channel

name

handler

isRemoved

fireChannelRegistered

fireChannelUnregistered

fireChannelActive

fireChannelInactive

fireChannelShutdown

fireChannelExceptionCaught

fireChannelInboundEvent

fireChannelRead

fireChannelReadComplete

fireChannelWritabilityChanged

read

flush

pipeline

bufferAllocator