/**
* BladeX Commercial License Agreement
* Copyright (c) 2018-2099, https://bladex.cn. All rights reserved.
*
* Use of this software is governed by the Commercial License Agreement
* obtained after purchasing a license from BladeX.
*
* 1. This software is for development use only under a valid license
* from BladeX.
*
* 2. Redistribution of this software's source code to any third party
* without a commercial license is strictly prohibited.
*
* 3. Licensees may copyright their own code but cannot use segments
* from this software for such purposes. Copyright of this software
* remains with BladeX.
*
* Using this software signifies agreement to this License, and the software
* must not be used for illegal purposes.
*
* THIS SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY. The author is
* not liable for any claims arising from secondary or illegal development.
*
* Author: Chill Zhuang (bladejava@qq.com)
*/
package org.springblade.system.controller;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.github.xiaoymin.knife4j.annotations.ApiOperationSupport;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.v3.oas.annotations.enums.ParameterIn;
import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.v3.oas.annotations.tags.Tag;
import jakarta.validation.Valid;
import lombok.AllArgsConstructor;
import org.springblade.common.constant.CommonConstant;
import org.springblade.core.boot.ctrl.BladeController;
import org.springblade.core.cache.utils.CacheUtil;
import org.springblade.core.mp.support.Condition;
import org.springblade.core.mp.support.Query;
import org.springblade.core.secure.annotation.PreAuth;
import org.springblade.core.tenant.annotation.NonDS;
import org.springblade.core.tool.api.R;
import org.springblade.core.tool.constant.BladeConstant;
import org.springblade.core.tool.utils.StringPool;
import org.springblade.system.pojo.entity.Dict;
import org.springblade.system.service.IDictService;
import org.springblade.system.pojo.vo.DictVO;
import org.springblade.system.wrapper.DictWrapper;
import org.springframework.web.bind.annotation.*;
import java.util.List;
import java.util.Map;
import static org.springblade.core.cache.constant.CacheConstant.DICT_CACHE;
/**
* 控制器
*
* @author Chill
*/
@NonDS
@RestController
@AllArgsConstructor
@RequestMapping("/dict")
@Tag(name = "系统字典", description = "系统字典")
public class DictController extends BladeController {
private final IDictService dictService;
/**
* 详情
*/
@GetMapping("/detail")
@ApiOperationSupport(order = 1)
@Operation(summary = "详情", description = "传入dict")
public R detail(Dict dict) {
Dict detail = dictService.getOne(Condition.getQueryWrapper(dict));
return R.data(DictWrapper.build().entityVO(detail));
}
/**
* 列表
*/
@GetMapping("/list")
@Parameters({
@Parameter(name = "code", description = "字典编号", in = ParameterIn.QUERY, schema = @Schema(type = "string")),
@Parameter(name = "dictValue", description = "字典名称", in = ParameterIn.QUERY, schema = @Schema(type = "string"))
})
@ApiOperationSupport(order = 2)
@Operation(summary = "列表", description = "传入dict")
public R> list(@Parameter(hidden = true) @RequestParam Map dict) {
List list = dictService.list(Condition.getQueryWrapper(dict, Dict.class).lambda().orderByAsc(Dict::getSort));
DictWrapper dictWrapper = new DictWrapper();
return R.data(dictWrapper.listNodeVO(list));
}
/**
* 顶级列表
*/
@GetMapping("/parent-list")
@Parameters({
@Parameter(name = "code", description = "字典编号", in = ParameterIn.QUERY, schema = @Schema(type = "string")),
@Parameter(name = "dictValue", description = "字典名称", in = ParameterIn.QUERY, schema = @Schema(type = "string"))
})
@ApiOperationSupport(order = 3)
@Operation(summary = "列表", description = "传入dict")
public R> parentList(@Parameter(hidden = true) @RequestParam Map dict, Query query) {
return R.data(dictService.parentList(dict, query));
}
/**
* 子列表
*/
@GetMapping("/child-list")
@Parameters({
@Parameter(name = "code", description = "字典编号", in = ParameterIn.QUERY, schema = @Schema(type = "string")),
@Parameter(name = "dictValue", description = "字典名称", in = ParameterIn.QUERY, schema = @Schema(type = "string")),
@Parameter(name = "parentId", description = "字典名称", in = ParameterIn.QUERY, schema = @Schema(type = "string"))
})
@ApiOperationSupport(order = 4)
@Operation(summary = "列表", description = "传入dict")
public R> childList(@Parameter(hidden = true) @RequestParam Map dict, @RequestParam(required = false, defaultValue = "-1") Long parentId) {
return R.data(dictService.childList(dict, parentId));
}
/**
* 获取字典树形结构
*/
@GetMapping("/tree")
@ApiOperationSupport(order = 5)
@Operation(summary = "树形结构", description = "树形结构")
public R> tree() {
List tree = dictService.tree();
return R.data(tree);
}
/**
* 获取字典树形结构
*/
@GetMapping("/parent-tree")
@ApiOperationSupport(order = 5)
@Operation(summary = "树形结构", description = "树形结构")
public R> parentTree() {
List tree = dictService.parentTree();
return R.data(tree);
}
/**
* 新增或修改
*/
@PreAuth(menu = "dict")
@PostMapping("/submit")
@ApiOperationSupport(order = 6)
@Operation(summary = "新增或修改", description = "传入dict")
public R submit(@Valid @RequestBody Dict dict) {
CacheUtil.clear(DICT_CACHE, Boolean.FALSE);
return R.status(dictService.submit(dict));
}
/**
* 删除
*/
@PreAuth(menu = "dict")
@PostMapping("/remove")
@ApiOperationSupport(order = 7)
@Operation(summary = "删除", description = "传入ids")
public R remove(@Parameter(description = "主键集合", required = true) @RequestParam String ids) {
CacheUtil.clear(DICT_CACHE, Boolean.FALSE);
return R.status(dictService.removeDict(ids));
}
/**
* 获取字典
*/
@GetMapping("/dictionary")
@ApiOperationSupport(order = 8)
@Operation(summary = "获取字典", description = "获取字典")
public R> dictionary(String code) {
List tree = dictService.getList(code);
return R.data(tree);
}
/**
* 获取字典
*/
@GetMapping("/dictionary-full")
@ApiOperationSupport(order = 9)
@Operation(summary = "获取字典", description = "获取字典")
public R> dictionaryFull(String code) {
List tree = dictService.getList(code);
tree.forEach(dict -> dict.setDictValue(dict.getDictKey() + StringPool.SPACE + StringPool.COLON + StringPool.SPACE + dict.getDictValue()));
return R.data(tree);
}
/**
* 获取字典树
*/
@GetMapping("/dictionary-tree")
@ApiOperationSupport(order = 10)
@Operation(summary = "获取字典树", description = "获取字典树")
public R> dictionaryTree(String code) {
List tree = dictService.getList(code);
return R.data(DictWrapper.build().listNodeVO(tree));
}
/**
* 字典键值列表
*/
@GetMapping("/select")
@ApiOperationSupport(order = 11)
@Operation(summary = "字典键值列表", description = "字典键值列表")
public R> select() {
List list = dictService.list(Wrappers.query().lambda().eq(Dict::getParentId, CommonConstant.TOP_PARENT_ID));
list.forEach(dict -> dict.setDictValue(dict.getCode() + StringPool.COLON + StringPool.SPACE + dict.getDictValue()));
return R.data(list);
}
/**
* 字典全列表
*/
@GetMapping("/select-all")
@ApiOperationSupport(order = 12)
@Operation(summary = "字典全列表", description = "字典全列表")
public R> selectAll() {
List list = dictService.list(Wrappers.query().lambda().eq(Dict::getIsDeleted, BladeConstant.DB_NOT_DELETED));
return R.data(list);
}
}