jakarta.ws.rs/jakarta.ws.rs-api/3.0.0 : jakarta/ws/rs/core/HttpHeaders.java

HttpHeaders
https://github.com/eclipse-ee4j/jaxrs-api: Jakarta RESTful Web Services (Eclipse Foundation)
JAX-RS API Developers
/*
 * Copyright (c) 2010, 2019 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0, which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception, which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 */

package jakarta.ws.rs.core;

import java.util.Date;
import java.util.List;
import java.util.Locale;
import java.util.Map;

An injectable interface that provides access to HTTP header information. All methods throw IllegalStateException if called outside the scope of a request (e.g. from a provider constructor). 
Author: Paul Sandoz, Marc Hadley
See Also: Context
Since: 1.0/**
 * An injectable interface that provides access to HTTP header information. All methods throw
 * {@link java.lang.IllegalStateException} if called outside the scope of a request (e.g. from a provider constructor).
 *
 * @author Paul Sandoz
 * @author Marc Hadley
 * @see Context
 * @since 1.0
 */
public interface HttpHeaders {

    Get the values of a HTTP request header. The returned List is read-only. This is a shortcut for getRequestHeaders().get(name). 
Params: name – the header name, case insensitive.
Throws: IllegalStateException – if called outside the scope of a request.
Returns: a read-only list of header values./**
     * Get the values of a HTTP request header. The returned List is read-only. This is a shortcut for
     * {@code getRequestHeaders().get(name)}.
     *
     * @param name the header name, case insensitive.
     * @return a read-only list of header values.
     * @throws java.lang.IllegalStateException if called outside the scope of a request.
     */
    public List<String> getRequestHeader(String name);

    
Get a HTTP header as a single string value.
 Each single header value is converted to String using a HeaderDelegate if one is available via RuntimeDelegate.createHeaderDelegate(Class<Object>) for the header value class or using its toString method if a header delegate is not available. 
Params: name – the HTTP header.
See Also: getRequestHeader(String)
Returns: the HTTP header value. If the HTTP header is not present then null is returned. If the HTTP header is present but has no value then the empty string is returned. If the HTTP header is present more than once then the values of joined together and separated by a ',' character.
Since: 2.0/**
     * <p>
     * Get a HTTP header as a single string value.
     * </p>
     * Each single header value is converted to String using a {@link jakarta.ws.rs.ext.RuntimeDelegate.HeaderDelegate} if one
     * is available via {@link jakarta.ws.rs.ext.RuntimeDelegate#createHeaderDelegate(java.lang.Class)} for the header value
     * class or using its {@code toString} method if a header delegate is not available.
     *
     * @param name the HTTP header.
     * @return the HTTP header value. If the HTTP header is not present then {@code null} is returned. If the HTTP header is
     * present but has no value then the empty string is returned. If the HTTP header is present more than once then the
     * values of joined together and separated by a ',' character.
     * @see #getRequestHeader(java.lang.String)
     * @since 2.0
     */
    public String getHeaderString(String name);

