Http2EventAdapter (Netty 4.1.109.Final API文档

java.lang.Object
- io.netty.handler.codec.http2.Http2EventAdapter

所有已实现的接口:

Http2Connection.Listener, Http2FrameListener

直接已知子类:

InboundHttp2ToHttpAdapter
```
@UnstableApi
public class Http2EventAdapter
extends java.lang.Object
implements Http2Connection.Listener, Http2FrameListener
```
This class brings Http2Connection.Listener and Http2FrameListener together to provide NOOP implementation so inheriting classes can selectively choose which methods to override.

构造器概要

构造器
构造器和说明

Http2EventAdapter()

构造器
构造器和说明
`Http2EventAdapter()`

方法概要

All Methods Instance Methods Concrete Methods
限定符和类型	方法和说明
`int`	`onDataRead(ChannelHandlerContext ctx, int streamId, ByteBuf data, int padding, boolean endOfStream)` Handles an inbound `DATA` frame.
`void`	`onGoAwayRead(ChannelHandlerContext ctx, int lastStreamId, long errorCode, ByteBuf debugData)` Handles an inbound `GO_AWAY` frame.
`void`	`onGoAwayReceived(int lastStreamId, long errorCode, ByteBuf debugData)` Called when a `GOAWAY` was received from the remote endpoint.
`void`	`onGoAwaySent(int lastStreamId, long errorCode, ByteBuf debugData)` Called when a `GOAWAY` frame was sent for the connection.
`void`	`onHeadersRead(ChannelHandlerContext ctx, int streamId, Http2Headers headers, int padding, boolean endStream)` Handles an inbound `HEADERS` frame.
`void`	`onHeadersRead(ChannelHandlerContext ctx, int streamId, Http2Headers headers, int streamDependency, short weight, boolean exclusive, int padding, boolean endStream)` Handles an inbound `HEADERS` frame with priority information specified.
`void`	`onPingAckRead(ChannelHandlerContext ctx, long data)` Handles an inbound `PING` acknowledgment.
`void`	`onPingRead(ChannelHandlerContext ctx, long data)` Handles an inbound `PING` frame.
`void`	`onPriorityRead(ChannelHandlerContext ctx, int streamId, int streamDependency, short weight, boolean exclusive)` Handles an inbound `PRIORITY` frame.
`void`	`onPushPromiseRead(ChannelHandlerContext ctx, int streamId, int promisedStreamId, Http2Headers headers, int padding)` Handles an inbound `PUSH_PROMISE` frame.
`void`	`onRstStreamRead(ChannelHandlerContext ctx, int streamId, long errorCode)` Handles an inbound `RST_STREAM` frame.
`void`	`onSettingsAckRead(ChannelHandlerContext ctx)` Handles an inbound `SETTINGS` acknowledgment frame.
`void`	`onSettingsRead(ChannelHandlerContext ctx, Http2Settings settings)` Handles an inbound `SETTINGS` frame.
`void`	`onStreamActive(Http2Stream stream)` Notifies the listener that the given stream was made active (i.e.
`void`	`onStreamAdded(Http2Stream stream)` Notifies the listener that the given stream was added to the connection.
`void`	`onStreamClosed(Http2Stream stream)` Notifies the listener that the given stream is now `CLOSED` in both directions and will no longer be accessible via `Http2Connection.forEachActiveStream(Http2StreamVisitor)`.
`void`	`onStreamHalfClosed(Http2Stream stream)` Notifies the listener that the given stream has transitioned from `OPEN` to `HALF CLOSED`.
`void`	`onStreamRemoved(Http2Stream stream)` Notifies the listener that the given stream has now been removed from the connection and will no longer be returned via `Http2Connection.stream(int)`.
`void`	`onUnknownFrame(ChannelHandlerContext ctx, byte frameType, int streamId, Http2Flags flags, ByteBuf payload)` Handler for a frame not defined by the HTTP/2 spec.
`void`	`onWindowUpdateRead(ChannelHandlerContext ctx, int streamId, int windowSizeIncrement)` Handles an inbound `WINDOW_UPDATE` frame.

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

- 构造器详细资料
  - Http2EventAdapter
```
public Http2EventAdapter()
```
- 方法详细资料
  - onDataRead
```
public int onDataRead(ChannelHandlerContext ctx,
                      int streamId,
                      ByteBuf data,
                      int padding,
                      boolean endOfStream)
               throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound DATA frame.
    
    指定者:
    
    onDataRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    streamId - the subject stream for the frame.
    
    data - payload buffer for the frame. This buffer will be released by the codec.
    
    padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).
    
    endOfStream - Indicates whether this is the last frame to be sent from the remote endpoint for this stream.
    
    返回:
    
    the number of bytes that have been processed by the application. The returned bytes are used by the inbound flow controller to determine the appropriate time to expand the inbound flow control window (i.e. send WINDOW_UPDATE). Returning a value equal to the length of data + padding will effectively opt-out of application-level flow control for this frame. Returning a value less than the length of data + padding will defer the returning of the processed bytes, which the application must later return via Http2LocalFlowController.consumeBytes(Http2Stream, int). The returned value must be >= 0 and <= data.readableBytes() + padding.
    
    抛出:
    
    Http2Exception
  - onHeadersRead
```
public void onHeadersRead(ChannelHandlerContext ctx,
                          int streamId,
                          Http2Headers headers,
                          int padding,
                          boolean endStream)
                   throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    Handles an inbound HEADERS frame.
    Only one of the following methods will be called for each HEADERS frame sequence. One will be called when the END_HEADERS flag has been received.
    To say it another way; the Http2Headers will contain all of the headers for the current message exchange step (additional queuing is not necessary).
    指定者:
    
    onHeadersRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    streamId - the subject stream for the frame.
    
    headers - the received headers.
    
    padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).
    
    endStream - Indicates whether this is the last frame to be sent from the remote endpoint for this stream.
    
    抛出:
    
    Http2Exception
  - onHeadersRead
```
public void onHeadersRead(ChannelHandlerContext ctx,
                          int streamId,
                          Http2Headers headers,
                          int streamDependency,
                          short weight,
                          boolean exclusive,
                          int padding,
                          boolean endStream)
                   throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    Handles an inbound HEADERS frame with priority information specified. Only called if END_HEADERS encountered.
    Only one of the following methods will be called for each HEADERS frame sequence. One will be called when the END_HEADERS flag has been received.
    To say it another way; the Http2Headers will contain all of the headers for the current message exchange step (additional queuing is not necessary).
    指定者:
    
    onHeadersRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    streamId - the subject stream for the frame.
    
    headers - the received headers.
    
    streamDependency - the stream on which this stream depends, or 0 if dependent on the connection.
    
    weight - the new weight for the stream.
    
    exclusive - whether or not the stream should be the exclusive dependent of its parent.
    
    padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).
    
    endStream - Indicates whether this is the last frame to be sent from the remote endpoint for this stream.
    
    抛出:
    
    Http2Exception
  - onPriorityRead
```
public void onPriorityRead(ChannelHandlerContext ctx,
                           int streamId,
                           int streamDependency,
                           short weight,
                           boolean exclusive)
                    throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound PRIORITY frame.
    Note that is it possible to have this method called and no stream object exist for either streamId, streamDependency, or both. This is because the PRIORITY frame can be sent/received when streams are in the CLOSED state.
    
    指定者:
    
    onPriorityRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    streamId - the subject stream for the frame.
    
    streamDependency - the stream on which this stream depends, or 0 if dependent on the connection.
    
    weight - the new weight for the stream.
    
    exclusive - whether or not the stream should be the exclusive dependent of its parent.
    
    抛出:
    
    Http2Exception
  - onRstStreamRead
```
public void onRstStreamRead(ChannelHandlerContext ctx,
                            int streamId,
                            long errorCode)
                     throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound RST_STREAM frame.
    
    指定者:
    
    onRstStreamRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    streamId - the stream that is terminating.
    
    errorCode - the error code identifying the type of failure.
    
    抛出:
    
    Http2Exception
  - onSettingsAckRead
```
public void onSettingsAckRead(ChannelHandlerContext ctx)
                       throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound SETTINGS acknowledgment frame.
    
    指定者:
    
    onSettingsAckRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    抛出:
    
    Http2Exception
  - onSettingsRead
```
public void onSettingsRead(ChannelHandlerContext ctx,
                           Http2Settings settings)
                    throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound SETTINGS frame.
    
    指定者:
    
    onSettingsRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    settings - the settings received from the remote endpoint.
    
    抛出:
    
    Http2Exception
  - onPingRead
```
public void onPingRead(ChannelHandlerContext ctx,
                       long data)
                throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound PING frame.
    
    指定者:
    
    onPingRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    data - the payload of the frame.
    
    抛出:
    
    Http2Exception
  - onPingAckRead
```
public void onPingAckRead(ChannelHandlerContext ctx,
                          long data)
                   throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound PING acknowledgment.
    
    指定者:
    
    onPingAckRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    data - the payload of the frame.
    
    抛出:
    
    Http2Exception
  - onPushPromiseRead
```
public void onPushPromiseRead(ChannelHandlerContext ctx,
                              int streamId,
                              int promisedStreamId,
                              Http2Headers headers,
                              int padding)
                       throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    Handles an inbound PUSH_PROMISE frame. Only called if END_HEADERS encountered.
    Promised requests MUST be authoritative, cacheable, and safe. See [RFC 7540], Section 8.2.
    Only one of the following methods will be called for each HEADERS frame sequence. One will be called when the END_HEADERS flag has been received.
    To say it another way; the Http2Headers will contain all of the headers for the current message exchange step (additional queuing is not necessary).
    指定者:
    
    onPushPromiseRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    streamId - the stream the frame was sent on.
    
    promisedStreamId - the ID of the promised stream.
    
    headers - the received headers.
    
    padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).
    
    抛出:
    
    Http2Exception
  - onGoAwayRead
