在设计Restful接口时,一些字典数据为了更符合用户使用习惯,需要转换成对应的字典值。比如创建用户,数据库存的都是用户id,而页面需要展示用户的真实姓名。再比如一些状态,数据库存的可能是一些数字,需要页面上展示对应的状态描述。原则上应该由前端来调用字典接口进行转换,但有时为了降低前端的开发工作量,需要后端转换完成后返回给前端(仅针对前端开发资源不足的情况下,不推荐)
故基于springboot的返参解析机制,在处理返回结果时,检查返回对象中是否有@Dict注解,如有则基于返回对象类创建一个新的的类,添加被@Dict注解的字段,字段名为在原字段名后面拼了一个Label,然后创建对象并赋值。下面是具体代码实现。
新建一个@Dict注解,用来配置字典相关信息
@Target({
ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Dict {
String dictName() default "";
Class<? extends BaseMapping> mappingClass() default StaticDictMapping.class;
}
public interface BaseMapping {
Object mapping(Object o, String dictName, String propertyName);
}
这里给一个静态字典的实现
@Component
public class StaticDictMapping implements BaseMapping {
@Autowired
private IDictDataService dictDataService;
@Override
public Object mapping(Object o, String dictName, String propertyName) {
if (Objects.isNull(o) || StringUtils.isEmpty(dictName)) {
return o;
}
return dictDataService.getDictDataPojo(dictName, o.toString()).getDictLabel();
}
}
这里再给一个动态字典的实现
@Service
public class UserServiceImpl implements IUserService, BaseMapping {
@Autowired
private UserDao userDao;
@Override
public UserPojo queryUserByUserId(Long userId) {
return userDao.queryUserByUserId(userId);
}
@Override
public Object mapping(Object o, String dictName, String propertyName) {
if (Objects.equals(dictName, "batchQuery")) {
List<Long