Package org.refcodes.net

Interface HeaderFields<C extends Cookie,B extends HeaderFields<C,B>>

    • Method Detail

      • getAllowMethods

        default java.util.List<HttpMethod> getAllowMethods()
        Gets the Allow entity-Header-Field HeaderField.ALLOW: "... The Allow entity-Header-Field lists the set of methods supported by the resource ... The purpose of this field is strictly to inform the recipient of valid methods associated with the resource. An Allow header field MUST be present in a 405 (Method Not Allowed) response ..."
        Returns:
        The HTTP-Methods allowed for the resource.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putAllowMethods

        default java.util.List<HttpMethod> putAllowMethods​(HttpMethod... aHttpMethods)
        Sets the Allow entity-Header-Field HeaderField.ALLOW: "... The Allow entity-Header-Field lists the set of methods supported by the resource ... The purpose of this field is strictly to inform the recipient of valid methods associated with the resource. An Allow header field MUST be present in a 405 (Method Not Allowed) response ..."
        Parameters:
        aHttpMethods - The HTTP-Methods allowed for the resource.
        Returns:
        The replaced element (if any, else null).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putAllowMethods

        default java.util.List<HttpMethod> putAllowMethods​(java.util.List<HttpMethod> aHttpMethods)
        Sets the Allow entity-Header-Field HeaderField.ALLOW: "... The Allow entity-Header-Field lists the set of methods supported by the resource ... The purpose of this field is strictly to inform the recipient of valid methods associated with the resource. An Allow header field MUST be present in a 405 (Method Not Allowed) response ..."
        Parameters:
        aHttpMethods - The HTTP-Methods allowed for the resource.
        Returns:
        The replaced element (if any, else null).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withAllowMethods

        default B withAllowMethods​(HttpMethod... aHttpMethods)
        Sets the Allow entity-Header-Field HeaderField.ALLOW: "... The Allow entity-Header-Field lists the set of methods supported by the resource ... The purpose of this field is strictly to inform the recipient of valid methods associated with the resource. An Allow header field MUST be present in a 405 (Method Not Allowed) response ..."
        Parameters:
        aHttpMethods - The HTTP-Methods allowed for the resource.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withAllowMethods

        default B withAllowMethods​(java.util.List<HttpMethod> aHttpMethods)
        Sets the Allow entity-Header-Field HeaderField.ALLOW: "... The Allow entity-Header-Field lists the set of methods supported by the resource ... The purpose of this field is strictly to inform the recipient of valid methods associated with the resource. An Allow header field MUST be present in a 405 (Method Not Allowed) response ..."
        Parameters:
        aHttpMethods - The HTTP-Methods allowed for the resource.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • removeAllowMethods

        default java.util.List<HttpMethod> removeAllowMethods()
        Removes the Allow entity-Header-Field HeaderField.ALLOW: "... The Allow entity-Header-Field lists the set of methods supported by the resource ... The purpose of this field is strictly to inform the recipient of valid methods associated with the resource. An Allow header field MUST be present in a 405 (Method Not Allowed) response ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getContentType

        default ContentType getContentType()
        Gets the Content-Type entity-Header-Field HeaderField.CONTENT_TYPE: "... The Content-Type entity-Header-Field indicates the media type of the entity-body sent to the recipient ..."
        Returns:
        The media type being used for the body.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getUnknownContentTypes

        default java.util.List<java.lang.String> getUnknownContentTypes()
        Gets the unresolvable (unknown) Content-Type request-Header-Field HeaderField.CONTENT_TYPE. E.g. the ones which cannot be mapped by the enumeration MediaType.
        Returns:
        the unknown content types
        See Also:
        getContentType()

      • putContentType

        default ContentType putContentType​(HttpMediaType aHttpMediaType)
        Sets the Content-Type entity-Header-Field HeaderField.CONTENT_TYPE. You may pass a MediaType or a ContentType instance as them both implement the HttpMediaTypeAccessor.HttpMediaTypeProvider interface: "... The Content-Type entity-Header-Field indicates the media type of the entity-body sent to the recipient ..."
        Parameters:
        aHttpMediaType - The media type used for the body.
        Returns:
        The replaced element (if any, else null).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putContentType

        default ContentType putContentType​(MediaType aMediaType,
                                   java.util.Map<java.lang.String,java.lang.String> aParameters)
        Sets the Content-Type entity-Header-Field HeaderField.CONTENT_TYPE. : "... The Content-Type entity-Header-Field indicates the media type of the entity-body sent to the recipient ..."
        Parameters:
        aMediaType - The media type used for the body.
        aParameters - The Content-Type's parameters.
        Returns:
        The replaced element (if any, else null).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withContentType

        default B withContentType​(HttpMediaType aHttpMediaType)
        Sets the Content-Type entity-Header-Field HeaderField.CONTENT_TYPE. You may pass a MediaType or a ContentType instance as them both implement the HttpMediaTypeAccessor.HttpMediaTypeProvider interface: "... The Content-Type entity-Header-Field indicates the media type of the entity-body sent to the recipient ..."
        Parameters:
        aHttpMediaType - The media type used for the body.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withContentType

        default B withContentType​(MediaType aMediaType,
                          java.util.Map<java.lang.String,java.lang.String> aParameters)
        Sets the Content-Type's MediaType and the parameters for the HTTP body.
        Parameters:
        aMediaType - The media type used for the body.
        aParameters - The Content-Type's parameters.
        Returns:
        This object as of the Builder-Pattern.

      • removeContentType

        default ContentType removeContentType()
        Removes the Content-Type entity-Header-Field HeaderField.CONTENT_TYPE. : "... The Content-Type entity-Header-Field indicates the media type of the entity-body sent to the recipient ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getAcceptTypes

        default java.util.List<ContentType> getAcceptTypes()
        Gets the Accept request-Header-Field HeaderField.ACCEPT: "... The Accept request-Header-Field can be used to specify certain media types which are acceptable for the response. Accept headers can be used to indicate that the request is specifically limited to a small set of desired ..."
        Returns:
        The expected (supported) kinds of MediaType and the according parameters (being actually instances of the ContentType type).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getUnknownAcceptTypes

        default java.util.List<java.lang.String> getUnknownAcceptTypes()
        Gets the unresolvable (unknown) Accept request-Header-Field HeaderField.ACCEPT. E.g. the ones which cannot be mapped by the enumeration MediaType.
        Returns:
        the unknown accept types
        See Also:
        getAcceptTypes()

      • putAcceptTypes

        default java.util.List<ContentType> putAcceptTypes​(java.util.List<? extends HttpMediaType> aHttpMediaTypes)
        Sets the Accept request-Header-Field HeaderField.ACCEPT. You may pass a MediaType or a ContentType instance as them both implement the HttpMediaTypeAccessor.HttpMediaTypeProvider interface: "... The Accept request-Header-Field can be used to specify certain media types which are acceptable for the response. Accept headers can be used to indicate that the request is specifically limited to a small set of desired types ..."
        Parameters:
        aHttpMediaTypes - The according HttpMediaTypeAccessor.HttpMediaTypeProvider.
        Returns:
        The replaced element (if any, else null).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withAcceptTypes

        default B withAcceptTypes​(HttpMediaType... aHttpMediaType)
        Sets the Accept request-Header-Field HeaderField.ACCEPT. You may pass a MediaType or a ContentType instance as them both implement the HttpMediaTypeAccessor.HttpMediaTypeProvider interface: "... The Accept request-Header-Field can be used to specify certain media types which are acceptable for the response. Accept headers can be used to indicate that the request is specifically limited to a small set of desired types ..."
        Parameters:
        aHttpMediaType - The according HttpMediaTypeAccessor.HttpMediaTypeProvider.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withAcceptTypes

        default B withAcceptTypes​(java.util.List<? extends HttpMediaType> aHttpMediaType)
        Sets the Accept request-Header-Field HeaderField.ACCEPT. You may pass a MediaType or a ContentType instance as them both implement the HttpMediaTypeAccessor.HttpMediaTypeProvider interface: "... The Accept request-Header-Field can be used to specify certain media types which are acceptable for the response. Accept headers can be used to indicate that the request is specifically limited to a small set of desired types ..."
        Parameters:
        aHttpMediaType - The according HttpMediaTypeAccessor.HttpMediaTypeProvider.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • removeAcceptTypes

        default java.util.List<ContentType> removeAcceptTypes()
        Removes the Accept request-Header-Field HeaderField.ACCEPT: "... The Accept request-Header-Field can be used to specify certain media types which are acceptable for the response. Accept headers can be used to indicate that the request is specifically limited to a small set of desired types ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getAcceptCharsets

        default java.util.List<java.lang.String> getAcceptCharsets()
        Gets the Accept-Charset request-Header-Field HeaderField.ACCEPT_CHARSET. "... The Accept-Charset request-Header-Field can be used to indicate what character sets are acceptable for the response. This field allows clients capable of understanding more comprehensive or special- purpose character sets to signal that capability to a server which is capable of representing documents in those character sets ..."
        Returns:
        The Accept-Charset expected by a client from a server.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putAcceptCharsets

        default java.util.List<java.lang.String> putAcceptCharsets​(java.lang.String... aAcceptCharsets)
        Sets the Accept-Charset request-Header-Field HeaderField.ACCEPT_CHARSET. "... The Accept-Charset request-Header-Field can be used to indicate what character sets are acceptable for the response. This field allows clients capable of understanding more comprehensive or special- purpose character sets to signal that capability to a server which is capable of representing documents in those character sets ..."
        Parameters:
        aAcceptCharsets - The Accept-Charset expected by a client from a server.
        Returns:
        The replaced elements (if any, else null).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putAcceptCharsets

        default java.util.List<java.lang.String> putAcceptCharsets​(java.util.List<java.lang.String> aAcceptCharsets)
        Sets the Accept-Charset request-Header-Field HeaderField.ACCEPT_CHARSET. "... The Accept-Charset request-Header-Field can be used to indicate what character sets are acceptable for the response. This field allows clients capable of understanding more comprehensive or special- purpose character sets to signal that capability to a server which is capable of representing documents in those character sets ..."
        Parameters:
        aAcceptCharsets - The Accept-Charset expected by a client from a server.
        Returns:
        The replaced elements (if any, else null).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withAcceptCharsets

        default B withAcceptCharsets​(java.util.List<java.lang.String> aAcceptCharsets)
        Sets the the Accept-Charset request-Header-Field HeaderField.ACCEPT_CHARSET. "... The Accept-Charset request-Header-Field can be used to indicate what character sets are acceptable for the response. This field allows clients capable of understanding more comprehensive or special- purpose character sets to signal that capability to a server which is capable of representing documents in those character sets ..."
        Parameters:
        aAcceptCharsets - The Accept-Charset expected by a client from a server.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withAcceptCharsets

        default B withAcceptCharsets​(java.lang.String... aAcceptCharsets)
        Sets the Accept-Charset request-Header-Field HeaderField.ACCEPT_CHARSET. "... The Accept-Charset request-Header-Field can be used to indicate what character sets are acceptable for the response. This field allows clients capable of understanding more comprehensive or special- purpose character sets to signal that capability to a server which is capable of representing documents in those character sets ..."
        Parameters:
        aAcceptCharsets - The Accept-Charset expected by a client from a server.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • removeAcceptCharsets

        default java.util.List<java.lang.String> removeAcceptCharsets()
        Removes the Accept-Charset request-Header-Field HeaderField.ACCEPT_CHARSET. "... The Accept-Charset request-Header-Field can be used to indicate what character sets are acceptable for the response. This field allows clients capable of understanding more comprehensive or special- purpose character sets to signal that capability to a server which is capable of representing documents in those character sets ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getAcceptEncodings

        default java.util.List<ContentEncoding> getAcceptEncodings()
        Gets the the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Returns:
        The expected (supported) kinds of encodings.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html", "https://developer.mozilla.org/de/docs/Web/HTTP/Headers/Content-Encoding"

      • putAcceptEncodings

        default java.util.List<ContentEncoding> putAcceptEncodings​(ContentEncoding... aEncodings)
        Sets the the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Parameters:
        aEncodings - The according encodings.
        Returns:
        the list
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html", "https://developer.mozilla.org/de/docs/Web/HTTP/Headers/Content-Encoding"

      • putAcceptEncodings

        default java.util.List<ContentEncoding> putAcceptEncodings​(java.util.List<ContentEncoding> aEncodings)
        Sets the the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Parameters:
        aEncodings - The according encodings.
        Returns:
        the list
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html", "https://developer.mozilla.org/de/docs/Web/HTTP/Headers/Content-Encoding"

      • withAcceptEncodings

        default B withAcceptEncodings​(ContentEncoding... aEncodings)
        Sets the the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Parameters:
        aEncodings - The according encodings.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html", "https://developer.mozilla.org/de/docs/Web/HTTP/Headers/Content-Encoding"

      • withAcceptEncodings

        default B withAcceptEncodings​(java.util.List<ContentEncoding> aEncodings)
        Sets the the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Parameters:
        aEncodings - The according encodings.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html", "https://developer.mozilla.org/de/docs/Web/HTTP/Headers/Content-Encoding"

      • removeAcceptEncodings

        default java.util.List<ContentEncoding> removeAcceptEncodings()
        Removes the the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getContentEncoding

        default ContentEncoding getContentEncoding()
        Gets the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Returns:
        The communication partner's HTTP body's encoding.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putContentEncoding

        default ContentEncoding putContentEncoding​(ContentEncoding aEncoding)
        Sets the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Parameters:
        aEncoding - The HTTP body's content encoding.
        Returns:
        the content encoding
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withContentEncoding

        default B withContentEncoding​(ContentEncoding aEncoding)
        Sets the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Parameters:
        aEncoding - The HTTP body's content encoding.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • removeContentEncoding

        default ContentEncoding removeContentEncoding()
        Removes the Content-Encoding entity-Header-Field HeaderField.CONTENT_ENCODING: "... The Content-Encoding entity-Header-Field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type Header-Field. Content-Encoding is primarily used to allow a document to be compressed without losing the identity of its underlying media type ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getUserAgent

        default java.lang.String getUserAgent()
        Gets the User-Agent request-Header-Field HeaderField.USER_AGENT: "... The User-Agent request-Header-Field contains information about the user agent originating the request. This is for statistical purposes, the tracing of protocol violations, and automated recognition of user agents for the sake of tailoring responses to avoid particular user agent limitations. User agents SHOULD include this field with requests ..."
        Returns:
        The according user agent.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putUserAgent

        default java.lang.String putUserAgent​(java.lang.String aUserAgent)
        Sets the User-Agent request-Header-Field HeaderField.USER_AGENT: "... The User-Agent request-Header-Field contains information about the user agent originating the request. This is for statistical purposes, the tracing of protocol violations, and automated recognition of user agents for the sake of tailoring responses to avoid particular user agent limitations. User agents SHOULD include this field with requests ..."
        Parameters:
        aUserAgent - The according user agent.
        Returns:
        the string
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withUserAgent

        default B withUserAgent​(java.lang.String aUserAgent)
        Sets he User-Agent request-Header-Field HeaderField.USER_AGENT: "... The User-Agent request-Header-Field contains information about the user agent originating the request. This is for statistical purposes, the tracing of protocol violations, and automated recognition of user agents for the sake of tailoring responses to avoid particular user agent limitations. User agents SHOULD include this field with requests ..."
        Parameters:
        aUserAgent - The according user agent.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • removeUserAgent

        default java.lang.String removeUserAgent()
        Removes he User-Agent request-Header-Field HeaderField.USER_AGENT : "... The User-Agent request-Header-Field contains information about the user agent originating the request. This is for statistical purposes, the tracing of protocol violations, and automated recognition of user agents for the sake of tailoring responses to avoid particular user agent limitations. User agents SHOULD include this field with requests ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getHost

        default java.lang.String getHost()
        Gets the Host request-Header-Field HeaderField.HOST: "... The Host request-Header-Field specifies the Internet host and port number of the resource being requested, as obtained from the original URI given by the user or referring resource ..."
        Returns:
        The according host.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putHost

        default java.lang.String putHost​(java.lang.String aHost)
        Sets the Host request-Header-Field HeaderField.HOST: "... The Host request-Header-Field specifies the Internet host and port number of the resource being requested, as obtained from the original URI given by the user or referring resource ..."
        Parameters:
        aHost - The according host.
        Returns:
        the string
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withHost

        default B withHost​(java.lang.String aHost)
        Sets the Host request-Header-Field HeaderField.HOST: "... The Host request-Header-Field specifies the Internet host and port number of the resource being requested, as obtained from the original URI given by the user or referring resource ..."
        Parameters:
        aHost - The according host.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • removeHost

        default java.lang.String removeHost()
        Removes the Host request-Header-Field HeaderField.HOST: "... The Host request-Header-Field specifies the Internet host and port number of the resource being requested, as obtained from the original URI given by the user or referring resource ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getRequestId

        default java.lang.String getRequestId()
        Gets the (interprocess) Request-Correlation ID field HeaderField.REQUEST_ID: A Request-Correlation ID is an ID to uniquely identify an entity (request) across multiple systems.
        Returns:
        The according Request-Correlation ID.

      • putRequestId

        default java.lang.String putRequestId​(java.lang.String aRequestId)
        Sets the (interprocess) Request-Correlation ID field HeaderField.REQUEST_ID: A Request-Correlation ID is an ID to uniquely identify an entity (request) across multiple systems.
        Parameters:
        aRequestId - The according Request-Correlation ID.
        Returns:
        The value being removed (or null if none was set).

      • withRequestId

        default B withRequestId​(java.lang.String aRequestId)
        Sets the (interprocess) Request-Correlation ID field HeaderField.REQUEST_ID: A Request-Correlation ID is an ID to uniquely identify an entity (request) across multiple systems.
        Parameters:
        aRequestId - The according Request-Correlation ID.
        Returns:
        This object as of the Builder-Pattern.

      • removeRequestId

        default java.lang.String removeRequestId()
        Removes the (interprocess) Request-Correlation ID field HeaderField.REQUEST_ID: A Request-Correlation ID is an ID to uniquely identify an entity (request) across multiple systems.
        Returns:
        The value being removed (or null if none was set).

      • getSessionId

        default java.lang.String getSessionId()
        Gets the (interprocess) Session-Correlation ID field HeaderField.SESSION_ID: A Session-Correlation ID is an ID to uniquely identify an entity (session) across multiple systems.
        Returns:
        The according Session-Correlation ID.

      • putSessionId

        default java.lang.String putSessionId​(java.lang.String aSessionId)
        Sets the (interprocess) Session-Correlation ID field HeaderField.SESSION_ID: A Session-Correlation ID is an ID to uniquely identify an entity (session) across multiple systems.
        Parameters:
        aSessionId - The according Session-Correlation ID.
        Returns:
        The value being removed (or null if none was set).

      • withSessionId

        default B withSessionId​(java.lang.String aSessionId)
        Sets the (interprocess) Session-Correlation ID field HeaderField.SESSION_ID: A Session-Correlation ID is an ID to uniquely identify an entity (session) across multiple systems.
        Parameters:
        aSessionId - The according Session-Correlation ID.
        Returns:
        This object as of the Builder-Pattern.

      • removeSessionId

        default java.lang.String removeSessionId()
        Removes the (interprocess) Session-Correlation ID field HeaderField.SESSION_ID: A Session-Correlation ID is an ID to uniquely identify an entity (session) across multiple systems.
        Returns:
        The value being removed (or null if none was set).

      • getAuthenticate

        default java.lang.String getAuthenticate()
        Gets the WWW-Authenticate response-Header-Field HeaderField.WWW_AUTHENTICATE: "... The WWW-Authenticate response-Header-Field MUST be included in 401 (Unauthorized) response messages. The field value consists of at least one challenge that indicates the authentication scheme(s) and parameters applicable to the Request-URI ..."
        Returns:
        The according WWW-Authenticate field.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • putAuthenticate

        default java.lang.String putAuthenticate​(java.lang.String aAuthenticate)
        Sets the WWW-Authenticate response-Header-Field HeaderField.WWW_AUTHENTICATE: "... The WWW-Authenticate response-Header-Field MUST be included in 401 (Unauthorized) response messages. The field value consists of at least one challenge that indicates the authentication scheme(s) and parameters applicable to the Request-URI ..."
        Parameters:
        aAuthenticate - The according WWW-Authenticate field.
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • withAuthenticate

        default B withAuthenticate​(java.lang.String aAuthenticate)
        Sets the WWW-Authenticate response-Header-Field HeaderField.WWW_AUTHENTICATE: "... The WWW-Authenticate response-Header-Field MUST be included in 401 (Unauthorized) response messages. The field value consists of at least one challenge that indicates the authentication scheme(s) and parameters applicable to the Request-URI ..."
        Parameters:
        aAuthenticate - The according WWW-Authenticate field.
        Returns:
        This object as of the Builder-Pattern.
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • removeAuthenticate

        default java.lang.String removeAuthenticate()
        Removes the WWW-Authenticate response-Header-Field HeaderField.WWW_AUTHENTICATE: "... The WWW-Authenticate response-Header-Field MUST be included in 401 (Unauthorized) response messages. The field value consists of at least one challenge that indicates the authentication scheme(s) and parameters applicable to the Request-URI ..."
        Returns:
        The value being removed (or null if none was set).
        See Also:
        "https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html"

      • getBasicAuth

        default java.lang.String getBasicAuth()
        Retrieves the WWW-Authenticate field for Basic-Authentication. If not set or another kind of authorization is set, then null is returned. Use getAuthenticate() to get the field's value no matter which kind of authenticate is used.
        Returns:
        The WWW-Authenticate field for Basic-Authentication or null if there is no value for the given field or it does not declare Basic-Authentication.

      • putBasicAuthRequired

        default java.lang.String putBasicAuthRequired​(java.lang.String aRealm)
        Sets the WWW-Authenticate field for Basic-Authentication with the given realm.
        Parameters:
        aRealm - The realm to be set for Basic-Authentication of the WWW-authenticate field.
        Returns:
        The value being removed (or null if none was set).

      • withBasicAuthRequired

        default B withBasicAuthRequired​(java.lang.String aRealm)
        Sets the WWW-Authenticate field for Basic-Authentication with the given realm.
        Parameters:
        aRealm - The realm to be set for Basic-Authentication of the WWW-authenticate field.
        Returns:
        This object as of the Builder-Pattern.

      • removeBasicAuthenticate

        default java.lang.String removeBasicAuthenticate()
        Removes the WWW-Authenticate field for Basic-Authentication. If not set or another kind of authorization is set, then null is returned and the field is not removed. Use removeAuthenticate() to remove the field's value no matter which kind of authenticate is used.
        Returns:
        The value being removed (or null if none or none for basic authentication was set).

      • toBasicAuthRealm

        default java.lang.String toBasicAuthRealm()
        Extracts the real (if any) from the HeaderField.WWW_AUTHENTICATE Header-Field (getAuthenticate()).
        Returns:
        The basic authenticate's realm or null if there is none such.

      • removeBearerAuthCredentials

        default BearerAuthCredentials removeBearerAuthCredentials()
        Removes the BearerAuthCredentials (token) for HTTP bearer authentication.
        Returns:
        The value being removed (or null if none was set).

      • withBasicAuthCredentials

        default B withBasicAuthCredentials​(java.lang.String aUserName,
                                   java.lang.String aSecret)
        Sets the user name and secret (password) for HTTP Basic-Authentication.
        Specified by:
        withBasicAuthCredentials in interface BasicAuthCredentialsAccessor.BasicAuthCredentialsBuilder<C extends Cookie>
        Parameters:
        aUserName - The user name part of the credentials.
        aSecret - The password part of the credentials.
        Returns:
        This object as of the Builder-Pattern.

      • removeBasicAuthCredentials

        default BasicAuthCredentials removeBasicAuthCredentials()
        Removes the BasicAuthCredentials (user name and secret) for HTTP Basic-Authentication.
        Returns:
        The value being removed (or null if none was set).

      • get

        default java.util.List<java.lang.String> get​(HeaderField aHeaderField)
        Gets the values for the according Header-Field..
        Parameters:
        aHeaderField - The Header-Field
        Returns:
        The list of values.

      • getFirst

        default java.lang.String getFirst​(HeaderField aHeaderField)
        Gets the first value of the according Header-Field.
        Parameters:
        aHeaderField - The a Header-Field
        Returns:
        The first value.

      • addTo

        default void addTo​(HeaderField aHeaderField,
                   java.lang.String aValue)
        Adds the value to the given Header-Field.
        Parameters:
        aHeaderField - The Header-Field.
        aValue - The a value to be added.

      • withAddTo

        default HeaderFields<C,B> withAddTo​(HeaderField aHeaderField,
                                    java.lang.String aValue)
        Builder method for addTo(HeaderField, String).
        Parameters:
        aHeaderField - the Header-Field
        aValue - the value
        Returns:
        This instance as of the Builder-Pattern to chain operations.

      • addTo

        default void addTo​(HeaderField aHeaderField,
                   java.lang.String... aValues)
        Adds the given values to the according Header-Field.
        Parameters:
        aHeaderField - The Header-Field.
        aValues - The a values to be added.

      • addTo

        default void addTo​(HeaderField aHeaderField,
                   java.util.List<java.lang.String> aValues)
        Adds the given values to the according Header-Field.
        Parameters:
        aHeaderField - The Header-Field.
        aValues - The a values to be added.

      • withAddTo

        default HeaderFields<C,B> withAddTo​(HeaderField aHeaderField,
                                    java.lang.String... aValues)
        Builder method for addTo(HeaderField, String ...).
        Parameters:
        aHeaderField - the Header-Field
        aValues - the values
        Returns:
        This instance as of the Builder-Pattern to chain operations.

      • withAddTo

        default HeaderFields<C,B> withAddTo​(HeaderField aHeaderField,
                                    java.util.List<java.lang.String> aValues)
        Builder method for addTo(HeaderField, List).
        Parameters:
        aHeaderField - the Header-Field
        aValues - the values
        Returns:
        This instance as of the Builder-Pattern to chain operations.

      • put

        default java.util.List<java.lang.String> put​(HeaderField aHeaderField,
                                             java.lang.String aValue)
        Puts (replaces) the currently set Header-Field values with the provided one.
        Parameters:
        aHeaderField - The a Header-Field.
        aValue - The value with which to replace the currently set Header-Field values.
        Returns:
        The List with the previously set Header-Field values.

      • withPut

        default HeaderFields<C,B> withPut​(HeaderField aHeaderField,
                                  java.lang.String aValue)
        Builder method for put(HeaderField, String).
        Parameters:
        aHeaderField - The Header-Field.
        aValue - The value.
        Returns:
        This instance as of the Builder-Pattern to chain operations.

      • put

        default java.util.List<java.lang.String> put​(HeaderField aHeaderField,
                                             java.lang.String... aValues)
        Puts (replaces) the currently set Header-Field values with the provided ones.
        Parameters:
        aHeaderField - The a Header-Field.
        aValues - The values with which to replace the currently set Header-Field values.
        Returns:
        The List with the previously set Header-Field values.

      • put

        default java.util.List<java.lang.String> put​(HeaderField aHeaderField,
                                             java.util.List<java.lang.String> aValues)
        Puts (replaces) the currently set Header-Field values with the provided ones.
        Parameters:
        aHeaderField - The a Header-Field.
        aValues - The values with which to replace the currently set Header-Field values.
        Returns:
        The List with the previously set Header-Field values.

      • withPut

        default HeaderFields<C,B> withPut​(HeaderField aHeaderField,
                                  java.lang.String... aValues)
        Builder method for put(HeaderField, String ...).
        Parameters:
        aHeaderField - The Header-Field.
        aValues - The values.
        Returns:
        This instance as of the Builder-Pattern to chain operations.

      • withPut

        default HeaderFields<C,B> withPut​(HeaderField aHeaderField,
                                  java.util.List<java.lang.String> aValues)
        Builder method for put(HeaderField, List).
        Parameters:
        aHeaderField - The Header-Field.
        aValues - The values.
        Returns:
        This instance as of the Builder-Pattern to chain operations.

      • remove

        default java.util.List<java.lang.String> remove​(HeaderField aHeaderField)
        Removes the values from the given Header-Field.
        Parameters:
        aHeaderField - The a Header-Field for which to remove the values.
        Returns:
        The List with the previously set Header-Field values.

      • toHttpCookies

        default java.lang.String[] toHttpCookies()
        Creates a HTTP Header-Field value from the herein stored Cookie instances.
        Returns:
        The text representing the HTTP Header-Field for the herein stored cookies.

      • toHeaderFields

        default void toHeaderFields​(java.util.Map<java.lang.String,java.util.List<java.lang.String>> aToFields)
        Copies the Header-Fields into the provided Map. This is useful when some underlying system provides an own instance of Header-Fields to be filled.
        Parameters:
        aToFields - The Map where to copy the Header-Fields to.