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

Method Summary

Modifier and Type	Method and Description
static <T> MutableHttpRequest<T>	create(HttpMethod httpMethod, String uri) Create a new MutableHttpRequest for the given method and URI.
static <T> MutableHttpRequest<T>	DELETE(String uri) Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.
static <T> MutableHttpRequest<T>	DELETE(String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.
static <T> MutableHttpRequest<T>	DELETE(URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.DELETE request for the given URI.
static <T> MutableHttpRequest<T>	GET(String uri) Return a MutableHttpRequest for a HttpMethod.GET request for the given URI.
static <T> MutableHttpRequest<T>	GET(URI uri) Return a MutableHttpRequest for a HttpMethod.GET request for the given URI.
Cookies	getCookies()
default Optional<Locale>	getLocale()
HttpMethod	getMethod()
HttpParameters	getParameters()
default String	getPath()
default InetSocketAddress	getRemoteAddress()
default InetSocketAddress	getServerAddress()
default String	getServerName()
URI	getUri()
default Optional<Principal>	getUserPrincipal() The user principal stored within the request.
default <T extends Principal> Optional<T>	getUserPrincipal(Class<T> principalType) The user principal stored within the request.
static MutableHttpRequest<?>	HEAD(String uri) Return a MutableHttpRequest for a HttpMethod.HEAD request for the given URI.
static MutableHttpRequest<?>	HEAD(URI uri) Return a MutableHttpRequest for a HttpMethod.HEAD request for the given URI.
default boolean	isSecure()
static <T> MutableHttpRequest<T>	OPTIONS(String uri) Return a MutableHttpRequest for a HttpMethod.OPTIONS request for the given URI.
static <T> MutableHttpRequest<T>	OPTIONS(URI uri) Return a MutableHttpRequest for a HttpMethod.OPTIONS request for the given URI.
static <T> MutableHttpRequest<T>	PATCH(String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PATCH request for the given URI.
static <T> MutableHttpRequest<T>	PATCH(URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PATCH request for the given URI.
static <T> MutableHttpRequest<T>	POST(String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.POST request for the given URI.
static <T> MutableHttpRequest<T>	POST(URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.POST request for the given URI.
static <T> MutableHttpRequest<T>	PUT(String uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PUT request for the given URI.
static <T> MutableHttpRequest<T>	PUT(URI uri, T body) Return a MutableHttpRequest that executes an HttpMethod.PUT request for the given URI.
default HttpRequest<B>	setAttribute(CharSequence name, 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

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
URI getUri()

Returns:

The full request URI

getUserPrincipal

@Nonnull
default Optional<Principal> getUserPrincipal()

The user principal stored within the request.

Returns:

The principal

Since:

1.0.4

getUserPrincipal

@Nonnull
default <T extends Principal> Optional<T> getUserPrincipal(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 String getPath()

Returns:

Get the path without any parameters

getRemoteAddress

@Nonnull
default InetSocketAddress getRemoteAddress()

Returns:

Obtain the remote address

getServerAddress

@Nonnull
default InetSocketAddress getServerAddress()

Returns:

Obtain the server address

getServerName

@Nullable
default String getServerName()

Returns:

The server host name

isSecure

default boolean isSecure()

Returns:

Is the request an HTTPS request

setAttribute

default HttpRequest<B> setAttribute(CharSequence name,
                                    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 Optional<Locale> getLocale()

Specified by:

getLocale in interface HttpMessage<B>

Returns:

The locale of the message

GET

static <T> MutableHttpRequest<T> GET(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(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(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(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(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(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(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(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(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(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(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(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(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(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(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,
                                        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