| 提交 | 用户 | 时间 | ||
| e7c126 | 1 | package com.iailab.module.system.api.dict; |
| H | 2 | |
| 8633f8 | 3 | import cn.hutool.core.util.ObjUtil; |
| H | 4 | import cn.hutool.core.util.StrUtil; |
| e7c126 | 5 | import io.swagger.v3.oas.annotations.tags.Tag; |
| H | 6 | import io.swagger.v3.oas.annotations.Parameter; |
| 7 | import io.swagger.v3.oas.annotations.Parameters; | |
| 8 | import io.swagger.v3.oas.annotations.Operation; | |
| 9 | import com.iailab.framework.common.pojo.CommonResult; | |
| 10 | import com.iailab.module.system.api.dict.dto.DictDataRespDTO; | |
| 11 | import com.iailab.module.system.enums.ApiConstants; | |
| 12 | import org.springframework.cloud.openfeign.FeignClient; | |
| 13 | import org.springframework.web.bind.annotation.GetMapping; | |
| 14 | import org.springframework.web.bind.annotation.RequestParam; | |
| 15 | ||
| 16 | import java.util.Collection; | |
| 17 | import java.util.List; | |
| 18 | ||
| 19 | import static com.iailab.framework.common.util.collection.CollectionUtils.convertList; | |
| 20 | ||
| 1ecdfb | 21 | @FeignClient(name = ApiConstants.NAME) |
| e7c126 | 22 | @Tag(name = "RPC 服务 - 字典数据") |
| H | 23 | public interface DictDataApi { |
| 24 | ||
| 25 | String PREFIX = ApiConstants.PREFIX + "/dict-data"; | |
| 26 | ||
| 27 | @GetMapping(PREFIX + "/valid") | |
| 28 | @Operation(summary = "校验字典数据们是否有效") | |
| 29 | @Parameters({ | |
| 30 | @Parameter(name = "dictType", description = "字典类型", example = "SEX", required = true), | |
| 31 | @Parameter(name = "descriptions", description = "字典数据值的数组", example = "1,2", required = true) | |
| 32 | }) | |
| 33 | CommonResult<Boolean> validateDictDataList(@RequestParam("dictType") String dictType, | |
| 34 | @RequestParam("values") Collection<String> values); | |
| 35 | ||
| 36 | @GetMapping(PREFIX + "/get") | |
| 37 | @Operation(summary = "获得指定的字典数据") | |
| 38 | @Parameters({ | |
| 39 | @Parameter(name = "dictType", description = "字典类型", example = "SEX", required = true), | |
| 40 | @Parameter(name = "description", description = "字典数据值", example = "1", required = true) | |
| 41 | }) | |
| 42 | CommonResult<DictDataRespDTO> getDictData(@RequestParam("dictType") String dictType, | |
| 43 | @RequestParam("value") String value); | |
| 44 | ||
| 8633f8 | 45 | /** |
| H | 46 | * 获得指定的字典标签，从缓存中 |
| 47 | * | |
| 48 | * @param type 字典类型 | |
| 49 | * @param value 字典数据值 | |
| 50 | * @return 字典标签 | |
| 51 | */ | |
| 52 | default String getDictDataLabel(String type, Integer value) { | |
| 53 | DictDataRespDTO dictData = getDictData(type, String.valueOf(value)).getData(); | |
| 54 | if (ObjUtil.isNull(dictData)) { | |
| 55 | return StrUtil.EMPTY; | |
| 56 | } | |
| 57 | return dictData.getLabel(); | |
| 58 | } | |
| 59 | ||
| e7c126 | 60 | @GetMapping(PREFIX + "/parse") |
| H | 61 | @Operation(summary = "解析获得指定的字典数据") |
| 62 | @Parameters({ | |
| 63 | @Parameter(name = "dictType", description = "字典类型", example = "SEX", required = true), | |
| 64 | @Parameter(name = "label", description = "字典标签", example = "男", required = true) | |
| 65 | }) | |
| 66 | CommonResult<DictDataRespDTO> parseDictData(@RequestParam("dictType") String dictType, | |
| 67 | @RequestParam("label") String label); | |
| 68 | ||
| 69 | @GetMapping(PREFIX + "/list") | |
| 70 | @Operation(summary = "获得指定字典类型的字典数据列表") | |
| 71 | @Parameter(name = "dictType", description = "字典类型", example = "SEX", required = true) | |
| 72 | CommonResult<List<DictDataRespDTO>> getDictDataList(@RequestParam("dictType") String dictType); | |
| 73 | ||
| 74 | /** | |
| 75 | * 获得字典数据标签列表 | |
| 76 | * | |
| 77 | * @param dictType 字典类型 | |
| 78 | * @return 字典数据标签列表 | |
| 79 | */ | |
| 80 | default List<String> getDictDataLabelList(String dictType) { | |
| 81 | List<DictDataRespDTO> list = getDictDataList(dictType).getData(); | |
| 82 | return convertList(list, DictDataRespDTO::getLabel); | |
| 83 | } | |
| 84 | ||
| 85 | } | |
