JS注解实为装饰器，用于模拟类似Java的注解行为，如@Cacheable通过拦截方法调用实现缓存逻辑，结合参数生成唯一key，支持ttl控制，并需注意异步处理与生产环境集成Redis等细节。
JavaScript 本身不支持注解（Annotation）语法，像 Java 中的 @Cacheable 这类注解在原生 JS 中并不存在。但如果你是在使用 TypeScript、Babel 插件、装饰器（Decorators）或某些框架（如 NestJS），就可以通过 装饰器 模拟类似“注解”的行为来标注缓存策略。
什么是“JS注解”？实际指的是装饰器
在 JavaScript/TypeScript 生态中，所谓的“注解”通常是指 装饰器（Decorator）。它是一种特殊类型的声明，可以被附加到类声明、方法、属性或参数上，用于增强或修改其行为。
例如，在 NestJS 中你可以这样写：
@Cacheable('user-profile', 600) // 缓存 key 为 user-profile，有效期 600 秒
getUserProfile(id: string) {
return this.http.get(`/api/users/${id}`);
}
如何实现缓存相关的装饰器
要自定义一个缓存策略装饰器，核心思路是：拦截函数调用，先查缓存，命中则返回缓存值，未命中则执行原函数并将结果存入缓存。
下面是一个简单的 @Cacheable 装饰器实现示例：
const cache = new Map();
<p>function Cacheable(key: string, ttl: number = 300) {
return function (
target: any,
propertyName: string,
descriptor: PropertyDescriptor
) {
const method = descriptor.value;</p><pre class='brush:php;toolbar:false;'>descriptor.value = function (...args: any[]) {
const cacheKey = key + JSON.stringify(args);
const record = cache.get(cacheKey);
if (record) {
const { value, timestamp } = record;
if (Date.now() - timestamp < ttl * 1000) {
return value;
} else {
cache.delete(cacheKey);
}
}
const result = method.apply(this, args);
cache.set(cacheKey, { value: result, timestamp: Date.now() });
return result;
};}; }
使用方式：
class UserService {
@Cacheable('user-', 60)
async getUserById(id: string) {
console.log('Fetching user from API...');
// 模拟请求
return await fetch(`/api/user/${id}`).then(res => res.json());
}
}
常见缓存策略与对应注解设计
可以根据不同场景设计多种缓存装饰器：
- @Cacheable(key, ttl)：标准缓存读取，适合查询类操作
- @CachePut(key)：强制更新缓存，无论是否命中
- @CacheEvict(key)：清除指定缓存，常用于更新或删除操作后
- @CacheMulti(keys)：处理批量缓存操作
示例：清除缓存
@CacheEvict('user-list')
async addUser(user: User) {
return await this.http.post('/api/users', user);
}
注意事项与限制
使用装饰器实现缓存策略时需注意以下几点：
- JavaScript 装饰器目前仍处于提案阶段，TypeScript 支持较好，但需开启
experimentalDecorators和emitDecoratorMetadata - 异步函数返回的是 Promise，若需缓存结果，应缓存
Promise.resolve(result)并处理好状态 - 缓存 key 应尽量唯一，建议结合参数生成哈希或字符串化
- 生产环境建议集成 Redis 或内存缓存库（如 node-cache、lru-cache）替代 Map
基本上就这些。虽然 JS 没有原生注解，但通过装饰器模式完全可以实现清晰、可复用的缓存逻辑标注方式。关键是封装好通用逻辑，让业务代码保持干净。不复杂但容易忽略细节。
