io.netty.handler.codec.http2

类 Http2OutboundFrameLogger

java.lang.Object

io.netty.handler.codec.http2.Http2OutboundFrameLogger

所有已实现的接口:

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

@UnstableApi
public class Http2OutboundFrameLogger
extends java.lang.Object
implements Http2FrameWriter

Decorator around a Http2FrameWriter that logs all outbound frames before calling the writer.

嵌套类概要

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

Http2FrameWriter.Configuration

构造器概要

构造器

构造器和说明
Http2OutboundFrameLogger(Http2FrameWriter writer, Http2FrameLogger logger)

方法概要

限定符和类型	方法和说明
void	close() Closes this writer and frees any allocated resources.
Http2FrameWriter.Configuration	configuration() Get the configuration related elements for this Http2FrameWriter
ChannelFuture	writeData(ChannelHandlerContext ctx, int streamId, ByteBuf data, int padding, boolean endStream, ChannelPromise promise) Writes a DATA frame to the remote endpoint.
ChannelFuture	writeFrame(ChannelHandlerContext ctx, byte frameType, int streamId, Http2Flags flags, ByteBuf payload, ChannelPromise promise) Generic write method for any HTTP/2 frame.
ChannelFuture	writeGoAway(ChannelHandlerContext ctx, int lastStreamId, long errorCode, ByteBuf debugData, ChannelPromise promise) Writes a GO_AWAY 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 endStream, ChannelPromise promise) Writes a HEADERS frame with priority specified to the remote endpoint.
ChannelFuture	writePing(ChannelHandlerContext ctx, boolean ack, long data, ChannelPromise promise) Writes a PING frame to the remote endpoint.
ChannelFuture	writePriority(ChannelHandlerContext ctx, int streamId, int streamDependency, short weight, boolean exclusive, ChannelPromise promise) Writes a PRIORITY frame to the remote endpoint.
ChannelFuture	writePushPromise(ChannelHandlerContext ctx, int streamId, int promisedStreamId, Http2Headers headers, int padding, ChannelPromise promise) Writes a PUSH_PROMISE frame to the remote endpoint.
ChannelFuture	writeRstStream(ChannelHandlerContext ctx, int streamId, long errorCode, ChannelPromise promise) Writes a RST_STREAM frame to the remote endpoint.
ChannelFuture	writeSettings(ChannelHandlerContext ctx, Http2Settings settings, ChannelPromise promise) Writes a SETTINGS frame to the remote endpoint.
ChannelFuture	writeSettingsAck(ChannelHandlerContext ctx, ChannelPromise promise) Writes a SETTINGS acknowledgment to the remote endpoint.
ChannelFuture	writeWindowUpdate(ChannelHandlerContext ctx, int streamId, int windowSizeIncrement, ChannelPromise promise) Writes a WINDOW_UPDATE frame to the remote endpoint.

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

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

构造器详细资料

Http2OutboundFrameLogger

public Http2OutboundFrameLogger(Http2FrameWriter writer,
                                Http2FrameLogger logger)

方法详细资料

writeData

public ChannelFuture writeData(ChannelHandlerContext ctx,
                               int streamId,
                               ByteBuf data,
                               int padding,
                               boolean endStream,
                               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

参数:

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.

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.

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

参数:

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 endStream,
                                  ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

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

指定者:

writeHeaders 在接口中 Http2FrameWriter

参数:

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).

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.

writePriority

public ChannelFuture writePriority(ChannelHandlerContext ctx,
                                   int streamId,
                                   int streamDependency,
                                   short weight,
                                   boolean exclusive,
                                   ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a PRIORITY frame to the remote endpoint.

指定者:

writePriority 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

streamId - the stream for which to send the frame.

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.

promise - the promise for the write.

返回:

the future for the write.

writeRstStream

public ChannelFuture writeRstStream(ChannelHandlerContext ctx,
                                    int streamId,
                                    long errorCode,
                                    ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a RST_STREAM frame to the remote endpoint.

指定者:

writeRstStream 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

streamId - the stream for which to send the frame.

errorCode - the error code indicating the nature of the failure.

promise - the promise for the write.

返回:

the future for the write.

writeSettings

public ChannelFuture writeSettings(ChannelHandlerContext ctx,
                                   Http2Settings settings,
                                   ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a SETTINGS frame to the remote endpoint.

指定者:

writeSettings 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

settings - the settings to be sent.

promise - the promise for the write.

返回:

the future for the write.

writeSettingsAck

public ChannelFuture writeSettingsAck(ChannelHandlerContext ctx,
                                      ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a SETTINGS acknowledgment to the remote endpoint.

指定者:

writeSettingsAck 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

promise - the promise for the write.

返回:

the future for the write.

writePing

public ChannelFuture writePing(ChannelHandlerContext ctx,
                               boolean ack,
                               long data,
                               ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a PING frame to the remote endpoint.

指定者:

writePing 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

ack - indicates whether this is an ack of a PING frame previously received from the remote endpoint.

data - the payload of the frame.

promise - the promise for the write.

返回:

the future for the write.

writePushPromise

public ChannelFuture writePushPromise(ChannelHandlerContext ctx,
                                      int streamId,
                                      int promisedStreamId,
                                      Http2Headers headers,
                                      int padding,
                                      ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a PUSH_PROMISE frame to the remote endpoint.

指定者:

writePushPromise 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

streamId - the stream for which to send the frame.

promisedStreamId - the ID of the promised stream.

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).

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.

writeGoAway

public ChannelFuture writeGoAway(ChannelHandlerContext ctx,
                                 int lastStreamId,
                                 long errorCode,
                                 ByteBuf debugData,
                                 ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a GO_AWAY frame to the remote endpoint.

指定者:

writeGoAway 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

lastStreamId - the last known stream of this endpoint.

errorCode - the error code, if the connection was abnormally terminated.

debugData - application-defined debug data. This will be released by this method.

promise - the promise for the write.

返回:

the future for the write.

writeWindowUpdate

public ChannelFuture writeWindowUpdate(ChannelHandlerContext ctx,
                                       int streamId,
                                       int windowSizeIncrement,
                                       ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Writes a WINDOW_UPDATE frame to the remote endpoint.

指定者:

writeWindowUpdate 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

streamId - the stream for which to send the frame.

windowSizeIncrement - the number of bytes by which the local inbound flow control window is increasing.

promise - the promise for the write.

返回:

the future for the write.

writeFrame

public ChannelFuture writeFrame(ChannelHandlerContext ctx,
                                byte frameType,
                                int streamId,
                                Http2Flags flags,
                                ByteBuf payload,
                                ChannelPromise promise)

从接口复制的说明: Http2FrameWriter

Generic write method for any HTTP/2 frame. This allows writing of non-standard frames.

指定者:

writeFrame 在接口中 Http2FrameWriter

参数:

ctx - the context to use for writing.

frameType - the frame type identifier.

streamId - the stream for which to send the frame.

flags - the flags to write for this frame.

payload - the payload to write for this frame. This will be released by this method.

promise - the promise for the write.

返回:

the future for the write.

close

public void close()

从接口复制的说明: Http2FrameWriter

Closes this writer and frees any allocated resources.

指定者:

close 在接口中 Http2FrameWriter

指定者:

close 在接口中 java.io.Closeable

指定者:

close 在接口中 java.lang.AutoCloseable

configuration

public Http2FrameWriter.Configuration configuration()

从接口复制的说明: Http2FrameWriter

Get the configuration related elements for this Http2FrameWriter

指定者:

configuration 在接口中 Http2FrameWriter