com.helger.commons.http

Class HttpHeaderMap

java.lang.Object

com.helger.commons.http.HttpHeaderMap

All Implemented Interfaces:

ICommonsIterable<Map.Entry<String,ICommonsList<String>>>, ICloneable<HttpHeaderMap>, IHasSize, IClearable, Serializable, Iterable<Map.Entry<String,ICommonsList<String>>>

@NotThreadSafe
public class HttpHeaderMap
extends Object
implements IHasSize, ICommonsIterable<Map.Entry<String,ICommonsList<String>>>, ICloneable<HttpHeaderMap>, IClearable

Abstracts HTTP header interface for external usage.

Since:

9.0.0

Author:

Philip Helger

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
HttpHeaderMap() Default constructor.
HttpHeaderMap(HttpHeaderMap aOther) Copy constructor.

Method Summary

Modifier and Type	Method and Description
void	addAllHeaders(HttpHeaderMap aOther) Add all headers from the passed map.
void	addDateHeader(String sName, LocalDate aLD) Add the passed header as a date header.
void	addDateHeader(String sName, LocalDateTime aLDT) Add the passed header as a date header.
void	addDateHeader(String sName, long nMillis) Add the passed header as a date header.
void	addDateHeader(String sName, ZonedDateTime aDT) Add the passed header as a date header.
void	addHeader(String sName, String sValue) Add the passed header as is.
void	addIntHeader(String sName, int nValue) Add the passed header as a number.
void	addLongHeader(String sName, long nValue) Add the passed header as a number.
boolean	containsHeaders(String sName)
boolean	equals(Object o)
void	forEachHeaderLine(Consumer<? super String> aConsumer)
void	forEachSingleHeader(BiConsumer<? super String,? super String> aConsumer) Invoke the provided consumer for every name/value pair.
ICommonsList<String>	getAllHeaderLines()
ICommonsOrderedSet<String>	getAllHeaderNames()
ICommonsOrderedMap<String,ICommonsList<String>>	getAllHeaders()
ICommonsList<String>	getAllHeaderValues(String sName) Get all header values of a certain header name
HttpHeaderMap	getClone()
static String	getDateTimeAsString(LocalDateTime aLDT)
static String	getDateTimeAsString(ZonedDateTime aDT)
String	getFirstHeaderValue(String sName) Get the first header value of a certain header name
String	getHeaderCombined(String sName, String sDelimiter) Get the header value as a combination of all contained values
static String	getUnifiedName(String s) Unify the parameter name by lower casing it.
static String	getUnifiedValue(String sValue) Avoid having header values spanning multiple lines.
int	hashCode()
boolean	isEmpty()
Iterator<Map.Entry<String,ICommonsList<String>>>	iterator()
EChange	removeAll() Remove all contained headers.
EChange	removeHeader(String sName, String sValue)
EChange	removeHeaders(String sName) Remove all header values with the provided name
EChange	removeHeadersIf(Predicate<? super String> aNameFilter) Remove all header values where the name matches the provided filter.
void	setAllHeaders(HttpHeaderMap aOther) Add all headers from the passed map.
void	setContentLength(long nLength)
void	setContentType(String sContentType)
void	setDateHeader(String sName, LocalDate aLD) Set the passed header as a date header.
void	setDateHeader(String sName, LocalDateTime aLDT) Set the passed header as a date header.
void	setDateHeader(String sName, long nMillis) Set the passed header as a date header.
void	setDateHeader(String sName, ZonedDateTime aDT) Set the passed header as a date header.
void	setHeader(String sName, String sValue) Set the passed header as is.
void	setIntHeader(String sName, int nValue) Set the passed header as a number.
void	setLongHeader(String sName, long nValue) Set the passed header as a number.
int	size()
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.commons.lang.IHasSize

isNotEmpty

Methods inherited from interface com.helger.commons.collection.impl.ICommonsIterable

containsAny, containsNone, containsOnly, findAll, findAllInstanceOf, findAllMapped, findAllMapped, findAllMapped, findFirst, findFirst, findFirstMapped, findFirstMapped, forEach, forEachBreakable, forEachByIndex, getCount, getCount

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

HttpHeaderMap

public HttpHeaderMap()

Default constructor.

HttpHeaderMap