    Get the values of HTTP request headers. The returned Map is case-insensitive wrt. keys and is read-only. The method never returns null. 
Throws: IllegalStateException – if called outside the scope of a request.
Returns: a read-only map of header names and values./**
     * Get the values of HTTP request headers. The returned Map is case-insensitive wrt. keys and is read-only. The method
     * never returns {@code null}.
     *
     * @return a read-only map of header names and values.
     * @throws java.lang.IllegalStateException if called outside the scope of a request.
     */
    public MultivaluedMap<String, String> getRequestHeaders();

    
Get a list of media types that are acceptable for the response.
 If no acceptable media types are specified, a read-only list containing a single wildcard media type instance is returned. 
Throws: IllegalStateException – if called outside the scope of a request.
Returns: a read-only list of requested response media types sorted according to their q-value, with highest preference
first./**
     * <p>
     * Get a list of media types that are acceptable for the response.
     * </p>
     * If no acceptable media types are specified, a read-only list containing a single
     * {@link jakarta.ws.rs.core.MediaType#WILDCARD_TYPE wildcard media type} instance is returned.
     *
     * @return a read-only list of requested response media types sorted according to their q-value, with highest preference
     * first.
     * @throws java.lang.IllegalStateException if called outside the scope of a request.
     */
    public List<MediaType> getAcceptableMediaTypes();

    
Get a list of languages that are acceptable for the response.
 If no acceptable languages are specified, a read-only list containing a single wildcard Locale instance (with language field set to "*") is returned. 
Throws: IllegalStateException – if called outside the scope of a request.
Returns: a read-only list of acceptable languages sorted according to their q-value, with highest preference first./**
     * <p>
     * Get a list of languages that are acceptable for the response.
     * </p>
     * If no acceptable languages are specified, a read-only list containing a single wildcard {@link java.util.Locale}
     * instance (with language field set to "{@code *}") is returned.
     *
     * @return a read-only list of acceptable languages sorted according to their q-value, with highest preference first.
     * @throws java.lang.IllegalStateException if called outside the scope of a request.
     */
    public List<Locale> getAcceptableLanguages();

    Get the media type of the request entity.
Throws: IllegalStateException – if called outside the scope of a request.
Returns: the media type or null if there is no request entity./**
     * Get the media type of the request entity.
     *
     * @return the media type or {@code null} if there is no request entity.
     * @throws java.lang.IllegalStateException if called outside the scope of a request.
     */
    public MediaType getMediaType();

    Get the language of the request entity.
Throws: IllegalStateException – if called outside the scope of a request.
Returns: the language of the entity or null if not specified./**
     * Get the language of the request entity.
     *
     * @return the language of the entity or {@code null} if not specified.
     * @throws java.lang.IllegalStateException if called outside the scope of a request.
     */
    public Locale getLanguage();

    Get any cookies that accompanied the request.
Throws: IllegalStateException – if called outside the scope of a request
Returns: a read-only map of cookie name (String) to Cookie./**
     * Get any cookies that accompanied the request.
     *
     * @return a read-only map of cookie name (String) to Cookie.
     * @throws java.lang.IllegalStateException if called outside the scope of a request
     */
    public Map<String, Cookie> getCookies();

    Get message date.
Returns: the message date, otherwise null if not present.
Since: 2.0/**
     * Get message date.
     *
     * @return the message date, otherwise {@code null} if not present.
     * @since 2.0
     */
    public Date getDate();

