yangzhaohan
34 lines
828 B
Markdown
34 lines
828 B
Markdown
# brick-common-cache 编码规范
|
|
|
|
## 职责边界
|
|
|
|
cache 模块提供统一的缓存抽象，业务代码只与 `CacheService` 接口交互，不感知底层实现。
|
|
|
|
## 使用准则
|
|
|
|
- 所有缓存操作通过 `CacheService`，不得直接注入 Redis/Redisson/Caffeine 客户端。
|
|
- 缓存 Key 统一使用 `CacheKey` 构造，禁止裸字符串拼接。
|
|
- 缓存是可重建的临时数据，不可替代数据库持久化。
|
|
|
|
## 正例
|
|
|
|
```java
|
|
@Autowired
|
|
private CacheService cacheService;
|
|
|
|
CacheKey key = CacheKey.of("user", userId);
|
|
User user = cacheService.get(key, User.class);
|
|
```
|
|
|
|
## 反例
|
|
|
|
```java
|
|
// 直接注入底层客户端
|
|
@Autowired
|
|
private RedisTemplate<String, Object> redisTemplate;
|
|
|
|
// 裸字符串拼接 Key
|
|
String key = "user:" + userId;
|
|
User user = (User) redisTemplate.opsForValue().get(key);
|
|
```
|