001/*
002 * Copyright (C) 2011 The Guava Authors
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 */
016
017package com.google.common.net;
018
019import com.google.common.annotations.Beta;
020import com.google.common.annotations.GwtCompatible;
021
022/**
023 * Contains constant definitions for the HTTP header field names. See:
024 * <ul>
025 * <li><a href="http://www.ietf.org/rfc/rfc2109.txt">RFC 2109</a>
026 * <li><a href="http://www.ietf.org/rfc/rfc2183.txt">RFC 2183</a>
027 * <li><a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>
028 * <li><a href="http://www.ietf.org/rfc/rfc2965.txt">RFC 2965</a>
029 * <li><a href="http://www.ietf.org/rfc/rfc5988.txt">RFC 5988</a>
030 * </ul>
031 *
032 * @author Kurt Alfred Kluever
033 * @since 11.0
034 */
035@GwtCompatible
036public final class HttpHeaders {
037  private HttpHeaders() {}
038
039  // HTTP Request and Response header fields
040
041  /** The HTTP {@code Cache-Control} header field name. */
042  public static final String CACHE_CONTROL = "Cache-Control";
043  /** The HTTP {@code Content-Length} header field name. */
044  public static final String CONTENT_LENGTH = "Content-Length";
045  /** The HTTP {@code Content-Type} header field name. */
046  public static final String CONTENT_TYPE = "Content-Type";
047  /** The HTTP {@code Date} header field name. */
048  public static final String DATE = "Date";
049  /** The HTTP {@code Pragma} header field name. */
050  public static final String PRAGMA = "Pragma";
051  /** The HTTP {@code Via} header field name. */
052  public static final String VIA = "Via";
053  /** The HTTP {@code Warning} header field name. */
054  public static final String WARNING = "Warning";
055
056  // HTTP Request header fields
057
058  /** The HTTP {@code Accept} header field name. */
059  public static final String ACCEPT = "Accept";
060  /** The HTTP {@code Accept-Charset} header field name. */
061  public static final String ACCEPT_CHARSET = "Accept-Charset";
062  /** The HTTP {@code Accept-Encoding} header field name. */
063  public static final String ACCEPT_ENCODING = "Accept-Encoding";
064  /** The HTTP {@code Accept-Language} header field name. */
065  public static final String ACCEPT_LANGUAGE = "Accept-Language";
066  /** The HTTP {@code Access-Control-Request-Headers} header field name. */
067  public static final String ACCESS_CONTROL_REQUEST_HEADERS = "Access-Control-Request-Headers";
068  /** The HTTP {@code Access-Control-Request-Method} header field name. */
069  public static final String ACCESS_CONTROL_REQUEST_METHOD = "Access-Control-Request-Method";
070  /** The HTTP {@code Authorization} header field name. */
071  public static final String AUTHORIZATION = "Authorization";
072  /** The HTTP {@code Connection} header field name. */
073  public static final String CONNECTION = "Connection";
074  /** The HTTP {@code Cookie} header field name. */
075  public static final String COOKIE = "Cookie";
076  /** The HTTP {@code Expect} header field name. */
077  public static final String EXPECT = "Expect";
078  /** The HTTP {@code From} header field name. */
079  public static final String FROM = "From";
080  /** The HTTP {@code Host} header field name. */
081  public static final String HOST = "Host";
082  /** The HTTP {@code If-Match} header field name. */
083  public static final String IF_MATCH = "If-Match";
084  /** The HTTP {@code If-Modified-Since} header field name. */
085  public static final String IF_MODIFIED_SINCE = "If-Modified-Since";
086  /** The HTTP {@code If-None-Match} header field name. */
087  public static final String IF_NONE_MATCH = "If-None-Match";
088  /** The HTTP {@code If-Range} header field name. */
089  public static final String IF_RANGE = "If-Range";
090  /** The HTTP {@code If-Unmodified-Since} header field name. */
091  public static final String IF_UNMODIFIED_SINCE = "If-Unmodified-Since";
092  /** The HTTP {@code Last-Event-ID} header field name. */
093  public static final String LAST_EVENT_ID = "Last-Event-ID";
094  /** The HTTP {@code Max-Forwards} header field name. */
095  public static final String MAX_FORWARDS = "Max-Forwards";
096  /** The HTTP {@code Origin} header field name. */
097  public static final String ORIGIN = "Origin";
098  /** The HTTP {@code Proxy-Authorization} header field name. */
099  public static final String PROXY_AUTHORIZATION = "Proxy-Authorization";
100  /** The HTTP {@code Range} header field name. */
101  public static final String RANGE = "Range";
102  /** The HTTP {@code Referer} header field name. */
103  public static final String REFERER = "Referer";
104  /** The HTTP {@code TE} header field name. */
105  public static final String TE = "TE";
106  /** The HTTP {@code Upgrade} header field name. */
107  public static final String UPGRADE = "Upgrade";
108  /** The HTTP {@code User-Agent} header field name. */
109  public static final String USER_AGENT = "User-Agent";
110
111  // HTTP Response header fields
112
113  /** The HTTP {@code Accept-Ranges} header field name. */
114  public static final String ACCEPT_RANGES = "Accept-Ranges";
115  /** The HTTP {@code Access-Control-Allow-Headers} header field name. */
116  public static final String ACCESS_CONTROL_ALLOW_HEADERS = "Access-Control-Allow-Headers";
117  /** The HTTP {@code Access-Control-Allow-Methods} header field name. */
118  public static final String ACCESS_CONTROL_ALLOW_METHODS = "Access-Control-Allow-Methods";
119  /** The HTTP {@code Access-Control-Allow-Origin} header field name. */
120  public static final String ACCESS_CONTROL_ALLOW_ORIGIN = "Access-Control-Allow-Origin";
121  /** The HTTP {@code Access-Control-Allow-Credentials} header field name. */
122  public static final String ACCESS_CONTROL_ALLOW_CREDENTIALS = "Access-Control-Allow-Credentials";
123  /** The HTTP {@code Access-Control-Expose-Headers} header field name. */
124  public static final String ACCESS_CONTROL_EXPOSE_HEADERS = "Access-Control-Expose-Headers";
125  /** The HTTP {@code Access-Control-Max-Age} header field name. */
126  public static final String ACCESS_CONTROL_MAX_AGE = "Access-Control-Max-Age";
127  /** The HTTP {@code Age} header field name. */
128  public static final String AGE = "Age";
129  /** The HTTP {@code Allow} header field name. */
130  public static final String ALLOW = "Allow";
131  /** The HTTP {@code Content-Disposition} header field name. */
132  public static final String CONTENT_DISPOSITION = "Content-Disposition";
133  /** The HTTP {@code Content-Encoding} header field name. */
134  public static final String CONTENT_ENCODING = "Content-Encoding";
135  /** The HTTP {@code Content-Language} header field name. */
136  public static final String CONTENT_LANGUAGE = "Content-Language";
137  /** The HTTP {@code Content-Location} header field name. */
138  public static final String CONTENT_LOCATION = "Content-Location";
139  /** The HTTP {@code Content-MD5} header field name. */
140  public static final String CONTENT_MD5 = "Content-MD5";
141  /** The HTTP {@code Content-Range} header field name. */
142  public static final String CONTENT_RANGE = "Content-Range";
143  /**
144   * The HTTP <a href="http://w3.org/TR/CSP/#content-security-policy-header-field">
145   * {@code Content-Security-Policy}</a> header field name.
146   *
147   * @since 15.0
148   */
149  public static final String CONTENT_SECURITY_POLICY = "Content-Security-Policy";
150  /**
151   * The HTTP <a href="http://w3.org/TR/CSP/#content-security-policy-report-only-header-field">
152   * {@code Content-Security-Policy-Report-Only}</a> header field name.
153   *
154   * @since 15.0
155   */
156  public static final String CONTENT_SECURITY_POLICY_REPORT_ONLY =
157      "Content-Security-Policy-Report-Only";
158  /** The HTTP {@code ETag} header field name. */
159  public static final String ETAG = "ETag";
160  /** The HTTP {@code Expires} header field name. */
161  public static final String EXPIRES = "Expires";
162  /** The HTTP {@code Last-Modified} header field name. */
163  public static final String LAST_MODIFIED = "Last-Modified";
164  /** The HTTP {@code Link} header field name. */
165  public static final String LINK = "Link";
166  /** The HTTP {@code Location} header field name. */
167  public static final String LOCATION = "Location";
168  /** The HTTP {@code P3P} header field name. Limited browser support. */
169  public static final String P3P = "P3P";
170  /** The HTTP {@code Proxy-Authenticate} header field name. */
171  public static final String PROXY_AUTHENTICATE = "Proxy-Authenticate";
172  /** The HTTP {@code Refresh} header field name. Non-standard header supported by most browsers. */
173  public static final String REFRESH = "Refresh";
174  /** The HTTP {@code Retry-After} header field name. */
175  public static final String RETRY_AFTER = "Retry-After";
176  /** The HTTP {@code Server} header field name. */
177  public static final String SERVER = "Server";
178  /** The HTTP {@code Set-Cookie} header field name. */
179  public static final String SET_COOKIE = "Set-Cookie";
180  /** The HTTP {@code Set-Cookie2} header field name. */
181  public static final String SET_COOKIE2 = "Set-Cookie2";
182  /**
183   * The HTTP <a href="http://tools.ietf.org/html/rfc6797#section-6.1">
184   * {@code Strict-Transport-Security}</a> header field name.
185   *
186   * @since 15.0
187   */
188  public static final String STRICT_TRANSPORT_SECURITY = "Strict-Transport-Security";
189  /**
190   * The HTTP <a href="http://www.w3.org/TR/resource-timing/#cross-origin-resources">
191   * {@code Timing-Allow-Origin}</a> header field name.
192   *
193   * @since 15.0
194   */
195  public static final String TIMING_ALLOW_ORIGIN = "Timing-Allow-Origin";
196  /** The HTTP {@code Trailer} header field name. */
197  public static final String TRAILER = "Trailer";
198  /** The HTTP {@code Transfer-Encoding} header field name. */
199  public static final String TRANSFER_ENCODING = "Transfer-Encoding";
200  /** The HTTP {@code Vary} header field name. */
201  public static final String VARY = "Vary";
202  /** The HTTP {@code WWW-Authenticate} header field name. */
203  public static final String WWW_AUTHENTICATE = "WWW-Authenticate";
204
205  // Common, non-standard HTTP header fields
206
207  /** The HTTP {@code DNT} header field name. */
208  public static final String DNT = "DNT";
209  /** The HTTP {@code X-Content-Type-Options} header field name. */
210  public static final String X_CONTENT_TYPE_OPTIONS = "X-Content-Type-Options";
211  /** The HTTP {@code X-Do-Not-Track} header field name. */
212  public static final String X_DO_NOT_TRACK = "X-Do-Not-Track";
213  /** The HTTP {@code X-Forwarded-For} header field name. */
214  public static final String X_FORWARDED_FOR = "X-Forwarded-For";
215  /** The HTTP {@code X-Forwarded-Proto} header field name. */
216  public static final String X_FORWARDED_PROTO = "X-Forwarded-Proto";
217  /** The HTTP {@code X-Frame-Options} header field name. */
218  public static final String X_FRAME_OPTIONS = "X-Frame-Options";
219  /** The HTTP {@code X-Powered-By} header field name. */
220  public static final String X_POWERED_BY = "X-Powered-By";
221  /**
222   * The HTTP <a href="http://tools.ietf.org/html/draft-evans-palmer-key-pinning">
223   * {@code Public-Key-Pins}</a> header field name.
224   *
225   * @since 15.0
226   */
227  @Beta
228  public static final String PUBLIC_KEY_PINS = "Public-Key-Pins";
229  /**
230   * The HTTP <a href="http://tools.ietf.org/html/draft-evans-palmer-key-pinning">
231   * {@code Public-Key-Pins-Report-Only}</a> header field name.
232   *
233   * @since 15.0
234   */
235  @Beta
236  public static final String PUBLIC_KEY_PINS_REPORT_ONLY = "Public-Key-Pins-Report-Only";
237  /** The HTTP {@code X-Requested-With} header field name. */
238  public static final String X_REQUESTED_WITH = "X-Requested-With";
239  /** The HTTP {@code X-User-IP} header field name. */
240  public static final String X_USER_IP = "X-User-IP";
241  /** The HTTP {@code X-XSS-Protection} header field name. */
242  public static final String X_XSS_PROTECTION = "X-XSS-Protection";
243}