接口文档描述修改

yangys

2025-07-09 785f3d5be63e723a947a2b35dc0ca89297073d7f

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
/**
 * BladeX Commercial License Agreement
 * Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
 * <p>
 * Use of this software is governed by the Commercial License Agreement
 * obtained after purchasing a license from BladeX.
 * <p>
 * 1. This software is for development use only under a valid license
 * from BladeX.
 * <p>
 * 2. Redistribution of this software's source code to any third party
 * without a commercial license is strictly prohibited.
 * <p>
 * 3. Licensees may copyright their own code but cannot use segments
 * from this software for such purposes. Copyright of this software
 * remains with BladeX.
 * <p>
 * Using this software signifies agreement to this License, and the software
 * must not be used for illegal purposes.
 * <p>
 * THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
 * not liable for any claims arising from secondary or illegal development.
 * <p>
 * Author: Chill Zhuang (bladejava@qq.com)
 */
package org.springblade.system.cache;
 
import org.springblade.core.cache.utils.CacheUtil;
import org.springblade.core.secure.utils.AuthUtil;
import org.springblade.core.tool.api.R;
import org.springblade.core.tool.utils.SpringUtil;
import org.springblade.core.tool.utils.StringPool;
import org.springblade.system.pojo.entity.DictBiz;
import org.springblade.system.pojo.enums.DictBizEnum;
import org.springblade.system.feign.IDictBizClient;
 
import java.util.List;
 
import static org.springblade.core.cache.constant.CacheConstant.DICT_CACHE;
 
/**
 * 业务字典缓存工具类
 *
 * @author Chill
 */
public class DictBizCache {
 
    private static final String DICT_ID = "dictBiz:id";
    private static final String DICT_VALUE = "dictBiz:value";
    private static final String DICT_LIST = "dictBiz:list";
 
    private static IDictBizClient dictClient;
 
    private static IDictBizClient getDictClient() {
        if (dictClient == null) {
            dictClient = SpringUtil.getBean(IDictBizClient.class);
        }
        return dictClient;
    }
 
    /**
     * 获取字典实体
     *
     * @param id 主键
     * @return DictBiz
     */
    public static DictBiz getById(Long id) {
        String keyPrefix = DICT_ID.concat(StringPool.DASH).concat(AuthUtil.getTenantId()).concat(StringPool.COLON);
        return CacheUtil.get(DICT_CACHE, keyPrefix, id, () -> {
            R<DictBiz> result = getDictClient().getById(id);
            return result.getData();
        });
    }
 
    /**
     * 获取字典值
     *
     * @param code    字典编号枚举
     * @param dictKey Integer型字典键
     * @return String
     */
    public static String getValue(DictBizEnum code, Integer dictKey) {
        return getValue(code.getName(), dictKey);
    }
 
 
    /**
     * 获取字典值
     *
     * @param code    字典编号
     * @param dictKey Integer型字典键
     * @return String
     */
    public static String getValue(String code, Integer dictKey) {
        String keyPrefix = DICT_VALUE.concat(StringPool.DASH).concat(AuthUtil.getTenantId()).concat(StringPool.COLON);
        return CacheUtil.get(DICT_CACHE, keyPrefix + code + StringPool.COLON, String.valueOf(dictKey), () -> {
            R<String> result = getDictClient().getValue(code, String.valueOf(dictKey));
            return result.getData();
        });
    }
 
    /**
     * 获取字典值
     *
     * @param code    字典编号枚举
     * @param dictKey String型字典键
     * @return String
     */
    public static String getValue(DictBizEnum code, String dictKey) {
        return getValue(code.getName(), dictKey);
    }
 
    /**
     * 获取字典值
     *
     * @param code    字典编号
     * @param dictKey String型字典键
     * @return String
     */
    public static String getValue(String code, String dictKey) {
        String keyPrefix = DICT_VALUE.concat(StringPool.DASH).concat(AuthUtil.getTenantId()).concat(StringPool.COLON);
        return CacheUtil.get(DICT_CACHE, keyPrefix + code + StringPool.COLON, dictKey, () -> {
            R<String> result = getDictClient().getValue(code, dictKey);
            return result.getData();
        });
    }
 
    /**
     * 获取字典集合
     *
     * @param code 字典编号
     * @return List<DictBiz>
     */
    public static List<DictBiz> getList(String code) {
        String keyPrefix = DICT_LIST.concat(StringPool.DASH).concat(AuthUtil.getTenantId()).concat(StringPool.COLON);
        return CacheUtil.get(DICT_CACHE, keyPrefix, code, () -> {
            R<List<DictBiz>> result = getDictClient().getList(code);
            return result.getData();
        });
    }
 
}