Package io.micronaut.http.server.netty

Class NettyHttpRequest<T>

java.lang.Object
io.netty.util.DefaultAttributeMap
io.micronaut.http.netty.AbstractNettyHttpRequest<T>
io.micronaut.http.server.netty.NettyHttpRequest<T>
Type Parameters:
T - The type
All Implemented Interfaces:
AttributeHolder, MutableAttributeHolder, FullHttpRequest<T>, HttpMessage<T>, HttpRequest<T>, NettyHttpRequestBuilder, PushCapableHttpRequest<T>, io.netty.util.AttributeMap
@Internal public class NettyHttpRequest<T> extends AbstractNettyHttpRequest<T> implements HttpRequest<T>, PushCapableHttpRequest<T>, FullHttpRequest<T>
Delegates to the Netty HttpRequest instance.
Since:
1.0
Author:
Graeme Rocher

  • Constructor Details

  • Method Details

    • createSafe

      public static NettyHttpRequest<?> createSafe(io.netty.handler.codec.http.HttpRequest request, io.netty.channel.ChannelHandlerContext ctx, ConversionService conversionService, NettyHttpServerConfiguration serverConfiguration)

    • rootBody

      public final ByteBody rootBody()
      Get the initial body of this request. This is always a ByteBody. In most cases you should use byteBody() instead.
      Returns:
      The root body

    • byteBody

      public final ByteBody byteBody()
      Get the last byte body of this request, be it claimed or unclaimed. Basically, there are two options: For buffered requests (rootBody is immediate), this is just the root body. For streaming requests (rootBody is streaming), this can be that root body, or if someone called ByteBody.buffer(io.netty.buffer.ByteBufAllocator) (and the buffering has completed), it can be the buffered immediate body.
      The returned byte body may have been claimed already.
      Returns:
      The byte body of this request

    • lastBody

      public final HttpBody lastBody()
      Get the last body of this request, of any type. This is a weird method to use, avoid it. It's sometimes necessary to "piggyback" off other code that parses the body. For example in getBody(), we want to return whatever we can, even if the body has already been claimed for a @Body parameter or form parsing or something. So we take the last step in the parse chain and do our best with it.
      Returns:
      The last body of this request

    • addRouteWaitsFor

      public final void addRouteWaitsFor(ExecutionFlow<?> executionFlow)

    • getRouteWaitsFor

      public final ExecutionFlow<?> getRouteWaitsFor()

    • formRouteCompleter

      public final FormRouteCompleter formRouteCompleter()

    • hasFormRouteCompleter

      public final boolean hasFormRouteCompleter()

    • mutate

      public MutableHttpRequest<T> mutate()
      Description copied from interface: HttpRequest
      Returns a new request object that allows mutation.
      Specified by:
      mutate in interface HttpRequest<T>
      Returns:
      The mutable request

    • getAttribute

      @NonNull public @NonNull Optional<Object> getAttribute(CharSequence name)
      Description copied from interface: AttributeHolder
      Obtain the value of an attribute on the HTTP method.
      Specified by:
      getAttribute in interface AttributeHolder
      Parameters:
      name - The name of the attribute
      Returns:
      An Optional value

    • getHttpVersion

      public HttpVersion getHttpVersion()
      Specified by:
      getHttpVersion in interface HttpRequest<T>
      Returns:
      The http version of the request.

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • getNativeRequest

      public io.netty.handler.codec.http.HttpRequest getNativeRequest()
      Returns:
      Obtain a reference to the native Netty HTTP request

    • getChannelHandlerContext

      public io.netty.channel.ChannelHandlerContext getChannelHandlerContext()
      Returns:
      The ChannelHandlerContext

    • getCookies

      public Cookies getCookies()
      Specified by:
      getCookies in interface HttpRequest<T>
      Returns:
      The Cookies instance

    • getRemoteAddress

      public InetSocketAddress getRemoteAddress()
      Specified by:
      getRemoteAddress in interface HttpRequest<T>
      Returns:
      Obtain the remote address

    • getServerAddress

      public InetSocketAddress getServerAddress()
      Specified by:
      getServerAddress in interface HttpRequest<T>
      Returns:
      Obtain the server address

    • getServerName

      public String getServerName()
      Specified by:
      getServerName in interface HttpRequest<T>
      Returns:
      The server host name

    • isSecure

      public boolean isSecure()
      Specified by:
      isSecure in interface HttpRequest<T>
      Returns:
      Is the request an HTTPS request

    • getOrigin

      public Optional<String> getOrigin()
      Description copied from interface: HttpRequest
      Get the origin header.
      Specified by:
      getOrigin in interface HttpRequest<T>
      Returns:
      The origin header
      See Also:

    • getHeaders

      public HttpHeaders getHeaders()
      Specified by:
      getHeaders in interface HttpMessage<T>
      Returns:
      The HttpHeaders object

    • getAttributes

      public MutableConvertibleValues<Object> getAttributes()
      Description copied from interface: HttpMessage

      A MutableConvertibleValues of the attributes for this HTTP message.

      Attributes are designed for internal data sharing and hence are isolated from headers and parameters which are client supplied

      Specified by:
      getAttributes in interface AttributeHolder
      Specified by:
      getAttributes in interface HttpMessage<T>
      Specified by:
      getAttributes in interface MutableAttributeHolder
      Returns:
      The attributes of the message

    • setAttribute

      public HttpRequest<T> setAttribute(CharSequence name, Object value)
      Description copied from interface: MutableAttributeHolder
      Sets an attribute on the message.
      Specified by:
      setAttribute in interface HttpMessage<T>
      Specified by:
      setAttribute in interface HttpRequest<T>
      Specified by:
      setAttribute in interface MutableAttributeHolder
      Parameters:
      name - The name of the attribute
      value - The value of the attribute
      Returns:
      This message

    • getCertificate

      public Optional<Certificate> getCertificate()
      Description copied from interface: HttpRequest
      Retrieves the Certificate used for mutual authentication.
      Specified by:
      getCertificate in interface HttpRequest<T>
      Returns:
      A certificate used for authentication, if applicable.

    • getBody

      public Optional<T> getBody()
      Specified by:
      getBody in interface HttpMessage<T>
      Returns:
      The request body

    • getBody

      public <T1> Optional<T1> getBody(Class<T1> type)
      Description copied from interface: HttpMessage
      Return the body as the given type.
      Specified by:
      getBody in interface HttpMessage<T>
      Type Parameters:
      T1 - The generic type
      Parameters:
      type - The type of the body
      Returns:
      An Optional of the type or Optional.empty() if the body cannot be returned as the given type

    • getBody

      public <T1> Optional<T1> getBody(ArgumentConversionContext<T1> conversionContext)
      Description copied from interface: HttpMessage
      Return the body, will use the provided conversion context if needed.
      Specified by:
      getBody in interface HttpMessage<T>
      Type Parameters:
      T1 - The generic type
      Parameters:
      conversionContext - The body conversion context
      Returns:
      An Optional of the type or Optional.empty() if the body cannot be returned as the given type

    • release

      @Internal public void release()
      Release and cleanup resources.

    • releaseIfNecessary

      protected void releaseIfNecessary(Object value)
      Parameters:
      value - An object with a value

    • isServerPushSupported

      public boolean isServerPushSupported()
      Description copied from interface: PushCapableHttpRequest
      Check whether HTTP2 server push is supported by the remote client. Only HTTP2 clients that indicate support through HTTP2 settings have this method return true.
      Specified by:
      isServerPushSupported in interface PushCapableHttpRequest<T>
      Returns:
      true iff server push is supported.

    • serverPush

      public PushCapableHttpRequest<T> serverPush(@NonNull @NonNull HttpRequest<?> request)
      Description copied from interface: PushCapableHttpRequest

      Initiate a HTTP2 server push for the given request. The information from the given request (i.e. path, headers) will be passed on to the client immediately so that it does not send the request itself. Then, the given request will be handled as if it was initiated by the client, and the response will be passed back to the client.

      This method mostly follows the semantics of JavaEE javax.servlet.http.PushBuilder. This means most of the headers of this request are copied into the push request, and the referer is set. To override this behavior, add a corresponding header to the request passed as the parameter of this method: those headers take precedence.

      Security note: The Authorization header and other headers not excluded by the above paragraph will be copied and sent to the client as part of a HTTP2 PUSH_PROMISE. Normally, this is fine, because the client sent those headers in the first place. But if there is an intermediate proxy that added a header, this header may then leak to the client.

      Specified by:
      serverPush in interface PushCapableHttpRequest<T>
      Parameters:
      request - The request to respond to using a server push.
      Returns:
      This request.

    • initCharset

      protected Charset initCharset(Charset characterEncoding)
      Specified by:
      initCharset in class AbstractNettyHttpRequest<T>
      Parameters:
      characterEncoding - The charactger encoding
      Returns:
      The Charset

    • isFormOrMultipartData

      @Internal public final boolean isFormOrMultipartData()
      Returns:
      Return true if the request is form data.

    • toHttpRequest

      @Deprecated public io.netty.handler.codec.http.HttpRequest toHttpRequest()
      Deprecated.
      Description copied from interface: NettyHttpRequestBuilder
      Converts this object to the most appropriate http request type.
      Specified by:
      toHttpRequest in interface NettyHttpRequestBuilder
      Overrides:
      toHttpRequest in class AbstractNettyHttpRequest<T>
      Returns:
      The http request

    • toHttpRequestDirect

      public Optional<io.netty.handler.codec.http.HttpRequest> toHttpRequestDirect()
      Description copied from interface: NettyHttpRequestBuilder
      Directly convert this request to netty, including the body, if possible. If the body of this request has been changed, this will return an empty value.
      Specified by:
      toHttpRequestDirect in interface NettyHttpRequestBuilder
      Returns:
      The request including the body

    • toHttpRequestWithoutBody

      public io.netty.handler.codec.http.HttpRequest toHttpRequestWithoutBody()
      Description copied from interface: NettyHttpRequestBuilder
      Convert this request to a netty request without the body. The caller will handle adding the body.
      Specified by:
      toHttpRequestWithoutBody in interface NettyHttpRequestBuilder
      Returns:
      The request excluding the body

    • getContentType

      public Optional<MediaType> getContentType()
      Description copied from interface: HttpMessage
      The request or response content type.
      Specified by:
      getContentType in interface HttpMessage<T>
      Overrides:
      getContentType in class AbstractNettyHttpRequest<T>
      Returns:
      The content type

    • getContentLength

      public long getContentLength()
      Specified by:
      getContentLength in interface HttpMessage<T>
      Returns:
      The value of the Content-Length header or -1L if none specified

    • isFull

      public boolean isFull()
      Description copied from interface: FullHttpRequest
      Shortcut for contents() != null.
      Specified by:
      isFull in interface FullHttpRequest<T>
      Returns:
      Is the request full.

    • contents

      public ByteBuffer<?> contents()
      Description copied from interface: FullHttpRequest
      Get the raw body of this request. May be called multiple times. Buffer ownership is not transferred to the caller.
      Specified by:
      contents in interface FullHttpRequest<T>
      Returns:
      The body contents or null if there are none, or they are not obtainable.

    • bufferContents

      public ExecutionFlow<ByteBuffer<?>> bufferContents()
      Description copied from interface: FullHttpRequest
      Get the contents of this request as a buffer. If this is a streaming request, the returned flow may be delayed. If buffering is not supported for this request, this may return null. Once the returned flow completes, FullHttpRequest.contents() must return the same value.
      Specified by:
      bufferContents in interface FullHttpRequest<T>
      Returns:
      The request content, or null if buffering is not supported