```
public void onGoAwayRead(ChannelHandlerContext ctx,
                         int lastStreamId,
                         long errorCode,
                         ByteBuf debugData)
                  throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound GO_AWAY frame.
    
    指定者:
    
    onGoAwayRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    lastStreamId - the last known stream of the remote endpoint.
    
    errorCode - the error code, if abnormal closure.
    
    debugData - application-defined debug data. If this buffer needs to be retained by the listener they must make a copy.
    
    抛出:
    
    Http2Exception
  - onWindowUpdateRead
```
public void onWindowUpdateRead(ChannelHandlerContext ctx,
                               int streamId,
                               int windowSizeIncrement)
                        throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handles an inbound WINDOW_UPDATE frame.
    
    指定者:
    
    onWindowUpdateRead 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    streamId - the stream the frame was sent on.
    
    windowSizeIncrement - the increased number of bytes of the remote endpoint's flow control window.
    
    抛出:
    
    Http2Exception
  - onUnknownFrame
```
public void onUnknownFrame(ChannelHandlerContext ctx,
                           byte frameType,
                           int streamId,
                           Http2Flags flags,
                           ByteBuf payload)
                    throws Http2Exception
```
    从接口复制的说明: Http2FrameListener
    
    Handler for a frame not defined by the HTTP/2 spec.
    
    指定者:
    
    onUnknownFrame 在接口中 Http2FrameListener
    
    参数:
    
    ctx - the context from the handler where the frame was read.
    
    frameType - the frame type from the HTTP/2 header.
    
    streamId - the stream the frame was sent on.
    
    flags - the flags in the frame header.
    
    payload - the payload of the frame.
    
    抛出:
    
    Http2Exception
  - onStreamAdded
