io.netty.handler.codec.http2

类 CompressorHttp2ConnectionEncoder

java.lang.Object

io.netty.handler.codec.http2.DecoratingHttp2FrameWriter

io.netty.handler.codec.http2.DecoratingHttp2ConnectionEncoder

io.netty.handler.codec.http2.CompressorHttp2ConnectionEncoder

所有已实现的接口:

Http2ConnectionEncoder, Http2DataWriter, Http2FrameWriter, Http2SettingsReceivedConsumer, java.io.Closeable, java.lang.AutoCloseable

@UnstableApi
public class CompressorHttp2ConnectionEncoder
extends DecoratingHttp2ConnectionEncoder

A decorating HTTP2 encoder that will compress data frames according to the content-encoding header for each stream. The compression provided by this class will be applied to the data for the entire stream.

嵌套类概要

从接口继承的嵌套类/接口 io.netty.handler.codec.http2.Http2FrameWriter

Http2FrameWriter.Configuration

字段概要

字段

限定符和类型	字段和说明
static int	DEFAULT_COMPRESSION_LEVEL
static int	DEFAULT_MEM_LEVEL
static int	DEFAULT_WINDOW_BITS

构造器概要

构造器

构造器和说明
CompressorHttp2ConnectionEncoder(Http2ConnectionEncoder delegate) Create a new CompressorHttp2ConnectionEncoder instance with default implementation of StandardCompressionOptions
CompressorHttp2ConnectionEncoder(Http2ConnectionEncoder delegate, CompressionOptions... compressionOptionsArgs) Create a new CompressorHttp2ConnectionEncoder with specified StandardCompressionOptions
CompressorHttp2ConnectionEncoder(Http2ConnectionEncoder delegate, int compressionLevel, int windowBits, int memLevel) 已过时。

方法概要

限定符和类型	方法和说明
protected java.lang.CharSequence	getTargetContentEncoding(java.lang.CharSequence contentEncoding) Returns the expected content encoding of the decoded content.
protected EmbeddedChannel	newContentCompressor(ChannelHandlerContext ctx, java.lang.CharSequence contentEncoding) Returns a new EmbeddedChannel that encodes the HTTP2 message content encoded in the specified contentEncoding.
ChannelFuture	writeData(ChannelHandlerContext ctx, int streamId, ByteBuf data, int padding, boolean endOfStream, ChannelPromise promise) Writes a DATA frame to the remote endpoint.
ChannelFuture	writeHeaders(ChannelHandlerContext ctx, int streamId, Http2Headers headers, int padding, boolean endStream, ChannelPromise promise) Writes a HEADERS frame to the remote endpoint.
ChannelFuture	writeHeaders(ChannelHandlerContext ctx, int streamId, Http2Headers headers, int streamDependency, short weight, boolean exclusive, int padding, boolean endOfStream, ChannelPromise promise) Writes a HEADERS frame with priority specified to the remote endpoint.

从类继承的方法 io.netty.handler.codec.http2.DecoratingHttp2ConnectionEncoder

connection, consumeReceivedSettings, flowController, frameWriter, lifecycleManager, pollSentSettings, remoteSettings

从类继承的方法 io.netty.handler.codec.http2.DecoratingHttp2FrameWriter

close, configuration, writeFrame, writeGoAway, writePing, writePriority, writePushPromise, writeRstStream, writeSettings, writeSettingsAck, writeWindowUpdate

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 io.netty.handler.codec.http2.Http2ConnectionEncoder

writeFrame

从接口继承的方法 io.netty.handler.codec.http2.Http2FrameWriter

close, configuration, writeGoAway, writePing, writePriority, writePushPromise, writeRstStream, writeSettings, writeSettingsAck, writeWindowUpdate

字段详细资料

DEFAULT_COMPRESSION_LEVEL

public static final int DEFAULT_COMPRESSION_LEVEL

另请参阅:

常量字段值

DEFAULT_WINDOW_BITS

public static final int DEFAULT_WINDOW_BITS

另请参阅:

常量字段值

DEFAULT_MEM_LEVEL

public static final int DEFAULT_MEM_LEVEL

另请参阅:

常量字段值

构造器详细资料

CompressorHttp2ConnectionEncoder

public CompressorHttp2ConnectionEncoder(Http2ConnectionEncoder delegate)

Create a new CompressorHttp2ConnectionEncoder instance with default implementation of StandardCompressionOptions

CompressorHttp2ConnectionEncoder

@Deprecated
public CompressorHttp2ConnectionEncoder(Http2ConnectionEncoder delegate,
                                                     int compressionLevel,
                                                     int windowBits,
                                                     int memLevel)