public HttpHeaderMap(@Nonnull
                     HttpHeaderMap aOther)

Copy constructor.

Parameters:

aOther - Map to copy from. May not be null.

Method Detail

getUnifiedName

@Nonnull
 @Nonempty
public static String getUnifiedName(@Nonnull @Nonempty
                                                          String s)

Unify the parameter name by lower casing it.
HTTP Header name are case-insensitive
https://www.w3.org/Protocols/rfc2616/rfc2616-sec4.html#sec4.2
HTTP header names must have at least one char
https://www.ietf.org/rfc/rfc0822.txt Chapter 3.2

Parameters:

s - Name to unify. May neither be null nor empty.

Returns:

The unified name and never null.

getUnifiedValue

@Nonnull
public static String getUnifiedValue(@Nullable
                                               String sValue)

Avoid having header values spanning multiple lines. This has been deprecated by RFC 7230 and Jetty 9.3 refuses to parse these requests with HTTP 400 by default.

Parameters:

sValue - The source header value. May be null.

Returns:

The unified header value without \r, \n and \t. Never null.

removeAll

@Nonnull
public EChange removeAll()

Remove all contained headers.

Specified by:

removeAll in interface IClearable

Returns:

EChange.

setHeader

public void setHeader(@Nonnull @Nonempty
                      String sName,
                      @Nullable
                      String sValue)

Set the passed header as is.

Parameters:

sName - Header name. May neither be null nor empty.

sValue - The value to be set. May be null in which case nothing happens.

addHeader

public void addHeader(@Nonnull @Nonempty
                      String sName,
                      @Nullable
                      String sValue)

Add the passed header as is.

Parameters:

sName - Header name. May neither be null nor empty.

sValue - The value to be set. May be null in which case nothing happens.

getDateTimeAsString

@Nonnull
public static String getDateTimeAsString(@Nonnull
                                                   ZonedDateTime aDT)

getDateTimeAsString

@Nonnull
public static String getDateTimeAsString(@Nonnull
                                                   LocalDateTime aLDT)

setDateHeader

public void setDateHeader(@Nonnull @Nonempty
                          String sName,
                          long nMillis)

Set the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

nMillis - The milliseconds to set as a date.

setDateHeader

public void setDateHeader(@Nonnull @Nonempty
                          String sName,
                          @Nonnull
                          LocalDate aLD)

Set the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

aLD - The LocalDate to set as a date. The time is set to start of day. May not be null.

setDateHeader

public void setDateHeader(@Nonnull @Nonempty
                          String sName,
                          @Nonnull
                          LocalDateTime aLDT)

Set the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

aLDT - The LocalDateTime to set as a date. May not be null.

setDateHeader

public void setDateHeader(@Nonnull @Nonempty
                          String sName,
                          @Nonnull
                          ZonedDateTime aDT)

Set the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

aDT - The DateTime to set as a date. May not be null.

addDateHeader

public void addDateHeader(@Nonnull @Nonempty
                          String sName,
                          long nMillis)

Add the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

nMillis - The milliseconds to set as a date.

addDateHeader

public void addDateHeader(@Nonnull @Nonempty
                          String sName,
                          @Nonnull
                          LocalDate aLD)

Add the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

aLD - The LocalDate to set as a date. The time is set to start of day. May not be null.

addDateHeader

public void addDateHeader(@Nonnull @Nonempty
                          String sName,
                          @Nonnull
                          LocalDateTime aLDT)

Add the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

aLDT - The LocalDateTime to set as a date. May not be null.

addDateHeader

public void addDateHeader(@Nonnull @Nonempty
                          String sName,
                          @Nonnull
                          ZonedDateTime aDT)

Add the passed header as a date header.

Parameters:

sName - Header name. May neither be null nor empty.

aDT - The DateTime to set as a date. May not be null.

setIntHeader

public void setIntHeader(@Nonnull @Nonempty
                         String sName,
                         int nValue)

Set the passed header as a number.

Parameters:

sName - Header name. May neither be null nor empty.

nValue - The value to be set. May not be null.

addIntHeader

public void addIntHeader(@Nonnull @Nonempty
                         String sName,
                         int nValue)

Add the passed header as a number.

Parameters:

sName - Header name. May neither be null nor empty.

