Skip to content

Caching

Use cache policies and cache interceptors to add response caching to NestForge applications.

Feature activation

nestforge = { version = "1", features = ["cache", "redis"] }

Cache model

Cache support is built around:

CacheStore
CachePolicy
CacheInterceptor

That design makes caching part of the request pipeline instead of a hidden controller behavior.

Define a policy

#[derive(Default, Clone)]
struct UsersCachePolicy;

impl nestforge::CachePolicy for UsersCachePolicy {
    type Store = nestforge::InMemoryRedisStore;
}

Register the interceptor

NestForgeFactory::<AppModule>::create()?
    .use_interceptor::<nestforge::CacheInterceptor<UsersCachePolicy>>();

Default behavior

The built-in defaults are conservative:

only GET requests are cached
request URI is used as the cache key
only successful 200 OK responses are stored

Override policy methods when your application needs custom cache keys, TTL behavior, or cacheability rules.

Home Quick Start Application Guides

Start Here

Overview Installation Quick Start CLI Workflow

Core Concepts

Architecture Modules and DI Controllers and Routing Request Pipeline Configuration

Application Guides

Middleware Guards and Interceptors Auth and OpenAPI Testing Resource Services Macros Data Layer

Transports and Runtime

GraphQL gRPC WebSockets Microservices Scheduling Caching

Examples

Hello NestForge GraphQL Example gRPC Example WebSocket Example Microservices Example Example API

Framework Internals

Workspace Structure Crate Architecture Public API Surface Macro and Routing Internals Testing and Quality Contributing Release Process