package com.vci.web.service;

import com.vci.pagemodel.VciFileObjectVO;
import com.vci.starter.web.exception.VciBaseException;
import com.vci.starter.web.pagemodel.DataGrid;
import com.vci.starter.web.pagemodel.PageHelper;

import java.util.Collection;
import java.util.List;
import java.util.Map;

/**
 * 文件查询服务
 * 从208项目拷贝过来后修改
 * @author weidy
 * @date 2020/3/11
 */
public interface VciFileQueryServiceI {

    /**
     * 根据主键获取文件对象，不过滤密级
     * @param fileOid 文件的主键
     * @return 文件的显示对象
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    VciFileObjectVO getFileObjectByOid(String fileOid) throws VciBaseException;

    /**
     * 根据主键获取文件对象，不过滤密级
     * @param fileOidCollection 文件主键的集合
     * @return 文件的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    List<VciFileObjectVO> listFileObjectByOids(Collection<String> fileOidCollection) throws VciBaseException;

    /**
     * 根据主键获取文件对象
     * @param fileOidCollection 文件主键的集合
     * @param filterSecret 过滤文件的密级
     * @return 文件的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    List<VciFileObjectVO> listFileObjectByOids(Collection<String> fileOidCollection,boolean filterSecret) throws VciBaseException;

    /**
     * 根据主键获取文件对象，不过滤密级
     * @param fileOidCollection 文件主键的集合
     * @param fileIdTypeCollection 过滤文档的类型
     * @return 文件的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    List<VciFileObjectVO> listFileObjectByOids(Collection<String> fileOidCollection,Collection<String> fileIdTypeCollection) throws VciBaseException;

    /**
     * 根据主键获取文件对象
     * @param fileOidCollection 文件主键的集合
     * @param filterSecret 过滤文件的密级
     * @param fileIdTypeCollection 过滤文件的类型
     * @return 文件的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    List<VciFileObjectVO> listFileObjectByOids(Collection<String> fileOidCollection,boolean filterSecret,Collection<String> fileIdTypeCollection) throws VciBaseException;

    /**
     * 通过业务数据来获取对应的文件
     * @param ownBtmName 业务类型
     * @param ownBizoid 数据主键
     * @return 文件的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    List<VciFileObjectVO> listFileObjectByOwnData(String ownBtmName, String ownBizoid) throws VciBaseException;

    /**
     * 通过业务数据来获取对应的文件
     * @param ownBtmName 业务类型
     * @param ownBizoid 业务数据
     * @param filterSecret 过滤文件密级
     * @return 文件的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    List<VciFileObjectVO> listFileObjectByOwnData(String ownBtmName, String ownBizoid,boolean filterSecret) throws VciBaseException;

    /**
     * 通过业务数据来获取对应的文件
     * @param ownBtmName 业务类型
     * @param ownBizoid 业务数据
     * @param filterSecret 过滤文件密级
     * @param fileIdTypeCollection 过滤文件的类型
     * @return 文件的显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    List<VciFileObjectVO> listFileObjectByOwnData(String ownBtmName, String ownBizoid,boolean filterSecret,Collection<String> fileIdTypeCollection) throws VciBaseException;

    /**
     * 批量获取业务数据中关联的文件,不过滤文件密级
     * @param bizOidMapBtmName 业务数据主键（key)和业务类型(value)的映射
     * @return 文件的显示对象列表映射,key是业务类型的名称，value是文件显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    Map<String,List<VciFileObjectVO>> batchListFileObjectByOwnData(Map<String, String> bizOidMapBtmName) throws VciBaseException;

    /**
     * 批量获取业务数据中关联的文件,不过滤文件密级
     * @param bizOidMapBtmName 业务数据主键（key)和业务类型(value)的映射
     * @param filterSecret 过滤文件密级
     * @return 文件的显示对象列表映射,key是业务类型的名称，value是文件显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    Map<String,List<VciFileObjectVO>> batchListFileObjectByOwnData(Map<String, String> bizOidMapBtmName,boolean filterSecret) throws VciBaseException;

    /**
     * 批量获取业务数据中关联的文件,不过滤文件密级
     * @param bizOidMapBtmName 业务数据主键（key)和业务类型(value)的映射
     * @param filterSecret 过滤文件密级
     * @param fileIdTypeCollection 过滤文件的类型
     * @return 文件的显示对象列表映射,key是业务类型的名称，value是文件显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    Map<String,List<VciFileObjectVO>> batchListFileObjectByOwnData(Map<String, String> bizOidMapBtmName,boolean filterSecret,Collection<String> fileIdTypeCollection) throws VciBaseException;

    /**
     * 校验业务数据中是否存在指定的文件主键
     * @param ownBtmName 业务类型
     * @param ownBizOid 业务数据主键
     * @param oidLists 文件的主键 集合
     * @return 文件某个主键不在业务类型中就会返回false，否则返回true
     * @throws VciBaseException 参数为空或者查询出错的时候抛出这个异常
     */
    boolean checkFilesExistInOwnBiz(String ownBtmName, String ownBizOid, Collection<String> oidLists) throws VciBaseException;

    /**
     * 获取文件的列表数据
     * @param conditionMap 查询数据
     * @param pageHelper 分页，排序信息
     * @return 文件显示对象列表
     * @throws VciBaseException 参数为空或者查询出错的时候会抛出这个异常
     */
    DataGrid<VciFileObjectVO> gridFileObject(Map<String,String> conditionMap, PageHelper pageHelper) throws VciBaseException;

}