io.micronaut.http.netty

Class NettyHttpHeaders

java.lang.Object

io.micronaut.http.netty.NettyHttpHeaders

All Implemented Interfaces:

ConvertibleMultiValues<String>, ConvertibleValues<List<String>>, Headers, MutableHeaders, ValueResolver<CharSequence>, HttpHeaders, MutableHttpHeaders, Iterable<Map.Entry<String,List<String>>>

@Internal
public class NettyHttpHeaders
extends Object
implements MutableHttpHeaders

Delegates to Netty's HttpHeaders.

Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields inherited from interface io.micronaut.http.MutableHttpHeaders

GMT

Fields inherited from interface io.micronaut.http.HttpHeaders

ACCEPT, ACCEPT_CH, ACCEPT_CH_LIFETIME, ACCEPT_CHARSET, ACCEPT_ENCODING, ACCEPT_LANGUAGE, ACCEPT_PATCH, ACCEPT_RANGES, ACCESS_CONTROL_ALLOW_CREDENTIALS, ACCESS_CONTROL_ALLOW_HEADERS, ACCESS_CONTROL_ALLOW_METHODS, ACCESS_CONTROL_ALLOW_ORIGIN, ACCESS_CONTROL_EXPOSE_HEADERS, ACCESS_CONTROL_MAX_AGE, ACCESS_CONTROL_REQUEST_HEADERS, ACCESS_CONTROL_REQUEST_METHOD, AGE, ALLOW, AUTHORIZATION, AUTHORIZATION_INFO, CACHE_CONTROL, CONNECTION, CONTENT_BASE, CONTENT_DISPOSITION, CONTENT_DPR, CONTENT_ENCODING, CONTENT_LANGUAGE, CONTENT_LENGTH, CONTENT_LOCATION, CONTENT_MD5, CONTENT_RANGE, CONTENT_TRANSFER_ENCODING, CONTENT_TYPE, COOKIE, CROSS_ORIGIN_RESOURCE_POLICY, DATE, DEVICE_MEMORY, DOWNLINK, DPR, ECT, ETAG, EXPECT, EXPIRES, FEATURE_POLICY, FORWARDED, FROM, HOST, IF_MATCH, IF_MODIFIED_SINCE, IF_NONE_MATCH, IF_RANGE, IF_UNMODIFIED_SINCE, LAST_MODIFIED, LINK, LOCATION, MAX_FORWARDS, ORIGIN, PRAGMA, PROXY_AUTHENTICATE, PROXY_AUTHORIZATION, RANGE, REFERER, REFERRER_POLICY, RETRY_AFTER, RTT, SAVE_DATA, SEC_WEBSOCKET_ACCEPT, SEC_WEBSOCKET_KEY, SEC_WEBSOCKET_KEY1, SEC_WEBSOCKET_KEY2, SEC_WEBSOCKET_LOCATION, SEC_WEBSOCKET_ORIGIN, SEC_WEBSOCKET_PROTOCOL, SEC_WEBSOCKET_VERSION, SERVER, SET_COOKIE, SET_COOKIE2, SOURCE_MAP, TE, TRAILER, TRANSFER_ENCODING, UPGRADE, USER_AGENT, VARY, VIA, VIEWPORT_WIDTH, WARNING, WEBSOCKET_LOCATION, WEBSOCKET_ORIGIN, WEBSOCKET_PROTOCOL, WIDTH, WWW_AUTHENTICATE, X_AUTH_TOKEN

Fields inherited from interface io.micronaut.core.convert.value.ConvertibleValues

EMPTY

Constructor Summary

Constructors

Constructor and Description
NettyHttpHeaders() Default constructor.
NettyHttpHeaders(io.netty.handler.codec.http.HttpHeaders nettyHeaders, ConversionService conversionService)

Method Summary

