io.micronaut.http

Interface HttpRequest<B>

Type Parameters:

B - The Http message body

All Superinterfaces:

AttributeHolder, HttpMessage<B>, MutableAttributeHolder

All Known Subinterfaces:

MutableHttpRequest<B>

All Known Implementing Classes:

AbstractNettyHttpRequest, FullHttpRequest, HttpRequestWrapper, NettyHttpRequest, SimpleHttpRequest

public interface HttpRequest<B>
extends HttpMessage<B>

Common interface for HTTP request implementations.

Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	SCHEME_HTTP Constant for HTTP scheme.
static java.lang.String	SCHEME_HTTPS Constant for HTTPS scheme.

Method Summary

Modifier and Type	Method and Description
default java.util.Collection<MediaType>	accept() A list of accepted MediaType instances sorted by their quality rating.
static <T> MutableHttpRequest<T>	create(HttpMethod httpMethod, java.lang.String uri) Create a new MutableHttpRequest for the given method and URI.
static <T> MutableHttpRequest<T>	create(HttpMethod httpMethod, java.lang.String uri, java.lang.String httpMethodName) Create a new MutableHttpRequest for the given method and URI.
static <T> MutableHttpRequest<T>	DELETE(java.lang.String uri) Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.
static <T> MutableHttpRequest<T>	DELETE(java.lang.String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.
static <T> MutableHttpRequest<T>	DELETE(java.net.URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.
static <T> MutableHttpRequest<T>	GET(java.lang.String uri) Return a MutableHttpRequest for a HttpMethod.GET request for the given URI.
static <T> MutableHttpRequest<T>	GET(java.net.URI uri) Return a MutableHttpRequest for a HttpMethod.GET request for the given URI.
default java.util.Optional<java.security.cert.Certificate>	getCertificate() Retrieves the Certificate used for mutual authentication.
Cookies	getCookies()
default HttpVersion	getHttpVersion()
default java.util.Optional<java.util.Locale>	getLocale()
HttpMethod	getMethod()
default java.lang.String	getMethodName()
HttpParameters	getParameters()
default java.lang.String	getPath()
default java.net.InetSocketAddress	getRemoteAddress()
default java.net.InetSocketAddress	getServerAddress()
default java.lang.String	getServerName()
java.net.URI	getUri()
default java.util.Optional<java.security.Principal>	getUserPrincipal() The user principal stored within the request.
default <T extends java.security.Principal> java.util.Optional<T>	getUserPrincipal(java.lang.Class<T> principalType) The user principal stored within the request.
static MutableHttpRequest<?>	HEAD(java.lang.String uri) Return a MutableHttpRequest for a HttpMethod.HEAD request for the given URI.
static MutableHttpRequest<?>	HEAD(java.net.URI uri) Return a MutableHttpRequest for a HttpMethod.HEAD request for the given URI.
default boolean	isSecure()
default MutableHttpRequest<B>	mutate() Returns a new request object that allows mutation.
static <T> MutableHttpRequest<T>	OPTIONS(java.lang.String uri) Return a MutableHttpRequest for a HttpMethod.OPTIONS request for the given URI.
static <T> MutableHttpRequest<T>	OPTIONS(java.net.URI uri) Return a MutableHttpRequest for a HttpMethod.OPTIONS request for the given URI.
static <T> MutableHttpRequest<T>	PATCH(java.lang.String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PATCH request for the given URI.
static <T> MutableHttpRequest<T>	PATCH(java.net.URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PATCH request for the given URI.
static <T> MutableHttpRequest<T>	POST(java.lang.String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.POST request for the given URI.
static <T> MutableHttpRequest<T>	POST(java.net.URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.POST request for the given URI.
static <T> MutableHttpRequest<T>	PUT(java.lang.String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PUT request for the given URI.
static <T> MutableHttpRequest<T>	PUT(java.net.URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PUT request for the given URI.
default HttpRequest<B>	setAttribute(java.lang.CharSequence name, java.lang.Object value) Sets an attribute on the message.

Methods inherited from interface io.micronaut.http.HttpMessage

getAttributes, getBody, getBody, getBody, getCharacterEncoding, getContentLength, getContentType, getHeaders

Methods inherited from interface io.micronaut.core.attr.MutableAttributeHolder

removeAttribute

Methods inherited from interface io.micronaut.core.attr.AttributeHolder

getAttribute, getAttribute

Field Detail

SCHEME_HTTP

static final java.lang.String SCHEME_HTTP

Constant for HTTP scheme.

See Also:

Constant Field Values

SCHEME_HTTPS

static final java.lang.String SCHEME_HTTPS

Constant for HTTPS scheme.

See Also:

Constant Field Values

Method Detail

getCookies

@NonNull
Cookies getCookies()

Returns:

The Cookies instance

getParameters

@NonNull
HttpParameters getParameters()

Returns:

The HTTP parameters contained with the URI query string

getMethod

@NonNull
HttpMethod getMethod()

Returns:

The request method

getUri

@NonNull
java.net.URI getUri()

Returns:

The full request URI

mutate

default MutableHttpRequest<B> mutate()

Returns a new request object that allows mutation.

Returns:

The mutable request

Since:

2.0.0

getHttpVersion

default HttpVersion getHttpVersion()

Returns:

The http version of the request.

accept

default java.util.Collection<MediaType> accept()

A list of accepted MediaType instances sorted by their quality rating.

Returns:

A list of zero or many MediaType instances

getMethodName

@NonNull
default java.lang.String getMethodName()

Returns:

The name of the method (same as HttpMethod value for standard http methods).

getUserPrincipal

@NonNull
default java.util.Optional<java.security.Principal> getUserPrincipal()

The user principal stored within the request.

Returns:

The principal

Since:

1.0.4

getUserPrincipal

@NonNull
default <T extends java.security.Principal> java.util.Optional<T> getUserPrincipal(java.lang.Class<T> principalType)

The user principal stored within the request.

Type Parameters:

T - The principal type

Parameters:

principalType - The principal type

Returns:

The principal

Since:

1.0.4

getPath

@NonNull
default java.lang.String getPath()

Returns:

Get the path without any parameters

getRemoteAddress

@NonNull
default java.net.InetSocketAddress getRemoteAddress()

Returns:

Obtain the remote address

getServerAddress

@NonNull
default java.net.InetSocketAddress getServerAddress()

Returns:

Obtain the server address

getServerName

@Nullable
default java.lang.String getServerName()

Returns:

The server host name

isSecure

default boolean isSecure()

Returns:

Is the request an HTTPS request

setAttribute

default HttpRequest<B> setAttribute(java.lang.CharSequence name,
                                    java.lang.Object value)

Description copied from interface: MutableAttributeHolder

Sets an attribute on the message.

Specified by:

setAttribute in interface HttpMessage<B>

Specified by:

setAttribute in interface MutableAttributeHolder

Parameters:

name - The name of the attribute

value - The value of the attribute

Returns:

This message

getLocale

default java.util.Optional<java.util.Locale> getLocale()

Specified by:

getLocale in interface HttpMessage<B>

Returns:

The locale of the message

getCertificate

default java.util.Optional<java.security.cert.Certificate> getCertificate()

Retrieves the Certificate used for mutual authentication.

Returns:

A certificate used for authentication, if applicable.

GET

static <T> MutableHttpRequest<T> GET(java.net.URI uri)

Return a MutableHttpRequest for a HttpMethod.GET request for the given URI.

Type Parameters:

T - The Http request type

Parameters:

uri - The URI

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

GET

static <T> MutableHttpRequest<T> GET(java.lang.String uri)

Return a MutableHttpRequest for a HttpMethod.GET request for the given URI.

Type Parameters:

T - The Http request type

Parameters:

uri - The URI

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

OPTIONS

static <T> MutableHttpRequest<T> OPTIONS(java.net.URI uri)

Return a MutableHttpRequest for a HttpMethod.OPTIONS request for the given URI.

Type Parameters:

T - The Http request type

Parameters:

uri - The URI

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

OPTIONS

static <T> MutableHttpRequest<T> OPTIONS(java.lang.String uri)

Return a MutableHttpRequest for a HttpMethod.OPTIONS request for the given URI.

Type Parameters:

T - The Http request type

Parameters:

uri - The URI

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

HEAD

static MutableHttpRequest<?> HEAD(java.net.URI uri)

Return a MutableHttpRequest for a HttpMethod.HEAD request for the given URI.

Parameters:

uri - The URI

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

HEAD

static MutableHttpRequest<?> HEAD(java.lang.String uri)

Return a MutableHttpRequest for a HttpMethod.HEAD request for the given URI.

Parameters:

uri - The URI

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

POST

static <T> MutableHttpRequest<T> POST(java.net.URI uri,
                                      T body)

Return a MutableHttpRequest that executes an HttpMethod.POST request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

POST

static <T> MutableHttpRequest<T> POST(java.lang.String uri,
                                      T body)

Return a MutableHttpRequest that executes an HttpMethod.POST request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

PUT

static <T> MutableHttpRequest<T> PUT(java.net.URI uri,
                                     T body)

Return a MutableHttpRequest that executes an HttpMethod.PUT request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

PUT

static <T> MutableHttpRequest<T> PUT(java.lang.String uri,
                                     T body)

Return a MutableHttpRequest that executes an HttpMethod.PUT request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

PATCH

static <T> MutableHttpRequest<T> PATCH(java.net.URI uri,
                                       T body)

Return a MutableHttpRequest that executes an HttpMethod.PATCH request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

PATCH

static <T> MutableHttpRequest<T> PATCH(java.lang.String uri,
                                       T body)

Return a MutableHttpRequest that executes an HttpMethod.PATCH request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

DELETE

static <T> MutableHttpRequest<T> DELETE(java.net.URI uri,
                                        T body)

Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

DELETE

static <T> MutableHttpRequest<T> DELETE(java.lang.String uri,
                                        T body)

Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.

Type Parameters:

T - The body type

Parameters:

uri - The URI

body - The body of the request (content type defaults to MediaType.APPLICATION_JSON

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

DELETE

static <T> MutableHttpRequest<T> DELETE(java.lang.String uri)

Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.

Type Parameters:

T - The Http request type

Parameters:

uri - The URI

Returns:

The MutableHttpRequest instance

See Also:

HttpRequestFactory

create

static <T> MutableHttpRequest<T> create(HttpMethod httpMethod,
                                        java.lang.String uri)

Create a new MutableHttpRequest for the given method and URI.

Type Parameters:

T - The Http request type

Parameters:

httpMethod - The method

uri - The URI

Returns:

The request

create

static <T> MutableHttpRequest<T> create(HttpMethod httpMethod,
                                        java.lang.String uri,
                                        java.lang.String httpMethodName)

Create a new MutableHttpRequest for the given method and URI.

Type Parameters:

T - The Http request type

Parameters:

httpMethod - The method

uri - The URI

httpMethodName - Method name - for standard http methods is equal to Enum.name()

Returns:

The request