```
public void onStreamAdded(Http2Stream stream)
```
    从接口复制的说明: Http2Connection.Listener
    
    Notifies the listener that the given stream was added to the connection. This stream may not yet be active (i.e. OPEN or HALF CLOSED).
    If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.
    
    指定者:
    
    onStreamAdded 在接口中 Http2Connection.Listener
  - onStreamActive
```
public void onStreamActive(Http2Stream stream)
```
    从接口复制的说明: Http2Connection.Listener
    
    Notifies the listener that the given stream was made active (i.e. OPEN or HALF CLOSED).
    If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.
    
    指定者:
    
    onStreamActive 在接口中 Http2Connection.Listener
  - onStreamHalfClosed
```
public void onStreamHalfClosed(Http2Stream stream)
```
    从接口复制的说明: Http2Connection.Listener
    
    Notifies the listener that the given stream has transitioned from OPEN to HALF CLOSED. This method will not be called until a state transition occurs from when Http2Connection.Listener.onStreamActive(Http2Stream) was called. The stream can be inspected to determine which side is HALF CLOSED.
    If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.
    
    指定者:
    
    onStreamHalfClosed 在接口中 Http2Connection.Listener
  - onStreamClosed
```
public void onStreamClosed(Http2Stream stream)
```
    从接口复制的说明: Http2Connection.Listener
    
    Notifies the listener that the given stream is now CLOSED in both directions and will no longer be accessible via Http2Connection.forEachActiveStream(Http2StreamVisitor).
    If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.
    
    指定者:
    
    onStreamClosed 在接口中 Http2Connection.Listener
  - onStreamRemoved
