DelegatingDecompressorFrameListener (Netty API Reference (4.1.114.Final))

java.lang.Object
- io.netty.handler.codec.http2.Http2FrameListenerDecorator
- - io.netty.handler.codec.http2.DelegatingDecompressorFrameListener

All Implemented Interfaces:

Http2FrameListener
```
public class DelegatingDecompressorFrameListener
extends Http2FrameListenerDecorator
```
An HTTP2 frame listener that will decompress data frames according to the content-encoding header for each stream. The decompression provided by this class will be applied to the data for the entire stream.

Field Summary
- Fields inherited from class io.netty.handler.codec.http2.Http2FrameListenerDecorator
  listener

Constructor Summary

Constructors
Constructor and Description
`DelegatingDecompressorFrameListener(Http2Connection connection, Http2FrameListener listener)`
`DelegatingDecompressorFrameListener(Http2Connection connection, Http2FrameListener listener, boolean strict)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected CharSequence`	`getTargetContentEncoding(CharSequence contentEncoding)` Returns the expected content encoding of the decoded content.
`protected EmbeddedChannel`	`newContentDecompressor(ChannelHandlerContext ctx, CharSequence contentEncoding)` Returns a new `EmbeddedChannel` that decodes the HTTP2 message content encoded in the specified `contentEncoding`.
`int`	`onDataRead(ChannelHandlerContext ctx, int streamId, ByteBuf data, int padding, boolean endOfStream)` Handles an inbound `DATA` frame.
`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.

Methods inherited from class io.netty.handler.codec.http2.Http2FrameListenerDecorator
onGoAwayRead, onPingAckRead, onPingRead, onPriorityRead, onPushPromiseRead, onRstStreamRead, onSettingsAckRead, onSettingsRead, onUnknownFrame, onWindowUpdateRead

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DelegatingDecompressorFrameListener
```
public DelegatingDecompressorFrameListener(Http2Connection connection,
                                           Http2FrameListener listener)
```
  - DelegatingDecompressorFrameListener
```
public DelegatingDecompressorFrameListener(Http2Connection connection,
                                           Http2FrameListener listener,
                                           boolean strict)
```
- Method Detail
  - onDataRead
```
public int onDataRead(ChannelHandlerContext ctx,
                      int streamId,
                      ByteBuf data,
                      int padding,
                      boolean endOfStream)
               throws Http2Exception
```
    Description copied from interface: Http2FrameListener
    
    Handles an inbound DATA frame.
    
    Specified by:
    
    onDataRead in interface Http2FrameListener
    
    Overrides:
    
    onDataRead in class Http2FrameListenerDecorator
    
    Parameters:
    
    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.
    
    Returns:
    
    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.
    
    Throws:
    
    Http2Exception
  - onHeadersRead
```
public void onHeadersRead(ChannelHandlerContext ctx,
                          int streamId,
                          Http2Headers headers,
                          int padding,
                          boolean endStream)
                   throws Http2Exception
```
    Description copied from interface: 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).
    Specified by:
    
    onHeadersRead in interface Http2FrameListener
    
    Overrides:
    
    onHeadersRead in class Http2FrameListenerDecorator
    
    Parameters:
    
    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.
    
    Throws:
    
    Http2Exception
  - onHeadersRead
```
public void onHeadersRead(ChannelHandlerContext ctx,
                          int streamId,
                          Http2Headers headers,
                          int streamDependency,
                          short weight,
                          boolean exclusive,
                          int padding,
                          boolean endStream)
                   throws Http2Exception
```
    Description copied from interface: 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).
    Specified by:
    
    onHeadersRead in interface Http2FrameListener
    
    Overrides:
    
    onHeadersRead in class Http2FrameListenerDecorator
    
    Parameters:
    
    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.
    
    Throws:
    
    Http2Exception
  - newContentDecompressor
```
protected EmbeddedChannel newContentDecompressor(ChannelHandlerContext ctx,
                                                 CharSequence contentEncoding)
                                          throws Http2Exception
```
    Returns a new EmbeddedChannel that decodes the HTTP2 message content encoded in the specified contentEncoding.
    
    Parameters:
    
    contentEncoding - the value of the content-encoding header
    
    Returns:
    
    a new ByteToMessageDecoder if the specified encoding is supported. null otherwise (alternatively, you can throw a Http2Exception to block unknown encoding).
    
    Throws:
    
    Http2Exception - If the specified encoding is not supported and warrants an exception
  - getTargetContentEncoding
```
protected CharSequence getTargetContentEncoding(CharSequence contentEncoding)
                                         throws Http2Exception
```
    Returns the expected content encoding of the decoded content. This getMethod returns "identity" by default, which is the case for most decompressors.
    
    Parameters:
    
    contentEncoding - the value of the content-encoding header
    
    Returns:
    
    the expected content encoding of the new content.
    
    Throws:
    
    Http2Exception - if the contentEncoding is not supported and warrants an exception

Class DelegatingDecompressorFrameListener

Field Summary

Fields inherited from class io.netty.handler.codec.http2.Http2FrameListenerDecorator

Constructor Summary

Method Summary

Methods inherited from class io.netty.handler.codec.http2.Http2FrameListenerDecorator

Methods inherited from class java.lang.Object

Constructor Detail

DelegatingDecompressorFrameListener

DelegatingDecompressorFrameListener

Method Detail

onDataRead

onHeadersRead

onHeadersRead

newContentDecompressor

getTargetContentEncoding