package org.xyzh.file.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;

import java.util.List;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.annotations.Update;
import org.xyzh.api.file.dto.TbSysFileDTO;

/**
 * @description 文件Mapper接口
 * @filename FileMapper.java
 * @author yslg
 * @copyright yslg
 * @since 2025-12-09
 */
@Mapper
public interface FileMapper extends BaseMapper<TbSysFileDTO> {
    
    /**
     * 根据文件ID查询文件信息（自定义方法替代selectById）
     * @param fileId 文件ID
     * @return 文件信息
     */
    @Select("SELECT * FROM file.tb_sys_file WHERE file_id = #{fileId} AND deleted = false")
    TbSysFileDTO selectByFileId(@Param("fileId") String fileId);
    
    /**
     * 插入文件记录（自定义方法）
     * @param fileDTO 文件DTO
     * @return 影响行数
     */
    int insertFile(TbSysFileDTO fileDTO);
    
    /**
     * 根据文件ID更新文件信息（自定义方法替代updateById）
     * @param fileDTO 文件DTO
     * @return 影响行数
     */
    int updateByFileId(TbSysFileDTO fileDTO);
    
    /**
     * 根据文件ID逻辑删除文件（自定义方法）
     * @param fileId 文件ID
     * @param updater 更新者
     * @return 影响行数
     */
    @Update("UPDATE file.tb_sys_file SET deleted = true, delete_time = CURRENT_TIMESTAMP, updater = #{updater} WHERE file_id = #{fileId}")
    int deleteByFileId(@Param("fileId") String fileId, @Param("updater") String updater);
    
    /**
     * 根据模块和业务ID查询文件列表
     * @param module 模块
     * @param businessId 业务ID
     * @return 文件列表
     */
    @Select("SELECT * FROM file.tb_sys_file WHERE module = #{module} AND business_id = #{businessId} AND deleted = false ORDER BY create_time DESC")
    List<TbSysFileDTO> selectByModuleAndBusinessId(@Param("module") String module, @Param("businessId") String businessId);
    
    /**
     * 根据上传者查询文件列表
     * @param uploader 上传者用户ID
     * @return 文件列表
     */
    @Select("SELECT * FROM file.tb_sys_file WHERE uploader = #{uploader} AND deleted = false ORDER BY create_time DESC")
    List<TbSysFileDTO> selectByUploader(@Param("uploader") String uploader);
    
    /**
     * 根据MD5查询文件（用于防重复上传）
     * @param md5Hash MD5哈希值
     * @return 文件信息
     */
    @Select("SELECT * FROM file.tb_sys_file WHERE md5_hash = #{md5Hash} AND deleted = false LIMIT 1")
    TbSysFileDTO selectByMd5Hash(@Param("md5Hash") String md5Hash);
    
    /**
     * 根据MinIO对象名称查询文件
     * @param bucketName 存储桶名称
     * @param objectName 对象名称
     * @return 文件信息
     */
    @Select("SELECT * FROM file.tb_sys_file WHERE bucket_name = #{bucketName} AND object_name = #{objectName} AND deleted = false")
    TbSysFileDTO selectByMinioObject(@Param("bucketName") String bucketName, @Param("objectName") String objectName);

    /**
     * @description    根据文件根ID查询最大版本号
     * @param    fileRootId 文件根ID
     * @return    Integer 最大版本号
     * @author    yslg
     * @since 2025-12-18
     */
    @Select("SELECT MAX(version) FROM file.tb_sys_file WHERE file_root_id = #{fileRootId} AND deleted = false")
    Integer selectMaxVersionByFileRootId(@Param("fileRootId") String fileRootId);
}