nValue - The value to be set. May not be null.

setLongHeader

public void setLongHeader(@Nonnull @Nonempty
                          String sName,
                          long nValue)

Set the passed header as a number.

Parameters:

sName - Header name. May neither be null nor empty.

nValue - The value to be set. May not be null.

addLongHeader

public void addLongHeader(@Nonnull @Nonempty
                          String sName,
                          long nValue)

Add the passed header as a number.

Parameters:

sName - Header name. May neither be null nor empty.

nValue - The value to be set. May not be null.

setAllHeaders

public void setAllHeaders(@Nonnull
                          HttpHeaderMap aOther)

Add all headers from the passed map. Existing headers with the same name are overwritten.

Parameters:

aOther - The header map to add. May not be null.

addAllHeaders

public void addAllHeaders(@Nonnull
                          HttpHeaderMap aOther)

Add all headers from the passed map. Existing headers with the same name are extended.

Parameters:

aOther - The header map to add. May not be null.

getAllHeaders

@Nonnull
 @ReturnsMutableCopy
public ICommonsOrderedMap<String,ICommonsList<String>> getAllHeaders()

getAllHeaderNames

@Nonnull
 @ReturnsMutableCopy
public ICommonsOrderedSet<String> getAllHeaderNames()

Returns:

A copy of all contained header names. Never null.

getAllHeaderValues

@Nonnull
 @ReturnsMutableCopy
public ICommonsList<String> getAllHeaderValues(@Nullable
                                                                               String sName)

Get all header values of a certain header name

Parameters:

sName - The name to be searched.

Returns:

The list with all matching values. Never null but maybe empty.

getFirstHeaderValue

@Nullable
public String getFirstHeaderValue(@Nullable
                                             String sName)

Get the first header value of a certain header name

Parameters:

sName - The name to be searched.

Returns:

The first matching value or null.

getHeaderCombined

@Nullable
public String getHeaderCombined(@Nullable
                                           String sName,
                                           @Nonnull
                                           String sDelimiter)

Get the header value as a combination of all contained values

Parameters:

sName - The header name to retrieve. May be null.

sDelimiter - The delimiter to be used. May not be null.

Returns:

null if no such header is contained.

containsHeaders

public boolean containsHeaders(@Nullable
                               String sName)

removeHeadersIf

@Nonnull
public EChange removeHeadersIf(@Nonnull
                                         Predicate<? super String> aNameFilter)

Remove all header values where the name matches the provided filter.

Parameters:

aNameFilter - The name filter to be applied. May not be null.

Returns:

EChange

removeHeaders

@Nonnull
public EChange removeHeaders(@Nullable
                                       String sName)

Remove all header values with the provided name

Parameters:

sName - The name to be removed. May be null.

Returns:

EChange

removeHeader

@Nonnull
public EChange removeHeader(@Nullable
                                      String sName,
                                      @Nullable
                                      String sValue)

iterator

@Nonnull
public Iterator<Map.Entry<String,ICommonsList<String>>> iterator()

Specified by:

iterator in interface Iterable<Map.Entry<String,ICommonsList<String>>>

size

@Nonnegative
public int size()

Specified by:

size in interface IHasSize

Returns:

The number of contained elements. Always ≥ 0.

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface IHasSize

Returns:

true if no items are present, false if at least a single item is present.

See Also:

IHasSize.size(), IHasSize.isNotEmpty()

forEachSingleHeader

public void forEachSingleHeader(@Nonnull
                                BiConsumer<? super String,? super String> aConsumer)

Invoke the provided consumer for every name/value pair.

Parameters:

aConsumer - Consumer to be invoked. May not be null.

forEachHeaderLine

public void forEachHeaderLine(@Nonnull
                              Consumer<? super String> aConsumer)

getAllHeaderLines

@Nonnull
 @ReturnsMutableCopy
public ICommonsList<String> getAllHeaderLines()

setContentLength

public void setContentLength(long nLength)

setContentType

public void setContentType(@Nonnull
                           String sContentType)

getClone

@Nonnull
 @ReturnsMutableCopy
public HttpHeaderMap getClone()

Specified by:

getClone in interface ICloneable<HttpHeaderMap>

Returns:

A 100% deep-copy of the implementing class.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object