```
public void onStreamRemoved(Http2Stream stream)
```
    从接口复制的说明: Http2Connection.Listener
    
    Notifies the listener that the given stream has now been removed from the connection and will no longer be returned via Http2Connection.stream(int). The connection may maintain inactive streams for some time before removing them.
    If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.
    
    指定者:
    
    onStreamRemoved 在接口中 Http2Connection.Listener
  - onGoAwaySent
```
public void onGoAwaySent(int lastStreamId,
                         long errorCode,
                         ByteBuf debugData)
```
    从接口复制的说明: Http2Connection.Listener
    
    Called when a GOAWAY frame was sent for the connection.
    If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.
    
    指定者:
    
    onGoAwaySent 在接口中 Http2Connection.Listener
    
    参数:
    
    lastStreamId - the last known stream of the remote endpoint.
    
    errorCode - the error code, if abnormal closure.
    
    debugData - application-defined debug data.
  - onGoAwayReceived
```
public void onGoAwayReceived(int lastStreamId,
                             long errorCode,
                             ByteBuf debugData)
```
    从接口复制的说明: Http2Connection.Listener
    
    Called when a GOAWAY was received from the remote endpoint. This event handler duplicates Http2FrameListener.onGoAwayRead(io.netty.channel.ChannelHandlerContext, int, long, ByteBuf) but is added here in order to simplify application logic for handling GOAWAY in a uniform way. An application should generally not handle both events, but if it does this method is called second, after notifying the Http2FrameListener.
    If a RuntimeException is thrown it will be logged and not propagated. Throwing from this method is not supported and is considered a programming error.
    
    指定者:
    
    onGoAwayReceived 在接口中 Http2Connection.Listener
    
    参数:
    
    lastStreamId - the last known stream of the remote endpoint.
    
    errorCode - the error code, if abnormal closure.
    
    debugData - application-defined debug data.

类 Http2EventAdapter

构造器概要

方法概要

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

构造器详细资料

Http2EventAdapter

方法详细资料

onDataRead

onHeadersRead

onHeadersRead

onPriorityRead

onRstStreamRead

onSettingsAckRead

onSettingsRead

onPingRead

onPingAckRead

onPushPromiseRead

onGoAwayRead

onWindowUpdateRead

onUnknownFrame

onStreamAdded

onStreamActive

onStreamHalfClosed

onStreamClosed

onStreamRemoved

onGoAwaySent

onGoAwayReceived