Class HttpConversionUtil

Nested Class Summary

Field Summary

Method Summary

Field Details

• OUT_OF_MESSAGE_SEQUENCE_METHOD

  public static final HttpMethod OUT_OF_MESSAGE_SEQUENCE_METHOD

  This will be the method used for HttpRequest objects generated out of the HTTP message flow defined in [RFC 7540], Section 8.1

• OUT_OF_MESSAGE_SEQUENCE_PATH

  public static final String OUT_OF_MESSAGE_SEQUENCE_PATH

  This will be the path used for HttpRequest objects generated out of the HTTP message flow defined in [RFC 7540], Section 8.1

  See Also:

  • Constant Field Values

• OUT_OF_MESSAGE_SEQUENCE_RETURN_CODE

  public static final HttpResponseStatus OUT_OF_MESSAGE_SEQUENCE_RETURN_CODE

  This will be the status code used for HttpResponse objects generated out of the HTTP message flow defined in [RFC 7540], Section 8.1

Method Details

• parseStatus

  public static HttpResponseStatus parseStatus(CharSequence status) throws Http2Exception

  Apply HTTP/2 rules while translating status code to HttpResponseStatus

  Parameters:

  status - The status from an HTTP/2 frame

  Returns:

  The HTTP/1.x status

  Throws:

  Http2Exception - If there is a problem translating from HTTP/2 to HTTP/1.x

• toFullHttpResponse

  public static FullHttpResponse toFullHttpResponse(int streamId, Http2Headers http2Headers, ByteBufAllocator alloc, boolean validateHttpHeaders) throws Http2Exception

  Create a new object to contain the response data

  Parameters:

  streamId - The stream associated with the response

  http2Headers - The initial set of HTTP/2 headers to create the response with

  alloc - The ByteBufAllocator to use to generate the content of the message

  validateHttpHeaders -

  • true to validate HTTP headers in the http-codec
  • false not to validate HTTP headers in the http-codec

  Returns:

  A new response object which represents headers/data

  Throws:

  Http2Exception - see addHttp2ToHttpHeaders(int, Http2Headers, FullHttpMessage, boolean)

• toFullHttpResponse

  public static FullHttpResponse toFullHttpResponse(int streamId, Http2Headers http2Headers, ByteBuf content, boolean validateHttpHeaders) throws Http2Exception

  Create a new object to contain the response data

  Parameters:

  streamId - The stream associated with the response

  http2Headers - The initial set of HTTP/2 headers to create the response with

  content - ByteBuf content to put in FullHttpResponse

  validateHttpHeaders -

  • true to validate HTTP headers in the http-codec
  • false not to validate HTTP headers in the http-codec

  Returns:

  A new response object which represents headers/data

  Throws:

  Http2Exception - see addHttp2ToHttpHeaders(int, Http2Headers, FullHttpMessage, boolean)

• toFullHttpRequest

  public static FullHttpRequest toFullHttpRequest(int streamId, Http2Headers http2Headers, ByteBufAllocator alloc, boolean validateHttpHeaders) throws Http2Exception

  Create a new object to contain the request data

  Parameters:

  streamId - The stream associated with the request

  http2Headers - The initial set of HTTP/2 headers to create the request with

  alloc - The ByteBufAllocator to use to generate the content of the message

  validateHttpHeaders -

  • true to validate HTTP headers in the http-codec
  • false not to validate HTTP headers in the http-codec

  Returns:

  A new request object which represents headers/data

  Throws:

  Http2Exception - see addHttp2ToHttpHeaders(int, Http2Headers, FullHttpMessage, boolean)

• toFullHttpRequest

  public static FullHttpRequest toFullHttpRequest(int streamId, Http2Headers http2Headers, ByteBuf content, boolean validateHttpHeaders) throws Http2Exception

  Create a new object to contain the request data

  Parameters:

  streamId - The stream associated with the request

  http2Headers - The initial set of HTTP/2 headers to create the request with

  content - ByteBuf content to put in FullHttpRequest

  validateHttpHeaders -

  • true to validate HTTP headers in the http-codec
  • false not to validate HTTP headers in the http-codec

  Returns:

  A new request object which represents headers/data

  Throws:

  Http2Exception - see addHttp2ToHttpHeaders(int, Http2Headers, FullHttpMessage, boolean)

