public static interface Http2Connection.Listener
Modifier and Type | Method and Description |
---|---|
void |
onGoAwayReceived(int lastStreamId,
long errorCode,
io.netty.buffer.ByteBuf debugData)
Called when a
GOAWAY was received from the remote endpoint. |
void |
onGoAwaySent(int lastStreamId,
long errorCode,
io.netty.buffer.ByteBuf debugData)
Called when a
GOAWAY frame was sent for the connection. |
void |
onPriorityTreeParentChanged(Http2Stream stream,
Http2Stream oldParent)
Notifies the listener that a priority tree parent change has occurred.
|
void |
onPriorityTreeParentChanging(Http2Stream stream,
Http2Stream newParent)
Notifies the listener that a parent dependency is about to change
This is called while the tree is being restructured and so the tree
structure is not necessarily steady state.
|
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 |
onWeightChanged(Http2Stream stream,
short oldWeight)
Notifies the listener that the weight has changed for
stream . |
void onStreamAdded(Http2Stream stream)
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.
void onStreamActive(Http2Stream stream)
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.
void onStreamHalfClosed(Http2Stream stream)
OPEN
to HALF CLOSED
.
This method will not be called until a state transition occurs from when
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.
void onStreamClosed(Http2Stream stream)
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.
void onStreamRemoved(Http2Stream stream)
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.
void onPriorityTreeParentChanged(Http2Stream stream, Http2Stream oldParent)
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.
stream
- The stream which had a parent change (new parent and children will be steady state)oldParent
- The old parent which stream
used to be a child of (may be null
)void onPriorityTreeParentChanging(Http2Stream stream, Http2Stream newParent)
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.
stream
- The stream which the parent is about to change to newParent
newParent
- The stream which will be the parent of stream
void onWeightChanged(Http2Stream stream, short oldWeight)
stream
.
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.
stream
- The stream which the weight has changedoldWeight
- The old weight for stream
void onGoAwaySent(int lastStreamId, long errorCode, io.netty.buffer.ByteBuf debugData)
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.
lastStreamId
- the last known stream of the remote endpoint.errorCode
- the error code, if abnormal closure.debugData
- application-defined debug data.void onGoAwayReceived(int lastStreamId, long errorCode, io.netty.buffer.ByteBuf debugData)
GOAWAY
was received from the remote endpoint. This event handler duplicates Http2FrameListener.onGoAwayRead(io.netty.channel.ChannelHandlerContext, int, long, io.netty.buffer.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.
lastStreamId
- the last known stream of the remote endpoint.errorCode
- the error code, if abnormal closure.debugData
- application-defined debug data.Copyright © 2008–2017 The Netty Project. All rights reserved.