package com.iailab.module.system.api.dict; import cn.hutool.core.util.ObjUtil; import cn.hutool.core.util.StrUtil; import io.swagger.v3.oas.annotations.tags.Tag; import io.swagger.v3.oas.annotations.Parameter; import io.swagger.v3.oas.annotations.Parameters; import io.swagger.v3.oas.annotations.Operation; import com.iailab.framework.common.pojo.CommonResult; import com.iailab.module.system.api.dict.dto.DictDataRespDTO; import com.iailab.module.system.enums.ApiConstants; import org.springframework.cloud.openfeign.FeignClient; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import java.util.Collection; import java.util.List; import static com.iailab.framework.common.util.collection.CollectionUtils.convertList; @FeignClient(name = ApiConstants.NAME) @Tag(name = "RPC æœåŠ¡ - å—典数æ®") public interface DictDataApi { String PREFIX = ApiConstants.PREFIX + "/dict-data"; @GetMapping(PREFIX + "/valid") @Operation(summary = "æ ¡éªŒå—典数æ®ä»¬æ˜¯å¦æœ‰æ•ˆ") @Parameters({ @Parameter(name = "dictType", description = "å—典类型", example = "SEX", required = true), @Parameter(name = "descriptions", description = "å—典数æ®å€¼çš„数组", example = "1,2", required = true) }) CommonResult<Boolean> validateDictDataList(@RequestParam("dictType") String dictType, @RequestParam("values") Collection<String> values); @GetMapping(PREFIX + "/get") @Operation(summary = "获得指定的å—典数æ®") @Parameters({ @Parameter(name = "dictType", description = "å—典类型", example = "SEX", required = true), @Parameter(name = "description", description = "å—典数æ®å€¼", example = "1", required = true) }) CommonResult<DictDataRespDTO> getDictData(@RequestParam("dictType") String dictType, @RequestParam("value") String value); /** * 获得指定的å—å…¸æ ‡ç¾ï¼Œä»Žç¼“å˜ä¸ * * @param type å—典类型 * @param value å—典数æ®å€¼ * @return å—å…¸æ ‡ç¾ */ default String getDictDataLabel(String type, Integer value) { DictDataRespDTO dictData = getDictData(type, String.valueOf(value)).getData(); if (ObjUtil.isNull(dictData)) { return StrUtil.EMPTY; } return dictData.getLabel(); } @GetMapping(PREFIX + "/parse") @Operation(summary = "解æžèŽ·å¾—指定的å—典数æ®") @Parameters({ @Parameter(name = "dictType", description = "å—典类型", example = "SEX", required = true), @Parameter(name = "label", description = "å—å…¸æ ‡ç¾", example = "ç”·", required = true) }) CommonResult<DictDataRespDTO> parseDictData(@RequestParam("dictType") String dictType, @RequestParam("label") String label); @GetMapping(PREFIX + "/list") @Operation(summary = "获得指定å—典类型的å—典数æ®åˆ—表") @Parameter(name = "dictType", description = "å—典类型", example = "SEX", required = true) CommonResult<List<DictDataRespDTO>> getDictDataList(@RequestParam("dictType") String dictType); /** * 获得å—典数æ®æ ‡ç¾åˆ—表 * * @param dictType å—典类型 * @return å—典数æ®æ ‡ç¾åˆ—表 */ default List<String> getDictDataLabelList(String dictType) { List<DictDataRespDTO> list = getDictDataList(dictType).getData(); return convertList(list, DictDataRespDTO::getLabel); } }