io.netty.handler.codec.http2

类 Http2Exception

java.lang.Object

java.lang.Throwable

java.lang.Exception

io.netty.handler.codec.http2.Http2Exception

所有已实现的接口:

java.io.Serializable

直接已知子类:

Http2Exception.ClosedStreamCreationException, Http2Exception.CompositeStreamException, Http2Exception.StreamException, Http2NoMoreStreamIdsException, StreamBufferingEncoder.Http2ChannelClosedException, StreamBufferingEncoder.Http2GoAwayException

@UnstableApi
public class Http2Exception
extends java.lang.Exception

Exception thrown when an HTTP/2 error was encountered.

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	Http2Exception.ClosedStreamCreationException Used when a stream creation attempt fails but may be because the stream was previously closed.
static class	Http2Exception.CompositeStreamException Provides the ability to handle multiple stream exceptions with one throw statement.
static class	Http2Exception.HeaderListSizeException
static class	Http2Exception.ShutdownHint Provides a hint as to if shutdown is justified, what type of shutdown should be executed.
static class	Http2Exception.StreamException Represents an exception that can be isolated to a single stream (as opposed to the entire connection).

构造器概要

构造器

构造器和说明
Http2Exception(Http2Error error)
Http2Exception(Http2Error error, Http2Exception.ShutdownHint shutdownHint)
Http2Exception(Http2Error error, java.lang.String message)
Http2Exception(Http2Error error, java.lang.String message, Http2Exception.ShutdownHint shutdownHint)
Http2Exception(Http2Error error, java.lang.String message, java.lang.Throwable cause)
Http2Exception(Http2Error error, java.lang.String message, java.lang.Throwable cause, Http2Exception.ShutdownHint shutdownHint)

方法概要

限定符和类型	方法和说明
static Http2Exception	closedStreamError(Http2Error error, java.lang.String fmt, java.lang.Object... args) Use if an error has occurred which can not be isolated to a single stream, but instead applies to the entire connection.
static Http2Exception	connectionError(Http2Error error, java.lang.String fmt, java.lang.Object... args) Use if an error has occurred which can not be isolated to a single stream, but instead applies to the entire connection.
static Http2Exception	connectionError(Http2Error error, java.lang.Throwable cause, java.lang.String fmt, java.lang.Object... args) Use if an error has occurred which can not be isolated to a single stream, but instead applies to the entire connection.
Http2Error	error()
static Http2Exception	headerListSizeError(int id, Http2Error error, boolean onDecode, java.lang.String fmt, java.lang.Object... args) A specific stream error resulting from failing to decode headers that exceeds the max header size list.
static boolean	isStreamError(Http2Exception e) Check if an exception is isolated to a single stream or the entire connection.
Http2Exception.ShutdownHint	shutdownHint() Provide a hint as to what type of shutdown should be executed.
static Http2Exception	streamError(int id, Http2Error error, java.lang.String fmt, java.lang.Object... args) Use if an error which can be isolated to a single stream has occurred.
static Http2Exception	streamError(int id, Http2Error error, java.lang.Throwable cause, java.lang.String fmt, java.lang.Object... args) Use if an error which can be isolated to a single stream has occurred.
static int	streamId(Http2Exception e) Get the stream id associated with an exception.

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

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

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

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

构造器详细资料

Http2Exception

public Http2Exception(Http2Error error)

Http2Exception

public Http2Exception(Http2Error error,
                      Http2Exception.ShutdownHint shutdownHint)

Http2Exception

public Http2Exception(Http2Error error,
                      java.lang.String message)

Http2Exception

public Http2Exception(Http2Error error,
                      java.lang.String message,
                      Http2Exception.ShutdownHint shutdownHint)

Http2Exception

public Http2Exception(Http2Error error,
                      java.lang.String message,
                      java.lang.Throwable cause)

Http2Exception

public Http2Exception(Http2Error error,
                      java.lang.String message,
                      java.lang.Throwable cause,
                      Http2Exception.ShutdownHint shutdownHint)

方法详细资料

error

public Http2Error error()

shutdownHint

public Http2Exception.ShutdownHint shutdownHint()

Provide a hint as to what type of shutdown should be executed. Note this hint may be ignored.

connectionError

public static Http2Exception connectionError(Http2Error error,
                                             java.lang.String fmt,
                                             java.lang.Object... args)

