Spring Http源码-原创手记-慕课网

Copyright 2002-2017 the original author or authors.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

 http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

package org.springframework.http;

/**

Enumeration of HTTP status codes.
<p>The HTTP status code series can be retrieved via {@link #series()}.
@author Arjen Poutsma
@author Sebastien Deleuze
@author Brian Clozel
@since 3.0
@see HttpStatus.Series
@see <a href="http://www.iana.org/assignments/http-status-codes">HTTP Status Code Registry</a>
@see <a href="http://en.wikipedia.org/wiki/List_of_HTTP_status_codes">List of HTTP status codes - Wikipedia</a>
*/
public enum HttpStatus {
// 1xx Informational
/**
// 2xx Success
/**
// 3xx Redirection
/**
// --- 4xx Client Error ---
/**
// --- 5xx Server Error ---
/**
- {@code 500 Internal Server Error}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.6.1">HTTP/1.1: Semantics and Content, section 6.6.1</a>
  /
  INTERNAL_SERVER_ERROR(500, "Internal Server Error"),
  /*
- {@code 501 Not Implemented}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.6.2">HTTP/1.1: Semantics and Content, section 6.6.2</a>
  /
  NOT_IMPLEMENTED(501, "Not Implemented"),
  /*
- {@code 502 Bad Gateway}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.6.3">HTTP/1.1: Semantics and Content, section 6.6.3</a>
  /
  BAD_GATEWAY(502, "Bad Gateway"),
  /*
- {@code 503 Service Unavailable}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.6.4">HTTP/1.1: Semantics and Content, section 6.6.4</a>
  /
  SERVICE_UNAVAILABLE(503, "Service Unavailable"),
  /*
- {@code 504 Gateway Timeout}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.6.5">HTTP/1.1: Semantics and Content, section 6.6.5</a>
  /
  GATEWAY_TIMEOUT(504, "Gateway Timeout"),
  /*
- {@code 505 HTTP Version Not Supported}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.6.6">HTTP/1.1: Semantics and Content, section 6.6.6</a>
  /
  HTTP_VERSION_NOT_SUPPORTED(505, "HTTP Version not supported"),
  /*
- {@code 506 Variant Also Negotiates}
- @see <a href="http://tools.ietf.org/html/rfc2295#section-8.1">Transparent Content Negotiation</a>
  /
  VARIANT_ALSO_NEGOTIATES(506, "Variant Also Negotiates"),
  /*
- {@code 507 Insufficient Storage}
- @see <a href="http://tools.ietf.org/html/rfc4918#section-11.5">WebDAV</a>
  /
  INSUFFICIENT_STORAGE(507, "Insufficient Storage"),
  /*
- {@code 508 Loop Detected}
- @see <a href="http://tools.ietf.org/html/rfc5842#section-7.2">WebDAV Binding Extensions</a>
  /
  LOOP_DETECTED(508, "Loop Detected"),
  /*
- {@code 509 Bandwidth Limit Exceeded}
  /
  BANDWIDTH_LIMIT_EXCEEDED(509, "Bandwidth Limit Exceeded"),
  /*
- {@code 510 Not Extended}
- @see <a href="http://tools.ietf.org/html/rfc2774#section-7">HTTP Extension Framework</a>
  /
  NOT_EXTENDED(510, "Not Extended"),
  /*
- {@code 511 Network Authentication Required}.
- @see <a href="http://tools.ietf.org/html/rfc6585#section-6">Additional HTTP Status Codes</a>
  */
  NETWORK_AUTHENTICATION_REQUIRED(511, "Network Authentication Required");
- {@code 400 Bad Request}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.1">HTTP/1.1: Semantics and Content, section 6.5.1</a>
  /
  BAD_REQUEST(400, "Bad Request"),
  /*
- {@code 401 Unauthorized}.
- @see <a href="http://tools.ietf.org/html/rfc7235#section-3.1">HTTP/1.1: Authentication, section 3.1</a>
  /
  UNAUTHORIZED(401, "Unauthorized"),
  /*
- {@code 402 Payment Required}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.2">HTTP/1.1: Semantics and Content, section 6.5.2</a>
  /
  PAYMENT_REQUIRED(402, "Payment Required"),
  /*
- {@code 403 Forbidden}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.3">HTTP/1.1: Semantics and Content, section 6.5.3</a>
  /
  FORBIDDEN(403, "Forbidden"),
  /*
- {@code 404 Not Found}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.4">HTTP/1.1: Semantics and Content, section 6.5.4</a>
  /
  NOT_FOUND(404, "Not Found"),
  /*
- {@code 405 Method Not Allowed}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.5">HTTP/1.1: Semantics and Content, section 6.5.5</a>
  /
  METHOD_NOT_ALLOWED(405, "Method Not Allowed"),
  /*
- {@code 406 Not Acceptable}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.6">HTTP/1.1: Semantics and Content, section 6.5.6</a>
  /
  NOT_ACCEPTABLE(406, "Not Acceptable"),
  /*
- {@code 407 Proxy Authentication Required}.
- @see <a href="http://tools.ietf.org/html/rfc7235#section-3.2">HTTP/1.1: Authentication, section 3.2</a>
  /
  PROXY_AUTHENTICATION_REQUIRED(407, "Proxy Authentication Required"),
  /*
- {@code 408 Request Timeout}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.7">HTTP/1.1: Semantics and Content, section 6.5.7</a>
  /
  REQUEST_TIMEOUT(408, "Request Timeout"),
  /*
- {@code 409 Conflict}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.8">HTTP/1.1: Semantics and Content, section 6.5.8</a>
  /
  CONFLICT(409, "Conflict"),
  /*
- {@code 410 Gone}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.9">HTTP/1.1: Semantics and Content, section 6.5.9</a>
  /
  GONE(410, "Gone"),
  /*
- {@code 411 Length Required}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.10">HTTP/1.1: Semantics and Content, section 6.5.10</a>
  /
  LENGTH_REQUIRED(411, "Length Required"),
  /*
- {@code 412 Precondition failed}.
- @see <a href="http://tools.ietf.org/html/rfc7232#section-4.2">HTTP/1.1: Conditional Requests, section 4.2</a>
  /
  PRECONDITION_FAILED(412, "Precondition Failed"),
  /*
- {@code 413 Payload Too Large}.
- @since 4.1
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.11">HTTP/1.1: Semantics and Content, section 6.5.11</a>
  /
  PAYLOAD_TOO_LARGE(413, "Payload Too Large"),
  /*
- {@code 413 Request Entity Too Large}.
- @see <a href="http://tools.ietf.org/html/rfc2616#section-10.4.14">HTTP/1.1, section 10.4.14</a>
- @deprecated in favor of {@link #PAYLOAD_TOO_LARGE} which will be returned from {@code HttpStatus.valueOf(413)}
  /
  @Deprecated
  REQUEST_ENTITY_TOO_LARGE(413, "Request Entity Too Large"),
  /*
- {@code 414 URI Too Long}.
- @since 4.1
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.12">HTTP/1.1: Semantics and Content, section 6.5.12</a>
  /
  URI_TOO_LONG(414, "URI Too Long"),
  /*
- {@code 414 Request-URI Too Long}.
- @see <a href="http://tools.ietf.org/html/rfc2616#section-10.4.15">HTTP/1.1, section 10.4.15</a>
- @deprecated in favor of {@link #URI_TOO_LONG} which will be returned from {@code HttpStatus.valueOf(414)}
  /
  @Deprecated
  REQUEST_URI_TOO_LONG(414, "Request-URI Too Long"),
  /*
- {@code 415 Unsupported Media Type}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.13">HTTP/1.1: Semantics and Content, section 6.5.13</a>
  /
  UNSUPPORTED_MEDIA_TYPE(415, "Unsupported Media Type"),
  /*
- {@code 416 Requested Range Not Satisfiable}.
- @see <a href="http://tools.ietf.org/html/rfc7233#section-4.4">HTTP/1.1: Range Requests, section 4.4</a>
  /
  REQUESTED_RANGE_NOT_SATISFIABLE(416, "Requested range not satisfiable"),
  /*
- {@code 417 Expectation Failed}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.5.14">HTTP/1.1: Semantics and Content, section 6.5.14</a>
  /
  EXPECTATION_FAILED(417, "Expectation Failed"),
  /*
- {@code 418 I'm a teapot}.
- @see <a href="http://tools.ietf.org/html/rfc2324#section-2.3.2">HTCPCP/1.0</a>
  /
  I_AM_A_TEAPOT(418, "I'm a teapot"),
  /*
- @deprecated See <a href="http://tools.ietf.org/rfcdiff?difftype=--hwdiff&url2=draft-ietf-webdav-protocol-06.txt">WebDAV Draft Changes</a>
  /
  @Deprecated
  INSUFFICIENT_SPACE_ON_RESOURCE(419, "Insufficient Space On Resource"),
  /*
- @deprecated See <a href="http://tools.ietf.org/rfcdiff?difftype=--hwdiff&url2=draft-ietf-webdav-protocol-06.txt">WebDAV Draft Changes</a>
  /
  @Deprecated
  METHOD_FAILURE(420, "Method Failure"),
  /*
- @deprecated See <a href="http://tools.ietf.org/rfcdiff?difftype=--hwdiff&url2=draft-ietf-webdav-protocol-06.txt">WebDAV Draft Changes</a>
  /
  @Deprecated
  DESTINATION_LOCKED(421, "Destination Locked"),
  /*
- {@code 422 Unprocessable Entity}.
- @see <a href="http://tools.ietf.org/html/rfc4918#section-11.2">WebDAV</a>
  /
  UNPROCESSABLE_ENTITY(422, "Unprocessable Entity"),
  /*
- {@code 423 Locked}.
- @see <a href="http://tools.ietf.org/html/rfc4918#section-11.3">WebDAV</a>
  /
  LOCKED(423, "Locked"),
  /*
- {@code 424 Failed Dependency}.
- @see <a href="http://tools.ietf.org/html/rfc4918#section-11.4">WebDAV</a>
  /
  FAILED_DEPENDENCY(424, "Failed Dependency"),
  /*
- {@code 426 Upgrade Required}.
- @see <a href="http://tools.ietf.org/html/rfc2817#section-6">Upgrading to TLS Within HTTP/1.1</a>
  /
  UPGRADE_REQUIRED(426, "Upgrade Required"),
  /*
- {@code 428 Precondition Required}.
- @see <a href="http://tools.ietf.org/html/rfc6585#section-3">Additional HTTP Status Codes</a>
  /
  PRECONDITION_REQUIRED(428, "Precondition Required"),
  /*
- {@code 429 Too Many Requests}.
- @see <a href="http://tools.ietf.org/html/rfc6585#section-4">Additional HTTP Status Codes</a>
  /
  TOO_MANY_REQUESTS(429, "Too Many Requests"),
  /*
- {@code 431 Request Header Fields Too Large}.
- @see <a href="http://tools.ietf.org/html/rfc6585#section-5">Additional HTTP Status Codes</a>
  /
  REQUEST_HEADER_FIELDS_TOO_LARGE(431, "Request Header Fields Too Large"),
  /*
- {@code 451 Unavailable For Legal Reasons}.
- @see <a href="https://tools.ietf.org/html/draft-ietf-httpbis-legally-restricted-status-04">
- An HTTP Status Code to Report Legal Obstacles</a>
- @since 4.3
  */
  UNAVAILABLE_FOR_LEGAL_REASONS(451, "Unavailable For Legal Reasons"),
- {@code 300 Multiple Choices}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.4.1">HTTP/1.1: Semantics and Content, section 6.4.1</a>
  /
  MULTIPLE_CHOICES(300, "Multiple Choices"),
  /*
- {@code 301 Moved Permanently}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.4.2">HTTP/1.1: Semantics and Content, section 6.4.2</a>
  /
  MOVED_PERMANENTLY(301, "Moved Permanently"),
  /*
- {@code 302 Found}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.4.3">HTTP/1.1: Semantics and Content, section 6.4.3</a>
  /
  FOUND(302, "Found"),
  /*
- {@code 302 Moved Temporarily}.
- @see <a href="http://tools.ietf.org/html/rfc1945#section-9.3">HTTP/1.0, section 9.3</a>
- @deprecated in favor of {@link #FOUND} which will be returned from {@code HttpStatus.valueOf(302)}
  /
  @Deprecated
  MOVED_TEMPORARILY(302, "Moved Temporarily"),
  /*
- {@code 303 See Other}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.4.4">HTTP/1.1: Semantics and Content, section 6.4.4</a>
  /
  SEE_OTHER(303, "See Other"),
  /*
- {@code 304 Not Modified}.
- @see <a href="http://tools.ietf.org/html/rfc7232#section-4.1">HTTP/1.1: Conditional Requests, section 4.1</a>
  /
  NOT_MODIFIED(304, "Not Modified"),
  /*
- {@code 305 Use Proxy}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.4.5">HTTP/1.1: Semantics and Content, section 6.4.5</a>
- @deprecated due to security concerns regarding in-band configuration of a proxy
  /
  @Deprecated
  USE_PROXY(305, "Use Proxy"),
  /*
- {@code 307 Temporary Redirect}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.4.7">HTTP/1.1: Semantics and Content, section 6.4.7</a>
  /
  TEMPORARY_REDIRECT(307, "Temporary Redirect"),
  /*
- {@code 308 Permanent Redirect}.
- @see <a href="http://tools.ietf.org/html/rfc7238">RFC 7238</a>
  */
  PERMANENT_REDIRECT(308, "Permanent Redirect"),
- {@code 200 OK}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.3.1">HTTP/1.1: Semantics and Content, section 6.3.1</a>
  /
  OK(200, "OK"),
  /*
- {@code 201 Created}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.3.2">HTTP/1.1: Semantics and Content, section 6.3.2</a>
  /
  CREATED(201, "Created"),
  /*
- {@code 202 Accepted}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.3.3">HTTP/1.1: Semantics and Content, section 6.3.3</a>
  /
  ACCEPTED(202, "Accepted"),
  /*
- {@code 203 Non-Authoritative Information}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.3.4">HTTP/1.1: Semantics and Content, section 6.3.4</a>
  /
  NON_AUTHORITATIVE_INFORMATION(203, "Non-Authoritative Information"),
  /*
- {@code 204 No Content}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.3.5">HTTP/1.1: Semantics and Content, section 6.3.5</a>
  /
  NO_CONTENT(204, "No Content"),
  /*
- {@code 205 Reset Content}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.3.6">HTTP/1.1: Semantics and Content, section 6.3.6</a>
  /
  RESET_CONTENT(205, "Reset Content"),
  /*
- {@code 206 Partial Content}.
- @see <a href="http://tools.ietf.org/html/rfc7233#section-4.1">HTTP/1.1: Range Requests, section 4.1</a>
  /
  PARTIAL_CONTENT(206, "Partial Content"),
  /*
- {@code 207 Multi-Status}.
- @see <a href="http://tools.ietf.org/html/rfc4918#section-13">WebDAV</a>
  /
  MULTI_STATUS(207, "Multi-Status"),
  /*
- {@code 208 Already Reported}.
- @see <a href="http://tools.ietf.org/html/rfc5842#section-7.1">WebDAV Binding Extensions</a>
  /
  ALREADY_REPORTED(208, "Already Reported"),
  /*
- {@code 226 IM Used}.
- @see <a href="http://tools.ietf.org/html/rfc3229#section-10.4.1">Delta encoding in HTTP</a>
  */
  IM_USED(226, "IM Used"),
- {@code 100 Continue}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.2.1">HTTP/1.1: Semantics and Content, section 6.2.1</a>
  /
  CONTINUE(100, "Continue"),
  /*
- {@code 101 Switching Protocols}.
- @see <a href="http://tools.ietf.org/html/rfc7231#section-6.2.2">HTTP/1.1: Semantics and Content, section 6.2.2</a>
  /
  SWITCHING_PROTOCOLS(101, "Switching Protocols"),
  /*
- {@code 102 Processing}.
- @see <a href="http://tools.ietf.org/html/rfc2518#section-10.1">WebDAV</a>
  /
  PROCESSING(102, "Processing"),
  /*
- {@code 103 Checkpoint}.
- @see <a href="http://code.google.com/p/gears/wiki/ResumableHttpRequestsProposal">A proposal for supporting
- resumable POST/PUT HTTP requests in HTTP/1.0</a>
  */
  CHECKPOINT(103, "Checkpoint"),

private final int value;private final String reasonPhrase;


HttpStatus(int value, String reasonPhrase) {    this.value = value;    this.reasonPhrase = reasonPhrase;
}/**
 * Return the integer value of this status code.
 */public int value() {    return this.value;
}/**
 * Return the reason phrase of this status code.
 */public String getReasonPhrase() {    return this.reasonPhrase;
}/**
 * Whether this status code is in the HTTP series
 * {@link org.springframework.http.HttpStatus.Series#INFORMATIONAL}.
 * This is a shortcut for checking the value of {@link #series()}.
 */public boolean is1xxInformational() {    return Series.INFORMATIONAL.equals(series());
}/**
 * Whether this status code is in the HTTP series
 * {@link org.springframework.http.HttpStatus.Series#SUCCESSFUL}.
 * This is a shortcut for checking the value of {@link #series()}.
 */public boolean is2xxSuccessful() {    return Series.SUCCESSFUL.equals(series());
}/**
 * Whether this status code is in the HTTP series
 * {@link org.springframework.http.HttpStatus.Series#REDIRECTION}.
 * This is a shortcut for checking the value of {@link #series()}.
 */public boolean is3xxRedirection() {    return Series.REDIRECTION.equals(series());
}/**
 * Whether this status code is in the HTTP series
 * {@link org.springframework.http.HttpStatus.Series#CLIENT_ERROR}.
 * This is a shortcut for checking the value of {@link #series()}.
 */public boolean is4xxClientError() {    return Series.CLIENT_ERROR.equals(series());
}/**
 * Whether this status code is in the HTTP series
 * {@link org.springframework.http.HttpStatus.Series#SERVER_ERROR}.
 * This is a shortcut for checking the value of {@link #series()}.
 */public boolean is5xxServerError() {    return Series.SERVER_ERROR.equals(series());
}/**
 * Returns the HTTP status series of this status code.
 * @see HttpStatus.Series
 */public Series series() {    return Series.valueOf(this);
}/**
 * Return a string representation of this status code.
 */@Overridepublic String toString() {    return Integer.toString(this.value);
}/**
 * Return the enum constant of this type with the specified numeric value.
 * @param statusCode the numeric value of the enum to be returned
 * @return the enum constant with the specified numeric value
 * @throws IllegalArgumentException if this enum has no constant for the specified numeric value
 */public static HttpStatus valueOf(int statusCode) {    for (HttpStatus status : values()) {        if (status.value == statusCode) {            return status;
        }
    }    throw new IllegalArgumentException("No matching constant for [" + statusCode + "]");
}/**
 * Enumeration of HTTP status series.
 * <p>Retrievable via {@link HttpStatus#series()}.
 */public enum Series {

    INFORMATIONAL(1),
    SUCCESSFUL(2),
    REDIRECTION(3),
    CLIENT_ERROR(4),
    SERVER_ERROR(5);    private final int value;

    Series(int value) {        this.value = value;
    }    /**
     * Return the integer value of this status series. Ranges from 1 to 5.
     */
    public int value() {        return this.value;
    }    public static Series valueOf(int status) {        int seriesCode = status / 100;        for (Series series : values()) {            if (series.value == seriesCode) {                return series;
            }
        }        throw new IllegalArgumentException("No matching constant for [" + status + "]");
    }    public static Series valueOf(HttpStatus status) {        return valueOf(status.value);
    }
}

}

作者：芥末无疆sss
链接：https://www.jianshu.com/p/3acf2951ddc7
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。