Package io.servicetalk.http.api

Class EmptyHttpHeaders

java.lang.Object

io.servicetalk.http.api.EmptyHttpHeaders

All Implemented Interfaces:

HttpHeaders, Iterable<Map.Entry<CharSequence,CharSequence>>

public final class EmptyHttpHeaders
extends Object
implements HttpHeaders

HttpHeaders which are always empty and does not allow modification.

Field Summary

Fields

Modifier and Type	Field	Description
static final HttpHeaders	INSTANCE

Method Summary

Modifier and Type	Method	Description
HttpHeaders	add(HttpHeaders headers)	Adds all header names and values of headers to this object.
HttpHeaders	add(CharSequence name, CharSequence value)	Adds a new header with the specified name and value.
HttpHeaders	add(CharSequence name, CharSequence... values)	Adds new headers with the specified name and values.
HttpHeaders	add(CharSequence name, Iterable<? extends CharSequence> values)	Adds new headers with the specified name and values.
HttpHeaders	add(CharSequence name, Iterator<? extends CharSequence> valuesItr)	Adds new headers with the specified name and values.
HttpHeaders	addCookie(HttpCookiePair cookie)	Adds a cookie.
HttpHeaders	addCookie(CharSequence name, CharSequence value)	Adds a cookie with the specified name and value.
HttpHeaders	addSetCookie(HttpSetCookie cookie)	Adds a set-cookie.
HttpHeaders	addSetCookie(CharSequence name, CharSequence value)	Adds a set-cookie with the specified name and value.
HttpHeaders	clear()	Removes all headers.
boolean	contains(CharSequence name)	Returns true if a header with the name exists, false otherwise.
boolean	contains(CharSequence name, CharSequence value)	Returns true if a header with the name and value exists, false otherwise.
boolean	containsIgnoreCase(CharSequence name, CharSequence value)	Returns true if a header with the name and value exists, false otherwise.
boolean	equals(Object o)
void	forEach(Consumer<? super Map.Entry<CharSequence,CharSequence>> action)
CharSequence	get(CharSequence name)	Returns the value of a header with the specified name.
CharSequence	get(CharSequence name, CharSequence defaultValue)	Returns the value of a header with the specified name.
CharSequence	getAndRemove(CharSequence name)	Returns the value of a header with the specified name and removes it from this object.
CharSequence	getAndRemove(CharSequence name, CharSequence defaultValue)	Returns the value of a header with the specified name and removes it from this object.
HttpCookiePair	getCookie(CharSequence name)	Gets a cookie identified by name.
Iterable<? extends HttpCookiePair>	getCookies()	Gets all the cookies.
Iterable<? extends HttpCookiePair>	getCookies(CharSequence name)	Gets the cookies with the same name.
Iterator<? extends HttpCookiePair>	getCookiesIterator()	Gets all the cookies.
Iterator<? extends HttpCookiePair>	getCookiesIterator(CharSequence name)	Gets the cookies with the same name.
HttpSetCookie	getSetCookie(CharSequence name)	Gets a set-cookie identified by name.
Iterable<? extends HttpSetCookie>	getSetCookies()	Gets all the set-cookies.
Iterable<? extends HttpSetCookie>	getSetCookies(CharSequence name)	Gets the set-cookies with the same name.
Iterable<? extends HttpSetCookie>	getSetCookies(CharSequence name, CharSequence domain, CharSequence path)	Gets the set-cookies with the same name.
Iterator<? extends HttpSetCookie>	getSetCookiesIterator()	Gets all the set-cookies.
Iterator<? extends HttpSetCookie>	getSetCookiesIterator(CharSequence name)	Gets the set-cookies with the same name.
Iterator<? extends HttpSetCookie>	getSetCookiesIterator(CharSequence name, CharSequence domain, CharSequence path)	Gets the set-cookies with the same name.
int	hashCode()
boolean	isEmpty()	Returns true if HttpHeaders.size() equals 0.
Iterator<Map.Entry<CharSequence,CharSequence>>	iterator()
Set<? extends CharSequence>	names()	Returns a Set of all header names in this object.
boolean	remove(CharSequence name)	Removes all headers with the specified name.
boolean	remove(CharSequence name, CharSequence value)	Removes specific value(s) from the specified header name.
boolean	removeCookies(CharSequence name)	Removes all cookie identified by name.
boolean	removeIgnoreCase(CharSequence name, CharSequence value)	Removes specific value(s) from the specified header name.
boolean	removeSetCookies(CharSequence name)	Removes all set-cookie identified by name.
boolean	removeSetCookies(CharSequence name, CharSequence domain, CharSequence path)	Removes all set-cookie identified by name.
HttpHeaders	replace(HttpHeaders headers)	Removes all header names contained in headers from this object, and then adds all headers contained in headers.
HttpHeaders	set(HttpHeaders headers)	Clears the current header entries and copies all header entries of the specified headers object.
HttpHeaders	set(CharSequence name, CharSequence value)	Sets a header with the specified name and value.
HttpHeaders	set(CharSequence name, CharSequence... values)	Sets a header with the specified name and values.
HttpHeaders	set(CharSequence name, Iterable<? extends CharSequence> values)	Sets a new header with the specified name and values.
HttpHeaders	set(CharSequence name, Iterator<? extends CharSequence> valueItr)	Sets a new header with the specified name and values.
int	size()	Returns the number of headers in this object.
Spliterator<Map.Entry<CharSequence,CharSequence>>	spliterator()
String	toString()	Returns a String representation of this HttpHeaders.
String	toString(BiFunction<? super CharSequence,? super CharSequence,CharSequence> filter)	Builds a string which represents all the content in this HttpHeaders in which sensitive headers can be filtered via filter.
Iterable<? extends CharSequence>	values(CharSequence name)	Returns all values for the header with the specified name.
Iterator<? extends CharSequence>	valuesIterator(CharSequence name)	Returns all values for the header with the specified name.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