    Get Content-Length value.
Returns: Content-Length as integer if present and valid number. In other cases returns -1.
Since: 2.0/**
     * Get Content-Length value.
     *
     * @return Content-Length as integer if present and valid number. In other cases returns -1.
     * @since 2.0
     */
    public int getLength();

    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1">HTTP/1.1 documentation</a>.
     */
    public static final String ACCEPT = "Accept";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.2">HTTP/1.1 documentation</a>.
     */
    public static final String ACCEPT_CHARSET = "Accept-Charset";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.3">HTTP/1.1 documentation</a>.
     */
    public static final String ACCEPT_ENCODING = "Accept-Encoding";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4">HTTP/1.1 documentation</a>.
     */
    public static final String ACCEPT_LANGUAGE = "Accept-Language";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.7">HTTP/1.1 documentation</a>.
     */
    public static final String ALLOW = "Allow";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.8">HTTP/1.1 documentation</a>.
     */
    public static final String AUTHORIZATION = "Authorization";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">HTTP/1.1 documentation</a>.
     */
    public static final String CACHE_CONTROL = "Cache-Control";
    See IETF RFC-2183.
/**
     * See <a href="http://tools.ietf.org/html/rfc2183">IETF RFC-2183</a>.
     */
    public static final String CONTENT_DISPOSITION = "Content-Disposition";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11">HTTP/1.1 documentation</a>.
     */
    public static final String CONTENT_ENCODING = "Content-Encoding";
    See IETF RFC-2392.
/**
     * See <a href="http://tools.ietf.org/html/rfc2392">IETF RFC-2392</a>.
     */
    public static final String CONTENT_ID = "Content-ID";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.12">HTTP/1.1 documentation</a>.
     */
    public static final String CONTENT_LANGUAGE = "Content-Language";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13">HTTP/1.1 documentation</a>.
     */
    public static final String CONTENT_LENGTH = "Content-Length";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.14">HTTP/1.1 documentation</a>.
     */
    public static final String CONTENT_LOCATION = "Content-Location";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17">HTTP/1.1 documentation</a>.
     */
    public static final String CONTENT_TYPE = "Content-Type";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.18">HTTP/1.1 documentation</a>.
     */
    public static final String DATE = "Date";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.19">HTTP/1.1 documentation</a>.
     */
    public static final String ETAG = "ETag";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21">HTTP/1.1 documentation</a>.
     */
    public static final String EXPIRES = "Expires";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.23">HTTP/1.1 documentation</a>.
     */
    public static final String HOST = "Host";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.24">HTTP/1.1 documentation</a>.
     */
    public static final String IF_MATCH = "If-Match";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.25">HTTP/1.1 documentation</a>.
     */
    public static final String IF_MODIFIED_SINCE = "If-Modified-Since";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26">HTTP/1.1 documentation</a>.
     */
    public static final String IF_NONE_MATCH = "If-None-Match";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.28">HTTP/1.1 documentation</a>.
     */
    public static final String IF_UNMODIFIED_SINCE = "If-Unmodified-Since";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.29">HTTP/1.1 documentation</a>.
     */
    public static final String LAST_MODIFIED = "Last-Modified";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.30">HTTP/1.1 documentation</a>.
     */
    public static final String LOCATION = "Location";
    See Web Linking (IETF RFC-5988) documentation.
/**
     * See <a href="http://tools.ietf.org/html/rfc5988#page-6">Web Linking (IETF RFC-5988) documentation</a>.
     */
    public static final String LINK = "Link";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.37">HTTP/1.1 documentation</a>.
     */
    public static final String RETRY_AFTER = "Retry-After";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.43">HTTP/1.1 documentation</a>.
     */
    public static final String USER_AGENT = "User-Agent";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.44">HTTP/1.1 documentation</a>.
     */
    public static final String VARY = "Vary";
    See HTTP/1.1 documentation.
/**
     * See <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.47">HTTP/1.1 documentation</a>.
     */
    public static final String WWW_AUTHENTICATE = "WWW-Authenticate";
    See IETF RFC 2109.
/**
     * See <a href="http://www.ietf.org/rfc/rfc2109.txt">IETF RFC 2109</a>.
     */
    public static final String COOKIE = "Cookie";
    See IETF RFC 2109.
/**
     * See <a href="http://www.ietf.org/rfc/rfc2109.txt">IETF RFC 2109</a>.
     */
    public static final String SET_COOKIE = "Set-Cookie";
    "Last-Event-ID" HTTP request header name as defined by SSE specification.
Since: 2.1/**
     * {@code "Last-Event-ID"} HTTP request header name as defined by
     * <a href="http://www.w3.org/TR/eventsource/#last-event-id">SSE specification</a>.
     *
     * @since 2.1
     */
    public static final String LAST_EVENT_ID_HEADER = "Last-Event-ID";
}
Params:	name – the header name, case insensitive.
Throws:	IllegalStateException – if called outside the scope of a request.
Returns:	a read-only list of header values.
Params:	name – the HTTP header.
See Also:	getRequestHeader(String)
Returns:	the HTTP header value. If the HTTP header is not present then `null` is returned. If the HTTP header is present but has no value then the empty string is returned. If the HTTP header is present more than once then the values of joined together and separated by a ',' character.
Since:	2.0
Returns:	the message date, otherwise `null` if not present.
Since:	2.0
Returns:	Content-Length as integer if present and valid number. In other cases returns -1.
Since:	2.0
/

jakarta.ws.rs/ jakarta.ws.rs-api/ 3.0.0/ jakarta/ws/rs/core/HttpHeaders.java