已过时。

Create a new CompressorHttp2ConnectionEncoder instance

CompressorHttp2ConnectionEncoder

public CompressorHttp2ConnectionEncoder(Http2ConnectionEncoder delegate,
                                        CompressionOptions... compressionOptionsArgs)

Create a new CompressorHttp2ConnectionEncoder with specified StandardCompressionOptions

方法详细资料

writeData

public ChannelFuture writeData(ChannelHandlerContext ctx,
                               int streamId,
                               ByteBuf data,
                               int padding,
                               boolean endOfStream,
                               ChannelPromise promise)

从接口复制的说明: Http2DataWriter

Writes a DATA frame to the remote endpoint. This will result in one or more frames being written to the context.

指定者:

writeData 在接口中 Http2DataWriter

覆盖:

writeData 在类中 DecoratingHttp2FrameWriter

参数:

ctx - the context to use for writing.

streamId - the stream for which to send the frame.

data - the payload of the frame. This will be released by this method.

padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive). A 1 byte padding is encoded as just the pad length field with value 0. A 256 byte padding is encoded as the pad length field with value 255 and 255 padding bytes appended to the end of the frame.

endOfStream - indicates if this is the last frame to be sent for the stream.

promise - the promise for the write.

返回:

the future for the write.

writeHeaders

public ChannelFuture writeHeaders(ChannelHandlerContext ctx,
                                  int streamId,
                                  Http2Headers headers,
                                  int padding,
                                  boolean endStream,
                                  ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a HEADERS frame to the remote endpoint.

指定者:

writeHeaders 在接口中 Http2FrameWriter

覆盖:

writeHeaders 在类中 DecoratingHttp2FrameWriter

参数:

ctx - the context to use for writing.

streamId - the stream for which to send the frame.

headers - the headers to be sent.

padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).

endStream - indicates if this is the last frame to be sent for the stream.

promise - the promise for the write.

返回:

the future for the write. Section 10.5.1 states the following:

 The header block MUST be processed to ensure a consistent connection state, unless the connection is closed.
 

If this call has modified the HPACK header state you MUST throw a connection error.

If this call has NOT modified the HPACK header state you are free to throw a stream error.

writeHeaders

public ChannelFuture writeHeaders(ChannelHandlerContext ctx,
                                  int streamId,
                                  Http2Headers headers,
                                  int streamDependency,
                                  short weight,
                                  boolean exclusive,
                                  int padding,
                                  boolean endOfStream,
                                  ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a HEADERS frame with priority specified to the remote endpoint.

指定者:

writeHeaders 在接口中 Http2FrameWriter

覆盖:

writeHeaders 在类中 DecoratingHttp2FrameWriter

参数:

ctx - the context to use for writing.

streamId - the stream for which to send the frame.

headers - the headers to be sent.

streamDependency - the stream on which this stream should depend, or 0 if it should depend on the connection.

weight - the weight for this stream.

exclusive - whether this stream should be the exclusive dependant of its parent.

padding - additional bytes that should be added to obscure the true content size. Must be between 0 and 256 (inclusive).

endOfStream - indicates if this is the last frame to be sent for the stream.

promise - the promise for the write.

返回:

the future for the write. Section 10.5.1 states the following:

 The header block MUST be processed to ensure a consistent connection state, unless the connection is closed.
 

If this call has modified the HPACK header state you MUST throw a connection error.

If this call has NOT modified the HPACK header state you are free to throw a stream error.

newContentCompressor

protected EmbeddedChannel newContentCompressor(ChannelHandlerContext ctx,
                                               java.lang.CharSequence contentEncoding)
                                        throws Http2Exception

Returns a new EmbeddedChannel that encodes the HTTP2 message content encoded in the specified contentEncoding.

参数:

ctx - the context.

contentEncoding - the value of the content-encoding header

返回:

a new ByteToMessageDecoder if the specified encoding is supported. null otherwise (alternatively, you can throw a Http2Exception to block unknown encoding).

抛出:

Http2Exception - If the specified encoding is not supported and warrants an exception

getTargetContentEncoding

protected java.lang.CharSequence getTargetContentEncoding(java.lang.CharSequence contentEncoding)
                                                   throws Http2Exception

Returns the expected content encoding of the decoded content. Returning contentEncoding is the default behavior, which is the case for most compressors.

参数:

contentEncoding - the value of the content-encoding header

返回:

the expected content encoding of the new content.

抛出:

Http2Exception - if the contentEncoding is not supported and warrants an exception