同步操作将从 dromara/easy_trans 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
2021年啦,Mybatis Plus/Jpa的使用越来越多,项目中写SQL越来越少了,有的时候不得已还得写sql,比如: 关联字典,关联其他的表使用外键拿其他表的title/name 等等,为了更优雅的实现id变name/title 字典码变字典描述,easy trans横空出世,通过2个注解就能实现数据翻译,配合自己封装的一些baseService baseController,在配合一些代码生成器插件(比如EasyCode),可真正实现简单的CRUD不写一行代码的目标。
先看效果:
easy trans适用于三种场景
1 我有一个id,但是我需要给客户展示他的title/name 但是我又不想做表关联查询
2 我有一个字典吗 sex 和 一个字典值0 我希望能翻译成 男 给客户展示。
3 我有一组user id 比如 1,2,3 我希望能展示成 张三,李四,王五 给客户
easy trans的三种模式
1 使用redis缓存模式
一般用于分布式/微服务系统,比如我有用户服务和订单服务,在订单列表中需要展示创建人,他们又不是同一个进程,db也不是同一个,可使用redis 翻译模式
2 内存缓存(hashmap)模式
一般用于单体模式,缓存放到hashmap中。
3 非缓存模式
非缓存模式不使用缓存,调用 findbyids方法来获取数据用于翻译,一般用于表数据量比较大,缓存扛不住的情况。
1 、先把maven 引用加上
<dependency>
<groupId>com.fhs-opensource</groupId>
<artifactId>easy-trans-spring-boot-starter</artifactId>
<version>1.0.5</version>
</dependency>
Mybatis plus用户另外还需要加以下扩展:
<dependency>
<groupId>com.fhs-opensource</groupId>
<artifactId>easy_trans_mybatis_plus_extend</artifactId>
<version>1.0.5</version>
</dependency>
JPA 用户另外还需要加以下扩展:
<dependency>
<groupId>com.fhs-opensource</groupId>
<artifactId>easy_trans_jpa_extend</artifactId>
<version>1.0.5</version>
</dependency>
2、如果使用Redis请添加redis的引用(如果之前加过了请不要重复添加)
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
3、在yaml中添加如下配置
easy-trans:
autotrans:
#您的service所在的包 支持通配符比如com.*.**.service.**,他的默认值是com.*.*.service.impl
package: com.fhs.test.service.**
#启用redis缓存
is-enable-redis: true
#yixi
spring:#如果用到redis配置redis连接
redis:
host: 192.168.0.213
port: 6379
password: 123456
database: 0
timeout: 6000
4、如果不使用redis,请在启动类加禁用掉redis的自动配置类
@SpringBootApplication(exclude = { RedisAutoConfiguration.class })
1、字典翻译使用说明---直接上代码了,可以配合InitializingBean一起玩.
1.1 翻译缓存初始化
@Autowired //注入字典翻译服务
private DictionaryTransService dictionaryTransService;
//在某处将字典缓存刷新到翻译服务中,以下是demo
Map<String,String> transMap = new HashMap<>();
transMap.put("0","男");
transMap.put("1","女");
dictionaryTransService.refreshCache("sex",transMap);
1.2 字典翻译使用
//在对应的字段上 加此注解,type为TransType.DICTIONARY,key为字典分组码,ref为选填,如果设置了则会自动将翻译结果设置到此字段上
@Trans(type = TransType.DICTIONARY,key = "sex",ref = "sexName")
private Integer sex;
private String sexName;
2、AutoTrans(除了字典外的其他表翻译)使用说明---直接上代码了
2.1.1 Mybatis plus用户 使用AutoTrans(不是Mybatis plus的请直接看2.1.3 是MP的可以跳过2.1.3)
//mp用户需要设置ref设置po 的class但是不需要实现AutoTransAble接口
@AutoTrans(namespace = "usermp",fields = "name",
defaultAlias = "user",ref = UserMp.class)
public interface UserMapperMp extends BaseMapper<UserMp> {
}
2.1.2 SpringDataJPA用户 使用AutoTrans
@Repository
@AutoTrans(namespace = "school",useCache = true,fields = "schoolName",ref = School.class)
public interface SchoolRepository extends JpaRepository<School,String> {
}
2.1.3 如果不是用jpa/mybatis plus的话需要在 service实现类改动,主要2个点1是添加AutoTrans注解,2 是实现AutoTransAble 接口
@Service
@AutoTrans(namespace = "teacher",fields = "name",defaultAlias = "teacher",useCache = true,useRedis = true)
//namespace = 表别名 fields = 哪些字段需要出现在翻译结果中这里写了name defaultAlias =默认别名,比如我这里有个name字段别的表也有个name字段,为了区分这里配置为teacher 在翻译结果中 就会出现teacherName 而不是name useCache = 是否使用缓存 useRedis = 是否使用redis缓存
public class TeacherService implements AutoTransAble {
//在不使用缓存的时候使用,如果transMore的时候会拼接teacherid集合,调用此方法获取id集合对应的teacher对象
public List<P> findByIds(List<?> ids) {
//推荐使用JPA/Mybatis Plus的方法哦
return this.baseMapper.selectBatchIds(ids);
}
// 在开启缓存的时候,springboot启动完成后会拿所有数据放到缓存里
@Override
public List select() {
return this.baseMapper.selectList((Wrapper)null)
}
// 在不开启缓存的时候,transone会通过此方法获取翻译数据
@Override
public VO selectById(Object primaryValue) {
return this.baseMapper.selectById(primaryValue);
}
以上,建议在baseservice中添加以上几个方法,这样子service就不用每个都写了。
2.2 Autotrans翻译使用
//指定翻译的namespace,和翻译类型为TransType.AUTO_TRANS
@Trans(type = TransType.AUTO_TRANS,key = "teacher")
private String teacherId;
//如果有2个teacherid 可以通过namespace#别名 来起别名区分
@Trans(type = TransType.AUTO_TRANS,key = "teacher#english")
private String englishteacherId;
//同样支持ref ,将字翻译结果赋值到某个字段上
@Trans(type = TransType.AUTO_TRANS,key = "teacher",ref = "teacherName")
private String teacherId;
private String teacherName;
//如果teacher 对外开放了多个字段当做翻译结果,比如 name和age,我这里只要age ref可以同如下写法
@Trans(type = TransType.AUTO_TRANS,key = "teacher#english",ref = "engTeacherAge#age")
private String englishteacherId;
private String engTeacherAge;
3、POJO修改 a 实现TransPojo接口(Teacher类也要实现哦),提供一个transMap(可选),框架会把翻译结果put到这个map中,建议使用basePOJO 的方法来实现
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class Student implements TransPojo {
private String studentName;
@Trans(type = TransType.AUTO_TRANS,key = "teacher",ref = "teacherName")
private String teacherId;
private String teacherName;
@Trans(type = TransType.AUTO_TRANS,key = "teacher#english",ref = "engTeacherAge#age")
private String englishteacherId;
private String engTeacherAge;
@Trans(type = TransType.DICTIONARY,key = "sex",ref = "sexName")
private Integer sex;
private String sexName;
//transMap是可选的,加了就会把所有的翻译结果都扔到这里,可以偷懒不定义那么多字段了,@Trans注解也就可以不写ref属性了
public Map<String,String> transMap = new HashMap<>();
}
4、框架中没有使用JPA/Mybatis Plus怎么办
//TransPojo中有一个getPkey 方法默认是找@Id 或者 @TableId 标识的字段,如果没有使用JPA/Mybatis Plus 可重写此方法返回表主键的值比如 return this.id;
@JsonIgnore
@JSONField(serialize = false)
default Object getPkey(){
Field idField = getIdField(true);
try {
return idField.get(this);
} catch (IllegalAccessException e) {
return null;
}
}
5、准备工作已经完成,最后一步,使用翻译服务进行翻译
@Autowired
private TransService transService;
@Test
public void transOne(){
Student student = new Student();
student.setStudentName("张三");
student.setTeacherId("1");
student.setEnglishteacherId("2");
student.setSex(1);
//翻译一个对象
transService.transOne(student);
System.out.println(JsonUtils.bean2json(student));
}
@Test
public void transMore(){
Student student = new Student();
student.setStudentName("张三");
student.setTeacherId("1");
student.setEnglishteacherId("2");
student.setSex(1);
List<Student> studentList = new ArrayList<>();
studentList.add(student);
//翻译多个对象
transService.transMore(studentList);
System.out.println(JsonUtils.list2json(studentList));
}
@TransMethodResult //加了注解就可以不用手动调用transService的方法了
public Student getStudent(){
Student student = new Student();
student.setStudentName("张三");
student.setTeacherId("1");
student.setFriendUserId("1");
student.setEnglishteacherId("2");
student.setSex(1);
return student;
}
6、缓存刷新
6.1 非集群模式下的缓存刷新
调用AutoTransService的refreshOneNamespace(String namespace)
map中put一个namespace 为teacher的话,就代表刷新teacher的缓存,如果map中什么都不put代表刷新所有缓存。
6.2 集群模式下的缓存刷新(必须开启redis支持才可以)
@Autowired
private RedisCacheService redisCacheService;
Map<String, String> message = new HashMap();
message.put("transType", "auto");
message.put("namespace", "teacher");
this.redisCacheService.convertAndSend("trans", JsonUtils.map2json(message));
7、DEMO https://gitee.com/fhs-opensource/easy_trans_springboot_demo
教程看起来挺麻烦,只需要做2处封装,使用起来就很简单了,第一就是baseserivce的封装(主要提供那三个获取翻译数据的方法 和 缓存刷新的方法),第二就是base pojo的封装(主要是getTransMap 给翻译服务返回一个hashmap用来装填数据用),作者已经和ruoyi guns 做好了对接,需要资料什么的可以直接加群联系作者。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。