Modifier and Type	Method and Description
MutableHttpHeaders	add(CharSequence header, CharSequence value) Add a header for the given name and value.
MutableHttpHeaders	allowGeneric(Collection<? extends CharSequence> methods) Set the allowed HTTP methods.
MutableHttpHeaders	auth(String userInfo) Used to configure BASIC authentication.
boolean	contains(String name) Whether the given key is contained within these values.
MutableHttpHeaders	contentType(MediaType mediaType) Sets the HttpHeaders.CONTENT_TYPE header to the given media type.
MutableHttpHeaders	date(LocalDateTime date) Adds the date header for the given LocalDateTime.
MutableHttpHeaders	date(long timeInMillis) Adds the DATE header for the given Long.
MutableHttpHeaders	expires(LocalDateTime date) Adds the EXPIRES header for the given LocalDateTime.
MutableHttpHeaders	expires(long timeInMillis) Adds the EXPIRES header for the given Long.
String	get(CharSequence name) Get a value without applying any conversion.
<T> Optional<T>	get(CharSequence name, ArgumentConversionContext<T> conversionContext) Resolve the given property for the given name.
List<String>	getAll(CharSequence name) Get all the values for the given name without applying conversion.
io.netty.handler.codec.http.HttpHeaders	getNettyHeaders()
MutableHttpHeaders	ifModifiedSince(LocalDateTime date) Adds the IF_MODIFIED_SINCE header for the given ZonedDateTime.
MutableHttpHeaders	ifModifiedSince(long timeInMillis) Adds the IF_MODIFIED_SINCE header for the given Long.
MutableHttpHeaders	lastModified(LocalDateTime date) Adds the LAST_MODIFIED header for the given LocalDateTime.
MutableHttpHeaders	lastModified(long timeInMillis) Adds the LAST_MODIFIED header for the given Long.
MutableHttpHeaders	location(URI uri) Sets the location header to the given URI.
Set<String>	names()
MutableHttpHeaders	remove(CharSequence header) Removes a header.
MutableHeaders	set(CharSequence header, CharSequence value) Sets an HTTP header overriding any existing value.
Collection<List<String>>	values()

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.http.MutableHttpHeaders

add, add, allow, allow, auth

Methods inherited from interface io.micronaut.http.HttpHeaders

accept, contentLength, contentType, findDate, findFirst, findInt, getAuthorization, getContentType, getDate, getInt, getOrigin, isKeepAlive

Methods inherited from interface io.micronaut.core.convert.value.ConvertibleMultiValues

empty, forEach, forEachValue, getFirst, getFirst, getFirst, getFirst, getFirst, isEmpty, iterator, of

Methods inherited from interface io.micronaut.core.convert.value.ConvertibleValues

asMap, asMap, asProperties, getValue, getValueType, of, subMap, subMap, subMap

Methods inherited from interface io.micronaut.core.value.ValueResolver

get, get, get

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

NettyHttpHeaders

public NettyHttpHeaders(io.netty.handler.codec.http.HttpHeaders nettyHeaders,
                        ConversionService conversionService)

Parameters:

nettyHeaders - The Netty Http headers

conversionService - The conversion service

NettyHttpHeaders

public NettyHttpHeaders()

Default constructor.

Method Detail

getNettyHeaders

public io.netty.handler.codec.http.HttpHeaders getNettyHeaders()

Returns:

The underlying Netty headers.

contains

public final boolean contains(String name)

Description copied from interface: ConvertibleValues

Whether the given key is contained within these values.

Specified by:

contains in interface ConvertibleValues<List<String>>

Parameters:

name - The key name

Returns:

True if it is

get

public <T> Optional<T> get(CharSequence name,
                           ArgumentConversionContext<T> conversionContext)

Description copied from interface: ValueResolver

Resolve the given property for the given name.

Specified by:

get in interface ValueResolver<CharSequence>

Type Parameters:

T - The concrete type

Parameters:

name - The name

conversionContext - The conversion context

Returns:

An optional containing the property value if it exists and is able to be converted

getAll

public List<String> getAll(CharSequence name)

Description copied from interface: ConvertibleMultiValues

Get all the values for the given name without applying conversion.

Specified by:

getAll in interface ConvertibleMultiValues<String>

Parameters:

name - The header name

Returns:

All the values

names

public Set<String> names()

Specified by:

names in interface ConvertibleValues<List<String>>

Returns:

The names of the values

values

public Collection<List<String>> values()

Specified by:

values in interface ConvertibleValues<List<String>>

Returns:

The values

get

public String get(CharSequence name)

Description copied from interface: ConvertibleMultiValues

Get a value without applying any conversion.

Specified by:

get in interface ConvertibleMultiValues<String>

Parameters:

name - The name of the value

Returns:

The raw value or null

See Also:

ConvertibleMultiValues.getFirst(CharSequence)

add

public MutableHttpHeaders add(CharSequence header,
                              CharSequence value)

Description copied from interface: MutableHttpHeaders

Add a header for the given name and value.

Specified by:

add in interface MutableHeaders

Specified by:

add in interface MutableHttpHeaders

Parameters:

header - The header name

value - The value

Returns:

This headers object

set

public MutableHeaders set(CharSequence header,
                          CharSequence value)

Description copied from interface: MutableHeaders

Sets an HTTP header overriding any existing value.

Specified by:

set in interface MutableHeaders

Specified by:

set in interface MutableHttpHeaders

Parameters:

header - The header

value - The value

Returns:

This headers

remove

public MutableHttpHeaders remove(CharSequence header)

Description copied from interface: MutableHeaders

Removes a header.

Specified by:

remove in interface MutableHeaders

Specified by:

remove in interface MutableHttpHeaders

