package cn.lihu.jh.module.system.api.dict;
|
|
import cn.hutool.core.util.ObjUtil;
|
import cn.hutool.core.util.StrUtil;
|
import cn.lihu.jh.module.system.api.dict.dto.DictDataRespDTO;
|
|
import java.util.Collection;
|
import java.util.List;
|
|
import static cn.lihu.jh.framework.common.util.collection.CollectionUtils.convertList;
|
|
/**
|
* 字典数据 API 接口
|
*
|
* @author 芋道源码
|
*/
|
public interface DictDataApi {
|
|
/**
|
* 校验字典数据们是否有效。如下情况，视为无效：
|
* 1. 字典数据不存在
|
* 2. 字典数据被禁用
|
*
|
* @param dictType 字典类型
|
* @param values 字典数据值的数组
|
*/
|
void validateDictDataList(String dictType, Collection<String> values);
|
|
/**
|
* 获得指定的字典数据，从缓存中
|
*
|
* @param type 字典类型
|
* @param value 字典数据值
|
* @return 字典数据
|
*/
|
DictDataRespDTO getDictData(String type, String value);
|
|
/**
|
* 获得指定的字典标签，从缓存中
|
*
|
* @param type 字典类型
|
* @param value 字典数据值
|
* @return 字典标签
|
*/
|
default String getDictDataLabel(String type, Integer value) {
|
DictDataRespDTO dictData = getDictData(type, String.valueOf(value));
|
if (ObjUtil.isNull(dictData)) {
|
return StrUtil.EMPTY;
|
}
|
return dictData.getLabel();
|
}
|
|
/**
|
* 解析获得指定的字典数据，从缓存中
|
*
|
* @param type 字典类型
|
* @param label 字典数据标签
|
* @return 字典数据
|
*/
|
DictDataRespDTO parseDictData(String type, String label);
|
|
/**
|
* 获得指定字典类型的字典数据列表
|
*
|
* @param dictType 字典类型
|
* @return 字典数据列表
|
*/
|
List<DictDataRespDTO> getDictDataList(String dictType);
|
|
/**
|
* 获得字典数据标签列表
|
*
|
* @param dictType 字典类型
|
* @return 字典数据标签列表
|
*/
|
default List<String> getDictDataLabelList(String dictType) {
|
List<DictDataRespDTO> list = getDictDataList(dictType);
|
return convertList(list, DictDataRespDTO::getLabel);
|
}
|
|
}
|