• toHttpRequest

  public static HttpRequest toHttpRequest(int streamId, Http2Headers http2Headers, boolean validateHttpHeaders) throws Http2Exception

  Create a new object to contain the request data.

  Parameters:

  streamId - The stream associated with the request

  http2Headers - The initial set of HTTP/2 headers to create the request with

  validateHttpHeaders -

  • true to validate HTTP headers in the http-codec
  • false not to validate HTTP headers in the http-codec

  Returns:

  A new request object which represents headers for a chunked request

  Throws:

  Http2Exception - see addHttp2ToHttpHeaders(int, Http2Headers, FullHttpMessage, boolean)

• toHttpResponse

  public static HttpResponse toHttpResponse(int streamId, Http2Headers http2Headers, boolean validateHttpHeaders) throws Http2Exception

  Create a new object to contain the response data.

  Parameters:

  streamId - The stream associated with the response

  http2Headers - The initial set of HTTP/2 headers to create the response with

  validateHttpHeaders -

  • true to validate HTTP headers in the http-codec
  • false not to validate HTTP headers in the http-codec

  Returns:

  A new response object which represents headers for a chunked response

  Throws:

  Http2Exception - see addHttp2ToHttpHeaders(int, Http2Headers, HttpHeaders, HttpVersion, boolean, boolean)

• addHttp2ToHttpHeaders

  public static void addHttp2ToHttpHeaders(int streamId, Http2Headers inputHeaders, FullHttpMessage destinationMessage, boolean addToTrailer) throws Http2Exception

  Translate and add HTTP/2 headers to HTTP/1.x headers.

  Parameters:

  streamId - The stream associated with sourceHeaders.

  inputHeaders - The HTTP/2 headers to convert.

  destinationMessage - The object which will contain the resulting HTTP/1.x headers.

  addToTrailer - true to add to trailing headers. false to add to initial headers.

  Throws:

  Http2Exception - If not all HTTP/2 headers can be translated to HTTP/1.x.

  See Also:

  • addHttp2ToHttpHeaders(int, Http2Headers, HttpHeaders, HttpVersion, boolean, boolean)

• addHttp2ToHttpHeaders

  public static void addHttp2ToHttpHeaders(int streamId, Http2Headers inputHeaders, HttpHeaders outputHeaders, HttpVersion httpVersion, boolean isTrailer, boolean isRequest) throws Http2Exception

  Translate and add HTTP/2 headers to HTTP/1.x headers.

  Parameters:

  streamId - The stream associated with sourceHeaders.

  inputHeaders - The HTTP/2 headers to convert.

  outputHeaders - The object which will contain the resulting HTTP/1.x headers..

  httpVersion - What HTTP/1.x version outputHeaders should be treated as when doing the conversion.

  isTrailer - true if outputHeaders should be treated as trailing headers. false otherwise.

  isRequest - true if the outputHeaders will be used in a request message. false for response message.

  Throws:

  Http2Exception - If not all HTTP/2 headers can be translated to HTTP/1.x.

• toHttp2Headers

  public static Http2Headers toHttp2Headers(HttpMessage in, boolean validateHeaders)

  Converts the given HTTP/1.x headers into HTTP/2 headers. The following headers are only used if they can not be found in from the HOST header or the Request-Line as defined by rfc7230

  • HttpConversionUtil.ExtensionHeaderNames.SCHEME

  HttpConversionUtil.ExtensionHeaderNames.PATH is ignored and instead extracted from the Request-Line.

• toHttp2Headers

  public static Http2Headers toHttp2Headers(HttpHeaders inHeaders, boolean validateHeaders)

• toHttp2Headers

  public static void toHttp2Headers(HttpHeaders inHeaders, Http2Headers out)