java.lang.Object
java.util.AbstractMap<K,V>
java.util.HashMap<String,List<String>>
org.refcodes.web.AbstractHttpFields<T>
org.refcodes.web.AbstractHeaderFields<ResponseCookie,ResponseHeaderFields>
org.refcodes.web.ResponseHeaderFields
- All Implemented Interfaces:
Serializable
,Cloneable
,Map<String,
,List<String>> HeaderFields<ResponseCookie,
,ResponseHeaderFields> HttpFields<ResponseHeaderFields>
public class ResponseHeaderFields
extends AbstractHeaderFields<ResponseCookie,ResponseHeaderFields>
implements HeaderFields<ResponseCookie,ResponseHeaderFields>
The
ResponseHeaderFields
reflect the structure of a HTTP header and
may be used to represent a HTTP header.- See Also:
-
Nested Class Summary
Nested classes/interfaces inherited from class java.util.AbstractMap
AbstractMap.SimpleEntry<K extends Object,
V extends Object>, AbstractMap.SimpleImmutableEntry<K extends Object, V extends Object> -
Field Summary
Fields inherited from interface org.refcodes.web.HeaderFields
BASIC_REALM
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionAdds an individual server-side cookie to be sent to the client to thisResponseHeaderFields
instance.protected ResponseCookie
createCookie
(String aHttpCookie) protected ResponseCookie
createCookie
(String aCookieName, String aValue) Creates a plainCookie
with the given name and value.protected String
The Header-Field name for theCookie
elements.Gets the Location Response-Header-FieldHeaderField.LOCATION
: "...putLocation
(String aLocation) Sets the Location Response-Header-FieldHeaderField.LOCATION
: "...Removes the Location Response-Header-FieldHeaderField.LOCATION
: "...witAddCookie
(String aHttpCookie) Builder method forwithAddCookie(ResponseCookie)
withAddCookie
(ResponseCookie aCookie) Builder method for theHeaderFields.addCookie(Cookie)
method.withLocation
(String aLocation) Sets the Location Response-Header-FieldHeaderField.LOCATION
: "...Methods inherited from class org.refcodes.web.AbstractHeaderFields
addCookie, addCookie, addTo, entrySet, get, getAllCookies, isCommaSeparatedHeaderField, keySet, put, putAll, toHeaderField, toHeaderFields
Methods inherited from class org.refcodes.web.AbstractHttpFields
copyHttpFields
Methods inherited from class java.util.HashMap
clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, forEach, getOrDefault, isEmpty, merge, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
Methods inherited from class java.util.AbstractMap
equals, hashCode, toString
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
Methods inherited from interface org.refcodes.web.HeaderFields
addCookie, addCookie, addTo, addTo, addTo, get, getAcceptCharsets, getAcceptEncodings, getAcceptLanguages, getAcceptTypes, getAllCookies, 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, 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 org.refcodes.web.HttpFields
addTo, 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 java.util.Map
clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
-
Constructor Details
-
ResponseHeaderFields
public ResponseHeaderFields()
-
-
Method Details
-
addCookie
Adds an individual server-side cookie to be sent to the client to thisResponseHeaderFields
instance. The server-side cookies are retrieved from theHeaderField.SET_COOKIE
Header-Field. WITH THE METHODHeaderFields.getAllCookies()
andHeaderFields.getCookies(String)
as well asHeaderFields.getFirstCookie(String)
ONLY THE COOKIES SENT BY THE CLIENT CAN BE RETRIEVED (E.G. COOKIES RESIDING IN THE HEADER FIELDHeaderField.COOKIE
). COOKIES SET VIAHeaderFields.addCookie(String, String)
ORHeaderFields.withAddCookie(String, String)
CANNOT BE RETRIEVED, AS THE COOKIES BEING SET SERVER-SIDE ARE PUT IN THEHeaderField.SET_COOKIE
Header-Field.- Specified by:
addCookie
in interfaceHeaderFields<ResponseCookie,
ResponseHeaderFields> - Parameters:
aHttpCookie
- The HTTP-CookieString
to be paresd as a cookie.- Returns:
- The resulting cookie builder being added which can be modified
affecting(!) this
ResponseHeaderFields
instance!
-
witAddCookie
Builder method forwithAddCookie(ResponseCookie)
- Parameters:
aHttpCookie
- The cookie to be added.- Returns:
- The implementing instance as of the builder pattern.
-
withAddCookie
Builder method for theHeaderFields.addCookie(Cookie)
method. WITH THE METHODHeaderFields.getAllCookies()
andHeaderFields.getCookies(String)
as well asHeaderFields.getFirstCookie(String)
ONLY THE COOKIES SENT BY THE CLIENT CAN BE RETRIEVED (E.G. COOKIES RESIDING IN THE HEADER FIELDHeaderField.COOKIE
). COOKIES SET VIAHeaderFields.addCookie(String, String)
ORHeaderFields.withAddCookie(String, String)
CANNOT BE RETRIEVED, AS THE COOKIES BEING SET SERVER-SIDE ARE PUT IN THEHeaderField.SET_COOKIE
Header-Field.- Specified by:
withAddCookie
in interfaceHeaderFields<ResponseCookie,
ResponseHeaderFields> - Parameters:
aCookie
- The cookie to be added.- Returns:
- This
ResponseHeaderFields
instance to continue building up the Header-Fields.
-
getLocation
Gets the Location Response-Header-FieldHeaderField.LOCATION
: "... The Location response-header field is used to redirect the recipient to a location other than the Request-URI for completion of the request or identification of a new resource. For 201 (Created) responses, the Location is that of the new resource which was created by the request. For 3xx responses, the location SHOULD indicate the server's preferred URI for automatic redirection to the resource. The field value consists of a single absolute URI. ..." -
putLocation
Sets the Location Response-Header-FieldHeaderField.LOCATION
: "... The Location response-header field is used to redirect the recipient to a location other than the Request-URI for completion of the request or identification of a new resource. For 201 (Created) responses, the Location is that of the new resource which was created by the request. For 3xx responses, the location SHOULD indicate the server's preferred URI for automatic redirection to the resource. The field value consists of a single absolute URI. types ..."- Parameters:
aLocation
- The according location.- Returns:
- The replaced element (if any, else null).
- See Also:
-
- "https://tools.ietf.org/html/rfc2616#page-135"
-
withLocation
Sets the Location Response-Header-FieldHeaderField.LOCATION
: "... The Location response-header field is used to redirect the recipient to a location other than the Request-URI for completion of the request or identification of a new resource. For 201 (Created) responses, the Location is that of the new resource which was created by the request. For 3xx responses, the location SHOULD indicate the server's preferred URI for automatic redirection to the resource. The field value consists of a single absolute URI. types ..."- Parameters:
aLocation
- The according location.- Returns:
- This object as of the Builder-Pattern.
- See Also:
-
- "https://tools.ietf.org/html/rfc2616#page-135"
-
removeLocation
Removes the Location Response-Header-FieldHeaderField.LOCATION
: "... The Location response-header field is used to redirect the recipient to a location other than the Request-URI for completion of the request or identification of a new resource. For 201 (Created) responses, the Location is that of the new resource which was created by the request. For 3xx responses, the location SHOULD indicate the server's preferred URI for automatic redirection to the resource. The field value consists of a single absolute URI. types ..."- Returns:
- The value being removed (or null if none was set).
- See Also:
-
- "https://tools.ietf.org/html/rfc2616#page-135"
-
getCookieFieldName
The Header-Field name for theCookie
elements. The Header-Field name differs from the context, e.g. when setting aCookie
server-side or when retrieving aCookie
client-side.- Specified by:
getCookieFieldName
in classAbstractHeaderFields<ResponseCookie,
ResponseHeaderFields> - Returns:
- The Header-Field where the
Cookie
elements are stored.
-
createCookie
Creates a plainCookie
with the given name and value.- Specified by:
createCookie
in classAbstractHeaderFields<ResponseCookie,
ResponseHeaderFields> - Parameters:
aCookieName
- The name of theCookie
.aValue
- The value for theCookie
- Returns:
- The
Cookie
with the given name and value.
-
createCookie
- Specified by:
createCookie
in classAbstractHeaderFields<ResponseCookie,
ResponseHeaderFields> - Parameters:
aHttpCookie
- The text of the Header-Field for the cookie to be created.- Returns:
- The
Cookie
with the given cookie properties.
-