d4742bbe16
- Rename ChannelHandlerAdapter to ChannelDuplexHandler - Add ChannelHandlerAdapter that implements only ChannelHandler - Rename CombinedChannelHandler to CombinedChannelDuplexHandler and improve runtime validation - Remove ChannelInbound/OutboundHandlerAdapter which are not useful - Make ChannelOutboundByteHandlerAdapter similar to ChannelInboundByteHandlerAdapter - Make the tail and head handler of DefaultChannelPipeline accept both bytes and messages. ChannelHandlerContext.hasNext*() were removed because they always return true now. - Removed various unnecessary null checks. - Correct method/field names: inboundBufferSuspended -> channelReadSuspended
96 lines
3.6 KiB
Java
96 lines
3.6 KiB
Java
/*
|
|
* Copyright 2012 The Netty Project
|
|
*
|
|
* The Netty Project licenses this file to you under the Apache License,
|
|
* version 2.0 (the "License"); you may not use this file except in compliance
|
|
* with the License. You may obtain a copy of the License at:
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*/
|
|
package io.netty.channel;
|
|
|
|
|
|
/**
|
|
* Abstract base class for {@link ChannelStateHandler} implementations which provide
|
|
* implementations of all of their methods.
|
|
*
|
|
* This implementation just forward the operation to the next {@link ChannelHandler} in the
|
|
* {@link ChannelPipeline}. Sub-classes may override a method implementation to change this.
|
|
*/
|
|
public abstract class ChannelStateHandlerAdapter extends ChannelHandlerAdapter implements ChannelStateHandler {
|
|
|
|
/**
|
|
* Calls {@link ChannelHandlerContext#fireChannelRegistered()} to forward
|
|
* to the next {@link ChannelStateHandler} in the {@link ChannelPipeline}.
|
|
*
|
|
* Sub-classes may override this method to change behavior.
|
|
*/
|
|
@Override
|
|
public void channelRegistered(ChannelHandlerContext ctx) throws Exception {
|
|
ctx.fireChannelRegistered();
|
|
}
|
|
|
|
/**
|
|
* Calls {@link ChannelHandlerContext#fireChannelUnregistered()} to forward
|
|
* to the next {@link ChannelStateHandler} in the {@link ChannelPipeline}.
|
|
*
|
|
* Sub-classes may override this method to change behavior.
|
|
*/
|
|
@Override
|
|
public void channelUnregistered(ChannelHandlerContext ctx) throws Exception {
|
|
ctx.fireChannelUnregistered();
|
|
}
|
|
|
|
/**
|
|
* Calls {@link ChannelHandlerContext#fireChannelActive()} to forward
|
|
* to the next {@link ChannelStateHandler} in the {@link ChannelPipeline}.
|
|
*
|
|
* Sub-classes may override this method to change behavior.
|
|
*/
|
|
@Override
|
|
public void channelActive(ChannelHandlerContext ctx) throws Exception {
|
|
ctx.fireChannelActive();
|
|
}
|
|
|
|
/**
|
|
* Calls {@link ChannelHandlerContext#fireChannelInactive()} to forward
|
|
* to the next {@link ChannelStateHandler} in the {@link ChannelPipeline}.
|
|
*
|
|
* Sub-classes may override this method to change behavior.
|
|
*/
|
|
@Override
|
|
public void channelInactive(ChannelHandlerContext ctx) throws Exception {
|
|
ctx.fireChannelInactive();
|
|
}
|
|
|
|
/**
|
|
* Calls {@link ChannelHandlerContext#fireInboundBufferUpdated()} to forward
|
|
* to the next {@link ChannelOperationHandler} in the {@link ChannelPipeline}.
|
|
*
|
|
* Sub-classes may override this method to change behavior.
|
|
*
|
|
* Be aware that if your class also implement {@link ChannelInboundHandler} it need to {@code @Override} this
|
|
* method and provide some proper implementation. Fail to do so, will result in an {@link IllegalStateException}!
|
|
*/
|
|
@Override
|
|
public void inboundBufferUpdated(ChannelHandlerContext ctx) throws Exception {
|
|
if (this instanceof ChannelInboundHandler) {
|
|
throw new IllegalStateException(
|
|
"inboundBufferUpdated(...) must be overridden by " + getClass().getName() +
|
|
", which implements " + ChannelInboundHandler.class.getSimpleName());
|
|
}
|
|
ctx.fireInboundBufferUpdated();
|
|
}
|
|
|
|
@Override
|
|
public void channelReadSuspended(ChannelHandlerContext ctx) throws Exception {
|
|
ctx.fireChannelReadSuspended();
|
|
}
|
|
}
|