Parameters:

header - The header to remove

Returns:

These headers

date

public MutableHttpHeaders date(LocalDateTime date)

Description copied from interface: MutableHttpHeaders

Adds the date header for the given LocalDateTime.

Specified by:

date in interface MutableHttpHeaders

Parameters:

date - The local date time (assumed to represent system's default time-zone ZoneId.systemDefault(), will be converted to GMT) as per DateTimeFormatter.RFC_1123_DATE_TIME

Returns:

The MutableHttpHeaders

See Also:

to set date time with time-zone.

expires

public MutableHttpHeaders expires(LocalDateTime date)

Description copied from interface: MutableHttpHeaders

Adds the EXPIRES header for the given LocalDateTime.

Specified by:

expires in interface MutableHttpHeaders

Parameters:

date - The local date time (assumed to represent system's default time-zone ZoneId.systemDefault(), will be converted to GMT) as per DateTimeFormatter.RFC_1123_DATE_TIME

Returns:

The MutableHttpHeaders

See Also:

to set date time with time-zone.

lastModified

public MutableHttpHeaders lastModified(LocalDateTime date)

Description copied from interface: MutableHttpHeaders

Adds the LAST_MODIFIED header for the given LocalDateTime.

Specified by:

lastModified in interface MutableHttpHeaders

Parameters:

date - The local date time (assumed to represent system's default time-zone ZoneId.systemDefault(), will be converted to GMT) as per DateTimeFormatter.RFC_1123_DATE_TIME

Returns:

The MutableHttpHeaders

See Also:

to set date time with time-zone.

ifModifiedSince

public MutableHttpHeaders ifModifiedSince(LocalDateTime date)

Description copied from interface: MutableHttpHeaders

Adds the IF_MODIFIED_SINCE header for the given ZonedDateTime.

Specified by:

ifModifiedSince in interface MutableHttpHeaders

Parameters:

date - The local date time (assumed to represent system's default time-zone ZoneId.systemDefault(), will be converted to GMT) as per DateTimeFormatter.RFC_1123_DATE_TIME

Returns:

The MutableHttpHeaders

See Also:

to set date time with time-zone.

date

public MutableHttpHeaders date(long timeInMillis)

Description copied from interface: MutableHttpHeaders

Adds the DATE header for the given Long.

Specified by:

date in interface MutableHttpHeaders

Parameters:

timeInMillis - The time in milli seconds since Epoch.

Returns:

The MutableHttpHeaders

expires

public MutableHttpHeaders expires(long timeInMillis)

Description copied from interface: MutableHttpHeaders

Adds the EXPIRES header for the given Long.

Specified by:

expires in interface MutableHttpHeaders

Parameters:

timeInMillis - The time in milli seconds since Epoch.

Returns:

The MutableHttpHeaders

lastModified

public MutableHttpHeaders lastModified(long timeInMillis)

Description copied from interface: MutableHttpHeaders

Adds the LAST_MODIFIED header for the given Long.

Specified by:

lastModified in interface MutableHttpHeaders

Parameters:

timeInMillis - The time in milli seconds since Epoch.

Returns:

The MutableHttpHeaders

ifModifiedSince

public MutableHttpHeaders ifModifiedSince(long timeInMillis)

Description copied from interface: MutableHttpHeaders

Adds the IF_MODIFIED_SINCE header for the given Long.

Specified by:

ifModifiedSince in interface MutableHttpHeaders

Parameters:

timeInMillis - The time in milli seconds since Epoch.

Returns:

The MutableHttpHeaders

auth

public MutableHttpHeaders auth(String userInfo)

Description copied from interface: MutableHttpHeaders

Used to configure BASIC authentication.

Specified by:

auth in interface MutableHttpHeaders

Parameters:

userInfo - The user info which is in the form "username:password"

Returns:

This HTTP headers

allowGeneric

public MutableHttpHeaders allowGeneric(Collection<? extends CharSequence> methods)

Description copied from interface: MutableHttpHeaders

Set the allowed HTTP methods.

Specified by:

allowGeneric in interface MutableHttpHeaders

Parameters:

methods - The methods to specify in the Allowed HTTP header

Returns:

This HTTP headers

location

public MutableHttpHeaders location(URI uri)

Description copied from interface: MutableHttpHeaders

Sets the location header to the given URI.

Specified by:

location in interface MutableHttpHeaders

Parameters:

uri - The URI

Returns:

This HTTP headers

contentType

public MutableHttpHeaders contentType(MediaType mediaType)

Description copied from interface: MutableHttpHeaders

Sets the HttpHeaders.CONTENT_TYPE header to the given media type.

Specified by:

contentType in interface MutableHttpHeaders

Parameters:

mediaType - The media type

Returns:

This HTTP headers