Enum hyper::status::StatusClass [] [src]

pub enum StatusClass {
    Informational,
    Success,
    Redirection,
    ClientError,
    ServerError,
    NoClass,
}

The class of an HTTP status-code.

RFC 7231, section 6 (Response Status Codes):

The first digit of the status-code defines the class of response. The last two digits do not have any categorization role.

And:

HTTP status codes are extensible. HTTP clients are not required to understand the meaning of all registered status codes, though such understanding is obviously desirable. However, a client MUST understand the class of any status code, as indicated by the first digit, and treat an unrecognized status code as being equivalent to the x00 status code of that class, with the exception that a recipient MUST NOT cache a response with an unrecognized status code.

For example, if an unrecognized status code of 471 is received by a client, the client can assume that there was something wrong with its request and treat the response as if it had received a 400 (Bad Request) status code. The response message will usually contain a representation that explains the status.

This can be used in cases where a status code’s meaning is unknown, also, to get the appropriate category of status.

Variants

Informational

1xx (Informational): The request was received, continuing process

Success

2xx (Success): The request was successfully received, understood, and accepted

Redirection

3xx (Redirection): Further action needs to be taken in order to complete the request

ClientError

4xx (Client Error): The request contains bad syntax or cannot be fulfilled

ServerError

5xx (Server Error): The server failed to fulfill an apparently valid request

NoClass

A status code lower than 100 or higher than 599. These codes do no belong to any class.

Methods

impl StatusClass
[src]

fn default_code(&self) -> StatusCode

Get the default status code for the class.

This produces the x00 status code; thus, for ClientError (4xx), for example, this will produce BadRequest (400):

assert_eq!(ClientError.default_code(), BadRequest);

The use for this is outlined in RFC 7231, section 6 (Response Status Codes):

HTTP status codes are extensible. HTTP clients are not required to understand the meaning of all registered status codes, though such understanding is obviously desirable. However, a client MUST understand the class of any status code, as indicated by the first digit, and treat an unrecognized status code as being equivalent to the x00 status code of that class, with the exception that a recipient MUST NOT cache a response with an unrecognized status code.

For example, if an unrecognized status code of 471 is received by a client, the client can assume that there was something wrong with its request and treat the response as if it had received a 400 (Bad Request) status code. The response message will usually contain a representation that explains the status.

This is demonstrated thusly:

// Suppose we have received this status code.
// You will never directly create an unregistered status code.
let status = Unregistered(471);

// Uh oh! Don’t know what to do with it.
// Let’s fall back to the default:
let status = status.class().default_code();

// And look! That is 400 Bad Request.
assert_eq!(status, BadRequest);
// So now let’s treat it as that.

All status codes that do not map to an existing status class are matched by a NoClass, variant that resolves to 200 (Ok) as default code. This is a common handling for unknown status codes in major browsers.

Trait Implementations

impl Copy for StatusClass
[src]

impl Ord for StatusClass
[src]

fn cmp(&self, __arg_0: &StatusClass) -> Ordering

This method returns an Ordering between self and other. Read more

impl PartialOrd for StatusClass
[src]

fn partial_cmp(&self, __arg_0: &StatusClass) -> Option<Ordering>

This method returns an ordering between self and other values if one exists. Read more

fn lt(&self, other: &Rhs) -> bool
1.0.0

This method tests less than (for self and other) and is used by the < operator. Read more

fn le(&self, other: &Rhs) -> bool
1.0.0

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more

fn gt(&self, other: &Rhs) -> bool
1.0.0

This method tests greater than (for self and other) and is used by the > operator. Read more

fn ge(&self, other: &Rhs) -> bool
1.0.0

This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

impl Eq for StatusClass
[src]

impl PartialEq for StatusClass
[src]

fn eq(&self, __arg_0: &StatusClass) -> bool

This method tests for self and other values to be equal, and is used by ==. Read more

fn ne(&self, other: &Rhs) -> bool
1.0.0

This method tests for !=.

impl Clone for StatusClass
[src]

fn clone(&self) -> StatusClass

Returns a copy of the value. Read more

fn clone_from(&mut self, source: &Self)
1.0.0

Performs copy-assignment from source. Read more

impl Debug for StatusClass
[src]

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.