Cache

Introduction

JCC Express MVC ships with a Laravel-style cache API in jcc-express-mvc/lib/Cache.

Core capabilities:

• Multiple stores (memory, redis)
• Key/value operations (get, put, forget, has)
• Batch operations (many, putMany)
• Numeric ops (increment, decrement)
• Helpers (remember, rememberForever, pull, add)
• Tag-based invalidation (tags([...]).flush())

Bootstrapping cache

Cache is a singleton (Cache.getInstance(...)). You must provide config on first initialization:

After first boot, use Cache.getInstance() anywhere in the same process.

Basic operations

Remember helpers

remember only runs the callback when the key is missing.

Numeric and atomic-style helpers

Batch operations

Tagged cache

Tagged keys are namespaced and can be flushed by tag group:

Store selection

Use the default store or explicitly pick one:

Driver notes

• memory is process-local (fast, reset on restart).
• redis serializes payloads as JSON and supports TTL with setEx.
• Invalid inputs throw explicit errors (missing key, null value, invalid TTL, etc.).

Summary

• Initialize once with Cache.getInstance(config).
• Use get/put/remember for common read-through caching.
• Use tags(...) when invalidation needs grouping.
• Prefer redis for shared cache across processes/instances.