Experimental: Alpha Release

This crate is in early development. APIs are unstable and may change without notice. Not recommended for production use yet.

HTTP Cache Tags Actix Integration

This crate extends the core http_cache_tags_core library to provide Actix-web specific middleware, extractors, and API handlers.

It enables tag-based HTTP cache invalidation, cache metadata resolution, and response validation tailored for Actix applications.

Features

The available features mirror those from the core crate and are propagated through this integration:

• Config File (config_file feature): Load cache config from TOML files.
• ETag Support (etag feature): Generate and handle weak ETags.
• Last-Modified Support (last_modified feature): Track resource modification timestamps.
• Redis Integration (redis feature): Use Redis as a persistent backend for cache metadata.

Components

This crate provides:

• Actix middleware to inject cache headers like ETag, Last-Modified, and Cache-Control.
• Extractors for retrieving validated JSON payloads and cache metadata.
• API error types and controllers compatible with Actix-web.

Example Usage

use actix_web::{App, HttpServer, web, HttpResponse};
use http_cache_tags_actix::prelude::*;

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    let config = CacheConfig::builder()
        .invalidate_path("/_invalidate")
        .add_route_mapping("/blog/*", vec!["blog".to_string()])
        .build();

    let runtime = CacheRuntime::builder().config(config).build();

    HttpServer::new(move || {
        App::new()
            .app_data(web::Data::new(runtime.extractor()))
            .wrap(runtime.cache_meta_middleware())
            .wrap(runtime.cache_validation_middleware())
            .service(runtime.invalidation_scope().unwrap())
            .route("/blog/{slug}", web::get().to(blog_handler))
    })
    .bind(("0.0.0.0", 3000))?
    .run()
    .await
}

async fn blog_handler(meta: CacheMeta) -> HttpResponse {
    HttpResponse::Ok().body(format!(
        "Tags: {:?}, Last Modified: {:?}",
        meta.tags, meta.last_modified
    ))
}

Integration Notes

Use this crate alongside http_cache_tags_core to enable full cache tagging support in Actix-web applications. For convenience, consider using the umbrella crate http_cache_tags, which bundles all framework integrations, including Actix and Axum.