Use if an error has occurred which can not be isolated to a single stream, but instead applies to the entire connection.

参数:

error - The type of error as defined by the HTTP/2 specification.

fmt - String with the content and format for the additional debug data.

args - Objects which fit into the format defined by fmt.

返回:

An exception which can be translated into an HTTP/2 error.

connectionError

public static Http2Exception connectionError(Http2Error error,
                                             java.lang.Throwable cause,
                                             java.lang.String fmt,
                                             java.lang.Object... args)

Use if an error has occurred which can not be isolated to a single stream, but instead applies to the entire connection.

参数:

error - The type of error as defined by the HTTP/2 specification.

cause - The object which caused the error.

fmt - String with the content and format for the additional debug data.

args - Objects which fit into the format defined by fmt.

返回:

An exception which can be translated into an HTTP/2 error.

closedStreamError

public static Http2Exception closedStreamError(Http2Error error,
                                               java.lang.String fmt,
                                               java.lang.Object... args)

Use if an error has occurred which can not be isolated to a single stream, but instead applies to the entire connection.

参数:

error - The type of error as defined by the HTTP/2 specification.

fmt - String with the content and format for the additional debug data.

args - Objects which fit into the format defined by fmt.

返回:

An exception which can be translated into an HTTP/2 error.

streamError

public static Http2Exception streamError(int id,
                                         Http2Error error,
                                         java.lang.String fmt,
                                         java.lang.Object... args)

Use if an error which can be isolated to a single stream has occurred. If the id is not Http2CodecUtil.CONNECTION_STREAM_ID then a Http2Exception.StreamException will be returned. Otherwise the error is considered a connection error and a Http2Exception is returned.

参数:

id - The stream id for which the error is isolated to.

error - The type of error as defined by the HTTP/2 specification.

fmt - String with the content and format for the additional debug data.

args - Objects which fit into the format defined by fmt.

返回:

If the id is not Http2CodecUtil.CONNECTION_STREAM_ID then a Http2Exception.StreamException will be returned. Otherwise the error is considered a connection error and a Http2Exception is returned.

streamError

public static Http2Exception streamError(int id,
                                         Http2Error error,
                                         java.lang.Throwable cause,
                                         java.lang.String fmt,
                                         java.lang.Object... args)

Use if an error which can be isolated to a single stream has occurred. If the id is not Http2CodecUtil.CONNECTION_STREAM_ID then a Http2Exception.StreamException will be returned. Otherwise the error is considered a connection error and a Http2Exception is returned.

参数:

id - The stream id for which the error is isolated to.

error - The type of error as defined by the HTTP/2 specification.

cause - The object which caused the error.

fmt - String with the content and format for the additional debug data.

args - Objects which fit into the format defined by fmt.

返回:

If the id is not Http2CodecUtil.CONNECTION_STREAM_ID then a Http2Exception.StreamException will be returned. Otherwise the error is considered a connection error and a Http2Exception is returned.

headerListSizeError

public static Http2Exception headerListSizeError(int id,
                                                 Http2Error error,
                                                 boolean onDecode,
                                                 java.lang.String fmt,
                                                 java.lang.Object... args)

A specific stream error resulting from failing to decode headers that exceeds the max header size list. If the id is not Http2CodecUtil.CONNECTION_STREAM_ID then a Http2Exception.StreamException will be returned. Otherwise the error is considered a connection error and a Http2Exception is returned.

参数:

id - The stream id for which the error is isolated to.

error - The type of error as defined by the HTTP/2 specification.

onDecode - Whether this error was caught while decoding headers

fmt - String with the content and format for the additional debug data.

args - Objects which fit into the format defined by fmt.

返回:

If the id is not Http2CodecUtil.CONNECTION_STREAM_ID then a Http2Exception.HeaderListSizeException will be returned. Otherwise the error is considered a connection error and a Http2Exception is returned.

isStreamError

public static boolean isStreamError(Http2Exception e)

Check if an exception is isolated to a single stream or the entire connection.

参数:

e - The exception to check.

返回:

true if e is an instance of Http2Exception.StreamException. false otherwise.

streamId

public static int streamId(Http2Exception e)

Get the stream id associated with an exception.

参数:

e - The exception to get the stream id for.

返回:

Http2CodecUtil.CONNECTION_STREAM_ID if e is a connection error. Otherwise the stream id associated with the stream error.