字典服务 API

字典服务提供了字典数据的获取和管理功能。

接口列表

接口	方法	说明
/api/dict/item/list/{dictType}	GET	根据字典类型获取字典数据
/api/dict/item/label	GET	根据字典值获取标签
/api/dict/item/refresh/{dictType}	POST	刷新字典缓存

获取字典数据

请求

GET /api/dict/item/list/sys_user_status

响应

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "dictValue": "0",
      "dictLabel": "正常"
    },
    {
      "dictValue": "1",
      "dictLabel": "停用"
    }
  ]
}

获取字典标签

请求

GET /api/dict/item/label?dictType=sys_user_status&dictValue=0

响应

{
  "code": 200,
  "message": "操作成功",
  "data": "正常"
}

前端服务

dictService

import { dictService } from '@/services/dictService'

// 获取字典数据
const dictData = await dictService.getDictData('sys_user_status')

// 获取字典标签
const label = await dictService.getDictLabel('sys_user_status', '0')

// 清除缓存
dictService.clearCache('sys_user_status')

// 刷新缓存
await dictService.refreshCache('sys_user_status')

注意事项

1. 字典数据会被缓存到内存中，避免重复请求
2. 字典变更后需要调用刷新接口更新缓存
3. 支持前端和后端双重缓存