package com.vci.web.service;


import com.vci.pagemodel.BdSelectInputCharVO;
import com.vci.dto.BdSelectInputCharDTO;
import com.vci.model.BdSelectInputCharDO;
import com.vci.pagemodel.KeyValue;
import com.vci.starter.web.exception.VciBaseException;
import com.vci.starter.web.pagemodel.*;


import java.util.*;

/**
 * 可输可选内容服务接口
 *
 * @author weidy
 * @date 2022-03-09
 */
public interface BdSelectInputCharServiceI {
    /**
     * 查询所有的可输可选内容
     * @param conditionMap 查询条件
     * @param pageHelper 分页和排序
     * @return 执行结果
     * @throws VciBaseException 查询条件和分页出错的时候会抛出异常
     */
    DataGrid<BdSelectInputCharVO> gridBdSelectInputChar(Map<String, String> conditionMap, PageHelper pageHelper) throws VciBaseException;


    /**
     * 批量数据对象转换为显示对象
     * @param bdSelectInputCharDOs 数据对象列表
     * @return 显示对象
     * @throws VciBaseException 参数为空或者不存在的时候会抛出异常
     */
    List<BdSelectInputCharVO> bdSelectInputCharDO2VOs(Collection<BdSelectInputCharDO>  bdSelectInputCharDOs) throws VciBaseException;

    /**
     * 数据对象转换为显示对象
     * @param  bdSelectInputCharDO 数据对象
     * @return 显示对象
     * @throws VciBaseException 拷贝属性出错的时候会抛出异常
     */
    BdSelectInputCharVO bdSelectInputCharDO2VO(BdSelectInputCharDO bdSelectInputCharDO) throws VciBaseException;

    /**
     * 增加可输可选内容
     * @param bdSelectInputCharDTO 可输可选内容数据传输对象
     * @return 执行结果
     * @throws VciBaseException 参数为空，唯一项，必输项不通过时会抛出异常
     */
    BdSelectInputCharVO addSave(BdSelectInputCharDTO bdSelectInputCharDTO) throws VciBaseException;

    /**
     * 修改可输可选内容
     * @param bdSelectInputCharDTO 可输可选内容数据传输对象
     * @return 执行结果
     * @throws VciBaseException 参数为空，唯一项，必输项不通过时会抛出异常
     */
    BdSelectInputCharVO editSave(BdSelectInputCharDTO bdSelectInputCharDTO) throws VciBaseException;


    /**
     * 删除可输可选内容
     * @param bdSelectInputCharDTO 可输可选内容数据传输对象，oid和ts需要传输
     * @return 删除结果反馈：：success：成功，fail：失败
     * @throws VciBaseException 参数为空，被引用时抛出异常
     */
    BaseResult deleteBdSelectInputChar(BdSelectInputCharDTO bdSelectInputCharDTO) throws VciBaseException;

    /**
    * 主键获取可输可选内容
    * @param oid 主键
    * @return 可输可选内容显示对象
    * @throws VciBaseException 参数为空，数据不存在时会抛出异常
    */
    BdSelectInputCharVO getObjectByOid(String oid) throws VciBaseException;

    /**
     * 主键批量获取可输可选内容
     * @param oidCollections 主键集合，但是受性能影响，建议一次查询不超过10000个
     * @return 可输可选内容显示对象
     * @throws VciBaseException 查询出现异常时会抛出
     */
    Collection<BdSelectInputCharVO> listBdSelectInputCharByOids(Collection<String> oidCollections) throws VciBaseException;



    /**
     * 参照可输可选内容列表
     * @param conditionMap 查询条件
     * @param pageHelper 分页和排序
     * @return 可输可选内容显示对象列表，生效的内容
     * @throws VciBaseException 查询条件和分页出错的时候会抛出异常
     */
     DataGrid<BdSelectInputCharVO> refDataGridBdSelectInputChar(Map<String, String> conditionMap, PageHelper pageHelper) throws VciBaseException;

    /**
     * 获取可选择的列表
     * @param flag 标记
     * @param namespace 命名空间
     * @return 包含的内容
     */
    List<KeyValue> listByFlag(String namespace,String flag);

    /**
     * 存储
     * @param namespace 命名空间
     * @param flag 标识
     * @param value 值
     * @param sessionInfo 会话信息
     */
    void save(String namespace,String flag,String value,SessionInfo sessionInfo);

    /**
     * 相同命名空间的存储
     * @param namespace 命名空间
     * @param flagValueMap key是标识，value是值
     * @param sessionInfo 会话信息
     */
    void saveBySameNamespace(String namespace,Map<String/**flag**/,String/**值**/> flagValueMap,SessionInfo sessionInfo);

    /**
     * 相同命名空间和相同标识的存储
     * @param namespace 命名空间
     * @param flag 标记
     * @param values 值集合
     * @param sessionInfo 会话信息
     */
    void saveBySameNamespaceAndFlag(String namespace,String flag,Collection<String> values,SessionInfo sessionInfo);
}