INSTANCE

public static final HttpHeaders INSTANCE

Method Details

get

@Nullable
public CharSequence get(CharSequence name)

Description copied from interface: HttpHeaders

Returns the value of a header with the specified name. If there is more than one value for the specified name, the first value in insertion order is returned.

Specified by:

get in interface HttpHeaders

Parameters:

name - the name of the header to retrieve.

Returns:

the first header value if the header is found. null if there's no such header.

get

public CharSequence get(CharSequence name,
 CharSequence defaultValue)

Description copied from interface: HttpHeaders

Returns the value of a header with the specified name. If there is more than one value for the specified name, the first value in insertion order is returned.

Specified by:

get in interface HttpHeaders

Parameters:

name - the name of the header to retrieve.

defaultValue - the default value.

Returns:

the first header value or defaultValue if there is no such header.

getAndRemove

@Nullable
public CharSequence getAndRemove(CharSequence name)

Description copied from interface: HttpHeaders

Returns the value of a header with the specified name and removes it from this object. If there is more than one value for the specified name, the first value in insertion order is returned.

Specified by:

getAndRemove in interface HttpHeaders

Parameters:

name - the name of the header to retrieve.

Returns:

the first header value or null if there is no such header.

getAndRemove

public CharSequence getAndRemove(CharSequence name,
 CharSequence defaultValue)

Description copied from interface: HttpHeaders

Returns the value of a header with the specified name and removes it from this object. If there is more than one value for the specified name, the first value in insertion order is returned.

Specified by:

getAndRemove in interface HttpHeaders

Parameters:

name - the name of the header to retrieve.

defaultValue - the default value.

Returns:

the first header value or defaultValue if there is no such header.

values

public Iterable<? extends CharSequence> values(CharSequence name)

Description copied from interface: HttpHeaders

Returns all values for the header with the specified name.

Specified by:

values in interface HttpHeaders

Parameters:

name - the name of the header to retrieve.

Returns:

a Iterable of header values or an empty Iterable if no values are found.

See Also:

• if minimal object allocation is required.

valuesIterator

public Iterator<? extends CharSequence> valuesIterator(CharSequence name)

Description copied from interface: HttpHeaders

Returns all values for the header with the specified name.

Specified by:

valuesIterator in interface HttpHeaders

Parameters:

name - the name of the header to retrieve.

Returns:

a Iterator of header values or an empty Iterator if no values are found.

See Also:

• if Iterable is preferred, at the expense of more object allocation.

contains

public boolean contains(CharSequence name)

Description copied from interface: HttpHeaders

Returns true if a header with the name exists, false otherwise.

Specified by:

contains in interface HttpHeaders

Parameters:

name - the header name.

Returns:

true if name exists.

contains

public boolean contains(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Returns true if a header with the name and value exists, false otherwise.

Specified by:

contains in interface HttpHeaders

Parameters:

name - the header name.

value - the header value of the header to find.

Returns:

true if a name, value pair exists.

containsIgnoreCase

public boolean containsIgnoreCase(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Returns true if a header with the name and value exists, false otherwise.

Case insensitive compare is done on the value.

Specified by:

containsIgnoreCase in interface HttpHeaders

Parameters:

name - the name of the header to find.

value - the value of the header to find.

Returns:

true if found.

size

public int size()

Description copied from interface: HttpHeaders

Returns the number of headers in this object.

Specified by:

size in interface HttpHeaders

Returns:

the number of headers in this object.

isEmpty

public boolean isEmpty()

Description copied from interface: HttpHeaders

Returns true if HttpHeaders.size() equals 0.

Specified by:

isEmpty in interface HttpHeaders

Returns:

true if HttpHeaders.size() equals 0.

names

public Set<? extends CharSequence> names()

Description copied from interface: HttpHeaders

Returns a Set of all header names in this object. The returned Set cannot be modified.

Specified by:

names in interface HttpHeaders

Returns:

a Set of all header names in this object. The returned Set cannot be modified.

add

public HttpHeaders add(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Adds a new header with the specified name and value.

Specified by:

add in interface HttpHeaders

Parameters:

name - the name of the header.

value - the value of the header.

Returns:

this.

add

public HttpHeaders add(CharSequence name,
 Iterable<? extends CharSequence> values)

Description copied from interface: HttpHeaders

Adds new headers with the specified name and values. This method is semantically equivalent to:

 for (T value : values) {
     headers.add(name, value);
 }
 

Specified by:

add in interface HttpHeaders

Parameters:

name - the name of the header.

values - the values of the header.

Returns:

this.

add

public HttpHeaders add(CharSequence name,
 Iterator<? extends CharSequence> valuesItr)

Description copied from interface: HttpHeaders

Adds new headers with the specified name and values. This method is semantically equivalent to:

 while (valueItr.hasNext()) {
     headers.add(name, valueItr.next());
 }
 

Specified by:

add in interface HttpHeaders

Parameters:

name - the name of the header.

valuesItr - the values of the header.

Returns:

this.

add

public HttpHeaders add(CharSequence name,
 CharSequence... values)

Description copied from interface: HttpHeaders

Adds new headers with the specified name and values. This method is semantically equivalent to:

 for (T value : values) {
     headers.add(name, value);
 }
 

Specified by:

add in interface HttpHeaders

Parameters:

name - the name of the header.

values - the values of the header.

Returns:

this.

add

public HttpHeaders add(HttpHeaders headers)

Description copied from interface: HttpHeaders

Adds all header names and values of headers to this object.

Specified by:

add in interface HttpHeaders

Parameters:

headers - the headers to add.

Returns:

this.

set

public HttpHeaders set(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Sets a header with the specified name and value. Any existing headers with the same name are overwritten.

Specified by:

set in interface HttpHeaders

Parameters:

name - the name of the header.

value - the value of the header.

Returns:

this.

set

public HttpHeaders set(CharSequence name,
 Iterable<? extends CharSequence> values)

Description copied from interface: HttpHeaders

Sets a new header with the specified name and values. This method is equivalent to:

 headers.remove(name);
 for (T value : values) {
     headers.add(name, value);
 }
 

Specified by:

set in interface HttpHeaders

Parameters:

name - the name of the header.

values - the values of the header.

Returns:

this.

set

public HttpHeaders set(CharSequence name,
 Iterator<? extends CharSequence> valueItr)

Description copied from interface: HttpHeaders

Sets a new header with the specified name and values. This method is equivalent to:

 headers.remove(name);
 while (valueItr.hasNext()) {
     headers.add(name, valueItr.next());
 }
 

Specified by:

set in interface HttpHeaders

Parameters:

name - the name of the header.

valueItr - the values of the header.

Returns:

this.

set

public HttpHeaders set(CharSequence name,
 CharSequence... values)

Description copied from interface: HttpHeaders

Sets a header with the specified name and values. Any existing headers with this name are removed. This method is equivalent to:

 headers.remove(name);
 for (T value : values) {
     headers.add(name, value);
 }
 

Specified by:

set in interface HttpHeaders

Parameters:

name - the name of the header.

values - the values of the header.

Returns:

this.

set

public HttpHeaders set(HttpHeaders headers)

Description copied from interface: HttpHeaders

Clears the current header entries and copies all header entries of the specified headers object.

Specified by:

set in interface HttpHeaders

Parameters:

headers - the headers object which contains new values.

Returns:

this.

replace

public HttpHeaders replace(HttpHeaders headers)

Description copied from interface: HttpHeaders

Removes all header names contained in headers from this object, and then adds all headers contained in headers.

Specified by:

replace in interface HttpHeaders

Parameters:

headers - the headers used to remove names and then add new entries.

Returns:

this.

remove

public boolean remove(CharSequence name)

Description copied from interface: HttpHeaders

Removes all headers with the specified name.

Specified by:

remove in interface HttpHeaders

Parameters:

name - the name of the header.

Returns:

true if at least one entry has been removed.

remove

public boolean remove(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Removes specific value(s) from the specified header name. If the header has more than one identical values, all of them will be removed.

Specified by:

remove in interface HttpHeaders

Parameters:

name - the name of the header.

value - the value of the header to remove.

Returns:

true if at least one value has been removed.

removeIgnoreCase

public boolean removeIgnoreCase(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Removes specific value(s) from the specified header name. If the header has more than one identical values, all of them will be removed.

Case insensitive compare is done on the value.

Specified by:

removeIgnoreCase in interface HttpHeaders

Parameters:

name - the name of the header.

value - the value of the header to remove.

Returns:

true if at least one value has been removed.

clear

public HttpHeaders clear()

Description copied from interface: HttpHeaders

Removes all headers.

Specified by:

clear in interface HttpHeaders

Returns:

this.

iterator

public Iterator<Map.Entry<CharSequence,CharSequence>> iterator()

Specified by:

iterator in interface HttpHeaders

Specified by:

iterator in interface Iterable<Map.Entry<CharSequence,CharSequence>>

spliterator

public Spliterator<Map.Entry<CharSequence,CharSequence>> spliterator()

Specified by:

spliterator in interface HttpHeaders

Specified by:

spliterator in interface Iterable<Map.Entry<CharSequence,CharSequence>>

forEach

public void forEach(Consumer<? super Map.Entry<CharSequence,CharSequence>> action)

Specified by:

forEach in interface Iterable<Map.Entry<CharSequence,CharSequence>>

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Description copied from interface: HttpHeaders

Returns a String representation of this HttpHeaders. To avoid accidentally logging sensitive information, implementations should be cautious about logging header content and consider using HttpHeaders.toString(BiFunction).

Specified by:

toString in interface HttpHeaders

Overrides:

toString in class Object

Returns:

a simple String representation of this HttpHeaders.

toString

public String toString(BiFunction<? super CharSequence,? super CharSequence,CharSequence> filter)

Description copied from interface: HttpHeaders

Builds a string which represents all the content in this HttpHeaders in which sensitive headers can be filtered via filter.

Specified by:

toString in interface HttpHeaders

Parameters:

filter - a function that accepts the header name and value and returns the filtered value.

Returns:

string representation of this HttpHeaders.

getCookie

@Nullable
public HttpCookiePair getCookie(CharSequence name)

Description copied from interface: HttpHeaders

Gets a cookie identified by name. If there is more than one HttpSetCookie for the specified name, the first HttpSetCookie in insertion order is returned.

Specified by:

getCookie in interface HttpHeaders

Parameters:

name - the cookie-name to look for.

Returns:

a HttpSetCookie identified by name.

getSetCookie

@Nullable
public HttpSetCookie getSetCookie(CharSequence name)

Description copied from interface: HttpHeaders

Gets a set-cookie identified by name. If there is more than one HttpSetCookie for the specified name, the first HttpSetCookie in insertion order is returned.

Specified by:

getSetCookie in interface HttpHeaders

Parameters:

name - the cookie-name to look for.

Returns:

a HttpSetCookie identified by name.

getCookies

public Iterable<? extends HttpCookiePair> getCookies()

Description copied from interface: HttpHeaders

Gets all the cookies.

Specified by:

getCookies in interface HttpHeaders

Returns:

An Iterable with all the cookies.

See Also:

• if minimal object allocation is required.

getCookiesIterator

public Iterator<? extends HttpCookiePair> getCookiesIterator()

Description copied from interface: HttpHeaders

Gets all the cookies.

Specified by:

getCookiesIterator in interface HttpHeaders

Returns:

An Iterator with all the cookies.

See Also:

• if Iterable is preferred, at the expense of more object allocation.

getCookies

public Iterable<? extends HttpCookiePair> getCookies(CharSequence name)

Description copied from interface: HttpHeaders

Gets the cookies with the same name.

Specified by:

getCookies in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to get.

Returns:

An Iterable where all the HttpSetCookies have the same name.

See Also:

• if minimal object allocation is required.

getCookiesIterator

public Iterator<? extends HttpCookiePair> getCookiesIterator(CharSequence name)

Description copied from interface: HttpHeaders

Gets the cookies with the same name.

Specified by:

getCookiesIterator in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to get.

Returns:

An Iterator where all the HttpSetCookies have the same name.

See Also:

• if Iterable is preferred, at the expense of more object allocation.

getSetCookies

public Iterable<? extends HttpSetCookie> getSetCookies()

Description copied from interface: HttpHeaders

Gets all the set-cookies.

Specified by:

getSetCookies in interface HttpHeaders

Returns:

An Iterable with all the set-cookies.

See Also:

• if minimal object allocation is required.

getSetCookiesIterator

public Iterator<? extends HttpSetCookie> getSetCookiesIterator()

Description copied from interface: HttpHeaders

Gets all the set-cookies.

Specified by:

getSetCookiesIterator in interface HttpHeaders

Returns:

An Iterator with all the set-cookies.

See Also:

• if Iterable is preferred, at the expense of more object allocation.

getSetCookies

public Iterable<? extends HttpSetCookie> getSetCookies(CharSequence name)

Description copied from interface: HttpHeaders

Gets the set-cookies with the same name.

Specified by:

getSetCookies in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to get.

Returns:

An Iterable where all the HttpSetCookies have the same name.

See Also:

• if minimal object allocation is required.

getSetCookiesIterator

public Iterator<? extends HttpSetCookie> getSetCookiesIterator(CharSequence name)

Description copied from interface: HttpHeaders

Gets the set-cookies with the same name.

Specified by:

getSetCookiesIterator in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to get.

Returns:

An Iterator where all the HttpSetCookies have the same name.

See Also:

• if Iterable is preferred, at the expense of more object allocation.

getSetCookies

public Iterable<? extends HttpSetCookie> getSetCookies(CharSequence name,
 CharSequence domain,
 CharSequence path)

Description copied from interface: HttpHeaders

Gets the set-cookies with the same name.

Specified by:

getSetCookies in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to get.

domain - the domain-value of the HttpSetCookies to get. This value may be matched according to the Domain Matching algorithm.

path - the path-av of the HttpSetCookies to get. This value may be matched according to the Path Matching algorithm.

Returns:

An Iterable where all the HttpSetCookies match the parameter values.

See Also:

• if minimal object allocation is required.

getSetCookiesIterator

public Iterator<? extends HttpSetCookie> getSetCookiesIterator(CharSequence name,
 CharSequence domain,
 CharSequence path)

Description copied from interface: HttpHeaders

Gets the set-cookies with the same name.

Specified by:

getSetCookiesIterator in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to get.

domain - the domain-value of the HttpSetCookies to get. This value may be matched according to the Domain Matching algorithm.

path - the path-av of the HttpSetCookies to get. This value may be matched according to the Path Matching algorithm.

Returns:

An Iterator where all the HttpSetCookies match the parameter values.

See Also:

• if Iterable is preferred, at the expense of more object allocation.

addCookie

public HttpHeaders addCookie(HttpCookiePair cookie)

Description copied from interface: HttpHeaders

Adds a cookie.

This may result in multiple HttpCookiePairs with same name.

Specified by:

addCookie in interface HttpHeaders

Parameters:

cookie - the cookie to add.

Returns:

this.

addCookie

public HttpHeaders addCookie(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Adds a cookie with the specified name and value.

This may result in multiple HttpSetCookies with same name. Added cookie will not be wrapped, not secure, and not HTTP-only, with no path, domain, expire date and maximum age.

Specified by:

addCookie in interface HttpHeaders

Parameters:

name - the name of the cookie.

value - the value of the cookie.

Returns:

this.

addSetCookie

public HttpHeaders addSetCookie(HttpSetCookie cookie)

Description copied from interface: HttpHeaders

Adds a set-cookie.

This may result in multiple HttpSetCookies with same name.

Specified by:

addSetCookie in interface HttpHeaders

Parameters:

cookie - the cookie to add.

Returns:

this.

addSetCookie

public HttpHeaders addSetCookie(CharSequence name,
 CharSequence value)

Description copied from interface: HttpHeaders

Adds a set-cookie with the specified name and value.

This may result in multiple HttpSetCookies with same name. Added cookie will not be wrapped, not secure, and not HTTP-only, with no path, domain, expire date and maximum age.

Specified by:

addSetCookie in interface HttpHeaders

Parameters:

name - the name of the cookie.

value - the value of the cookie.

Returns:

this.

removeCookies

public boolean removeCookies(CharSequence name)

Description copied from interface: HttpHeaders

Removes all cookie identified by name.

Specified by:

removeCookies in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to remove.

Returns:

true if at least one entry has been removed.

removeSetCookies

public boolean removeSetCookies(CharSequence name)

Description copied from interface: HttpHeaders

Removes all set-cookie identified by name.

Specified by:

removeSetCookies in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to remove.

Returns:

true if at least one entry has been removed.

removeSetCookies

public boolean removeSetCookies(CharSequence name,
 CharSequence domain,
 CharSequence path)

Description copied from interface: HttpHeaders

Removes all set-cookie identified by name.

Specified by:

removeSetCookies in interface HttpHeaders

Parameters:

name - the cookie-name of the HttpSetCookies to remove.

domain - the domain-value of the HttpSetCookies to remove. This value may be matched according to the Domain Matching algorithm.

path - the path-av of the HttpSetCookies to remove. This value may be matched according to the Path Matching algorithm.

Returns:

true if at least one entry has been removed.