Class RequestHeaderFields

java.lang.Object

java.util.AbstractMap<String, List<String>>

java.util.HashMap<String, List<String>>

org.refcodes.web.AbstractHttpFields<RequestHeaderFields>

org.refcodes.web.AbstractHeaderFields<RequestCookie, RequestHeaderFields>

org.refcodes.web.RequestHeaderFields

All Implemented Interfaces:

Serializable, Cloneable, Map<String, List<String>>, HeaderFields<RequestCookie, RequestHeaderFields>, HttpFields<RequestHeaderFields>

public class RequestHeaderFields
extends AbstractHeaderFields<RequestCookie, RequestHeaderFields>

The RequestHeaderFields reflect the structure of a HTTP-Header and may be used to represent a HTTP-Header.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface Map

Map.Entry<K,V>

Field Summary

Fields inherited from interface HeaderFields

BASIC_REALM

Constructor Summary

Constructors

Constructor	Description
RequestHeaderFields()	Instantiates a new request Header-Fields impl.
RequestHeaderFields(Map<String, List<String>> aFromHeaderFields)	Instantiates the class RequestHeaderFields.

Method Summary

Modifier and Type	Method	Description
RequestCookie	addCookie(String aHttpCookie)	Adds an individual server-side cookie to be sent to the client to this ResponseHeaderFields instance.
protected RequestCookie	createCookie(String aHttpCookie)	Creates a Cookie from the given HTTP cookie String as retrieved from the according Header-Field.
protected RequestCookie	createCookie(String aCookieName, String aValue)	Creates a plain Cookie with the given name and value.
protected String	getCookieFieldName()	The Header-Field name for the Cookie elements.

Methods inherited from class AbstractHeaderFields

addCookie, addCookie, addTo, entrySet, get, getAllCookies, isCommaSeparatedHeaderField, keySet, put, putAll, toHeaderField, toHeaderFields

Methods inherited from class AbstractHttpFields

copyHttpFields

Methods inherited from class HashMap

clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, forEach, getOrDefault, isEmpty, merge, newHashMap, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Methods inherited from class AbstractMap

equals, hashCode, toString

Methods inherited from class Object

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

Methods inherited from interface HeaderFields

addTo, addTo, addTo, get, getAcceptCharsets, getAcceptEncodings, getAcceptLanguages, getAcceptTypes, getAllowMethods, getAuthenticate, getAuthorization, getBasicAuth, getBasicAuthCredentials, getBearerAuthCredentials, getContentEncoding, getContentLength, getContentType, getCookies, getFirst, getFirstCookie, getHost, getRequestId, getSessionId, getUnknownAcceptTypes, getUnknownContentTypes, getUserAgent, put, put, put, putAcceptCharsets, putAcceptCharsets, putAcceptEncodings, putAcceptEncodings, putAcceptLanguages, putAcceptLanguages, putAcceptTypes, putAcceptTypes, putAllowMethods, putAllowMethods, putAuthenticate, putAuthorization, putAuthorization, putAuthorization, putBasicAuthCredentials, putBasicAuthCredentials, putBasicAuthRequired, putBearerAuthCredentials, putBearerAuthCredentials, putContentEncoding, putContentLength, putContentType, putContentType, putHost, putRequestId, putSessionId, putUserAgent, remove, removeAcceptCharsets, removeAcceptEncodings, removeAcceptLanguages, removeAcceptTypes, removeAllowMethods, removeAuthenticate, removeAuthorization, removeBasicAuthCredentials, removeBasicAuthenticate, removeBearerAuthCredentials, removeContentEncoding, removeContentLength, removeContentType, removeHost, removeRequestId, removeSessionId, removeUserAgent, toBasicAuthRealm, toHeaderFields, toHttpCookies, withAcceptCharsets, withAcceptCharsets, withAcceptEncodings, withAcceptEncodings, withAcceptLanguages, withAcceptLanguages, withAcceptTypes, withAcceptTypes, withAddCookie, withAddCookie, withAddTo, withAddTo, withAddTo, withAllowMethods, withAllowMethods, withAuthenticate, withAuthorization, withAuthorization, withAuthorization, withBasicAuthCredentials, withBasicAuthCredentials, withBasicAuthRequired, withBearerAuthCredentials, withBearerAuthCredentials, withContentEncoding, withContentLength, withContentType, withContentType, withHost, withPut, withPut, withPut, withRequestId, withSessionId, withUserAgent

Methods inherited from interface HttpFields

addAll, addTo, addTo, addTo, addTo, addTo, getFirst, getFirst, put, put, put, put, toField, toField, withAddTo, withAddTo, withAddTo, withAddTo, withAddTo, withAddTo, withPut, withPut, withPut, withPut, withPut, withPut

Methods inherited from interface Map

clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, equals, forEach, getOrDefault, hashCode, isEmpty, merge, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Constructor Details

RequestHeaderFields

public RequestHeaderFields()

Instantiates a new request Header-Fields impl.

RequestHeaderFields

public RequestHeaderFields(Map<String, List<String>> aFromHeaderFields)

Instantiates the class RequestHeaderFields.

See Also:

• AbstractHeaderFields(Map<String,List<String>>)

Method Details

addCookie

public RequestCookie addCookie(String aHttpCookie)

Adds an individual server-side cookie to be sent to the client to this ResponseHeaderFields instance. The server-side cookies are retrieved from the HeaderField.SET_COOKIE Header-Field. WITH THE METHOD HeaderFields.getAllCookies() and HeaderFields.getCookies(String) as well as HeaderFields.getFirstCookie(String) ONLY THE COOKIES SENT BY THE CLIENT CAN BE RETRIEVED (E.G. COOKIES RESIDING IN THE DOCUMENT_HEADER FIELD HeaderField.COOKIE). COOKIES SET VIA HeaderFields.addCookie(String, String) OR HeaderFields.withAddCookie(String, String) CANNOT BE RETRIEVED, AS THE COOKIES BEING SET SERVER-SIDE ARE PUT IN THE HeaderField.SET_COOKIE Header-Field.

Parameters:

aHttpCookie - The HTTP-Cookie String to be paresd as a cookie.

Returns:

The resulting cookie builder being added which can be modified affecting(!) this ResponseHeaderFields instance!

getCookieFieldName

protected String getCookieFieldName()

The Header-Field name for the Cookie elements. The Header-Field name differs from the context, e.g. when setting a Cookie server-side or when retrieving a Cookie client-side.

Specified by:

getCookieFieldName in class AbstractHeaderFields<RequestCookie, RequestHeaderFields>

Returns:

The Header-Field where the Cookie elements are stored.

createCookie

protected RequestCookie createCookie(String aCookieName,
 String aValue)

Creates a plain Cookie with the given name and value.

Specified by:

createCookie in class AbstractHeaderFields<RequestCookie, RequestHeaderFields>

Parameters:

aCookieName - The name of the Cookie.

aValue - The value for the Cookie

Returns:

The Cookie with the given name and value.

createCookie

protected RequestCookie createCookie(String aHttpCookie)

Creates a Cookie from the given HTTP cookie String as retrieved from the according Header-Field.

Specified by:

createCookie in class AbstractHeaderFields<RequestCookie, RequestHeaderFields>

Parameters:

aHttpCookie - The text of the Header-Field for the cookie to be created.

Returns:

The Cookie with the given cookie properties.