当前位置：首页 > news >正文

升鲜宝生鲜配送供应链管理系统---PMS--商品品牌多语言存储与 Redis 缓存同步实现

news 2025/11/8 8:07:24

商品品牌多语言存储与 Redis 缓存同步实现文档

本设计文档说明商品品牌（pms_brand）在支持多语言环境下的数据存储、翻译同步及 Redis 缓存方案，
涵盖数据结构、DTO、服务实现、Redis Key 结构与数据流示意。

一、DTO 设计
① RequestBrandDTO

@Data
public class RequestBrandDTO implements Serializable {
private Long id;
private String brandCode;
private String brandImage;
private String brandIndex;
private Integer sortCode;
private Integer isIcon;
private Integer iconSort;
private Integer enabled;
private List sysDynamicTranslationList = new ArrayList<>();
}

② RequestSysDynamicTranslationDTO

@Data
public class RequestSysDynamicTranslationDTO implements Serializable {
private String languageCode;
private String fieldName;
private String fieldValue;
}

二、Service 实现（新增 / 修改）
1️⃣ 新增品牌（Add）

@Transactional
@Override
public void addBrand(RequestBrandDTO req, Long userId) {
String defaultLang = redisTemplate.opsForValue().get("sys:lang:default");
String defaultName = req.getSysDynamicTranslationList().stream()
.filter(t -> defaultLang.equalsIgnoreCase(t.getLanguageCode()))
.map(RequestSysDynamicTranslationDTO::getFieldValue)
.findFirst()
.orElse("未命名品牌");

PmsBrandEntity brand = new PmsBrandEntity();
brand.setBrandCode(req.getBrandCode());
brand.setBrandName(defaultName);
brand.setBrandImage(req.getBrandImage());
brand.setBrandIndex(req.getBrandIndex());
brand.setSortCode(req.getSortCode());
brand.setIsIcon(req.getIsIcon());
brand.setIconSort(req.getIconSort());
brand.setEnabled(req.getEnabled());
brand.setCreator(userId);
brand.setCreateDate(System.currentTimeMillis());
this.save(brand);String brandKey = "pms:brand:" + brand.getId();
redisTemplate.opsForHash().putAll(brandKey, BeanUtil.beanToMap(brand));for (RequestSysDynamicTranslationDTO t : req.getSysDynamicTranslationList()) {SysDynamicTranslationEntity entity = new SysDynamicTranslationEntity();entity.setEntityType("product_brand");entity.setEntityId(brand.getId());entity.setLanguageCode(t.getLanguageCode());entity.setFieldName(t.getFieldName());entity.setFieldValue(t.getFieldValue());entity.setCreator(userId);entity.setCreateDate(System.currentTimeMillis());translationDao.insert(entity);String i18nKey = "i18n:product_brand:" + brand.getId() + ":" + t.getLanguageCode();redisTemplate.opsForHash().put(i18nKey, t.getFieldName(), t.getFieldValue());
}redisTemplate.opsForList().rightPush("pms:brand:list:enabled", String.valueOf(brand.getId()));

}

2️⃣ 修改品牌（Update）

@Transactional
@Override
public void updateBrand(RequestBrandDTO req, Long userId) {
PmsBrandEntity brand = this.getById(req.getId());
if (brand == null) {
throw new RuntimeException("品牌不存在");
}

String defaultLang = redisTemplate.opsForValue().get("sys:lang:default");
String defaultName = req.getSysDynamicTranslationList().stream().filter(t -> defaultLang.equalsIgnoreCase(t.getLanguageCode())).map(RequestSysDynamicTranslationDTO::getFieldValue).findFirst().orElse(brand.getBrandName());brand.setBrandCode(req.getBrandCode());
brand.setBrandName(defaultName);
brand.setBrandImage(req.getBrandImage());
brand.setBrandIndex(req.getBrandIndex());
brand.setSortCode(req.getSortCode());
brand.setIsIcon(req.getIsIcon());
brand.setIconSort(req.getIconSort());
brand.setEnabled(req.getEnabled());
brand.setUpdater(userId);
brand.setUpdateDate(System.currentTimeMillis());
this.updateById(brand);String brandKey = "pms:brand:" + brand.getId();
redisTemplate.delete(brandKey);
redisTemplate.opsForHash().putAll(brandKey, BeanUtil.beanToMap(brand));for (RequestSysDynamicTranslationDTO t : req.getSysDynamicTranslationList()) {SysDynamicTranslationEntity exist = translationDao.findOne("product_brand", brand.getId(), t.getLanguageCode(), t.getFieldName());if (exist == null) {SysDynamicTranslationEntity entity = new SysDynamicTranslationEntity();entity.setEntityType("product_brand");entity.setEntityId(brand.getId());entity.setLanguageCode(t.getLanguageCode());entity.setFieldName(t.getFieldName());entity.setFieldValue(t.getFieldValue());entity.setCreator(userId);entity.setCreateDate(System.currentTimeMillis());translationDao.insert(entity);} else {exist.setFieldValue(t.getFieldValue());exist.setUpdater(userId);exist.setUpdateDate(System.currentTimeMillis());translationDao.updateById(exist);}String i18nKey = "i18n:product_brand:" + brand.getId() + ":" + t.getLanguageCode();redisTemplate.opsForHash().put(i18nKey, t.getFieldName(), t.getFieldValue());
}

}

三、Redis Key 结构设计

1️⃣ pms:brand:{id} → 品牌主缓存（Hash）
2️⃣ pms:brand:list:enabled → 启用品牌ID列表（List）
3️⃣ i18n:product_brand:{id}:{lang} → 品牌多语言翻译缓存（Hash）

四、数据流说明

新增 / 修改品牌数据流：
前端 RequestBrandDTO → Controller → Service
→ 保存 pms_brand 主表（默认语言）
→ 保存 sys_dynamic_translation 多语言翻译
→ 写入 Redis：