klp-oa/klp-system/src/main/java/com/klp/system/service/ISysDictDataService.java

package com.klp.system.service;

import com.klp.common.core.domain.PageQuery;
import com.klp.common.core.domain.entity.SysDictData;
import com.klp.common.core.page.TableDataInfo;

import java.util.List;

/**
 * 字典 业务层
 *
 * @author Lion Li
 */
public interface ISysDictDataService {


    TableDataInfo<SysDictData> selectPageDictDataList(SysDictData dictData, PageQuery pageQuery);

    /**
     * 根据条件分页查询字典数据
     *
     * @param dictData 字典数据信息
     * @return 字典数据集合信息
     */
    List<SysDictData> selectDictDataList(SysDictData dictData);

    /**
     * 根据字典类型和字典键值查询字典数据信息
     *
     * @param dictType  字典类型
     * @param dictValue 字典键值
     * @return 字典标签
     */
    String selectDictLabel(String dictType, String dictValue);

    /**
     * 根据字典数据ID查询信息
     *
     * @param dictCode 字典数据ID
     * @return 字典数据
     */
    SysDictData selectDictDataById(Long dictCode);

    /**
     * 按字典类型查询字典数据（直查库）。用于 HTTP `/dict/data/type/{type}`，避免 Spring Cache 在无界面操作灌数后仍返回空。
     */
    List<SysDictData> selectDictDataByTypeRealtime(String dictType);

    /**
     * 批量删除字典数据信息
     *
     * @param dictCodes 需要删除的字典数据ID
     */
    void deleteDictDataByIds(Long[] dictCodes);

    /**
     * 新增保存字典数据信息
     *
     * @param dictData 字典数据信息
     * @return 结果
     */
    List<SysDictData> insertDictData(SysDictData dictData);

    /**
     * 修改保存字典数据信息
     *
     * @param dictData 字典数据信息
     * @return 结果
     */
    List<SysDictData> updateDictData(SysDictData dictData);
}