Struct StatusCode 

pub struct StatusCode<P> { /* private fields */ }

A predicate that matches responses by HTTP status code.

Type Parameters

• P - The inner predicate to chain with. Use StatusCode::new to start a new predicate chain (uses Neutral internally), or use the StatusCodePredicate extension trait to chain onto an existing predicate.

Examples

Match only 200 OK responses:

use hitbox_http::predicates::response::StatusCode;

let predicate = StatusCode::new(http::StatusCode::OK);

Chain with body predicate:

use hitbox_http::predicates::response::StatusCode;
use hitbox_http::predicates::body::{BodyPredicate, Operation as BodyOperation, PlainOperation};

let predicate = StatusCode::new(http::StatusCode::OK)
    .body(BodyOperation::Plain(PlainOperation::Contains("success".into())));

Implementations

impl<S> StatusCode<Neutral<S>>

pub fn new(status_code: StatusCode) -> Self

Creates a predicate matching a specific status code.

impl<P> StatusCode<P>

pub fn new_in(inner: P, codes: Vec<StatusCode>) -> Self

Creates a predicate matching any of the specified status codes.

Returns Cacheable when the response status code is in the provided list.

Use this for caching multiple specific status codes (e.g., 200 and 304).

Examples

use hitbox::Neutral;
use hitbox_http::predicates::response::StatusCode;

// Cache 200 OK and 304 Not Modified responses
let predicate = StatusCode::new_in(
    Neutral::new(),
    vec![http::StatusCode::OK, http::StatusCode::NOT_MODIFIED],
);

pub fn new_range(inner: P, start: StatusCode, end: StatusCode) -> Self

Creates a predicate matching status codes within a range (inclusive).

Returns Cacheable when the response status code is between start and end (inclusive).

Use this for custom status code ranges not covered by StatusClass.

Examples

use hitbox::Neutral;
use hitbox_http::predicates::response::StatusCode;

// Cache responses with status codes 200-299 and 304
let predicate = StatusCode::new_range(
    Neutral::new(),
    http::StatusCode::OK,
    http::StatusCode::from_u16(299).unwrap(),
);

pub fn new_class(inner: P, class: StatusClass) -> Self

Creates a predicate matching all status codes in a class.

Returns Cacheable when the response status code belongs to the specified class (e.g., all 2xx).

Use this for broad caching rules like “cache all successful responses”.

Examples

use hitbox::Neutral;
use hitbox_http::predicates::response::{StatusCode, StatusClass};

// Cache all successful (2xx) responses
let predicate = StatusCode::new_class(Neutral::new(), StatusClass::Success);

Trait Implementations

impl<P: Debug> Debug for StatusCode<P>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<P, ReqBody> Predicate for StatusCode<P>

where P: Predicate<Subject = CacheableHttpResponse<ReqBody>> + Send + Sync, ReqBody: Body + Send + 'static, ReqBody::Error: Send,

type Subject = <P as Predicate>::Subject

The type being evaluated by this predicate.

fn check<'life0, 'async_trait>( &'life0 self, response: Self::Subject, ) -> Pin<Box<dyn Future<Output = PredicateResult<Self::Subject>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Evaluate whether the subject should be cached.