路由缓存

Finch 通过 .cache() 扩展方法提供路由级缓存。缓存的响应无需重新运行控制器。

基本设置

router
    .get('/api/products', ProductController().index)
    .cache(duration: Duration(minutes: 10));

RouteCache 参数

CacheParam — 缓存类型

CacheSource — 存储位置

// 内存缓存（默认）——更快，重启后消失
.cache(
  duration: Duration(hours: 1),
  cacheSource: CacheSource.memory,
)

// 磁盘缓存——较慢，重启后保留
.cache(
  duration: Duration(hours: 24),
  cacheSource: CacheSource.file,
)

完整示例

// 首页：所有人相同，5 分钟
router
    .get('/home', HomeController().index)
    .cache(
      duration: Duration(minutes: 5),
      cacheType: CacheParam.all,
    );

// 仪表板：每用户独立缓存，30 分钟
router
    .get('/dashboard', DashboardController().index)
    .cache(
      duration: Duration(minutes: 30),
      cacheType: CacheParam.user,
    );

// 搜索：基于查询参数，2 分钟
router
    .get('/search', SearchController().results)
    .cache(
      duration: Duration(minutes: 2),
      cacheType: CacheParam.params,
    );

清除缓存

// 清除所有缓存
RouteCache.clearAllCache();

// 清除特定路由的缓存
RouteCache.clearCache('/api/products');