package com.service;

import com.baomidou.mybatisplus.mapper.Wrapper;
import com.baomidou.mybatisplus.service.IService;
import com.utils.PageUtils;
import com.entity.JijianxinxiEntity;
import java.util.List;
import java.util.Map;
import com.entity.vo.JijianxinxiVO;
import org.apache.ibatis.annotations.Param;
import com.entity.view.JijianxinxiView;

/**
 * 寄件信息服务接口
 *
 * 核心职责：定义寄件信息模块的业务方法契约
 *
 * 技术架构：
 * 1. 继承MyBatis-Plus的IService接口 → 获得标准CRUD方法定义
 * 2. 定义寄件信息特有的业务方法 → 扩展业务功能
 * 3. 使用VO和View对象 → 实现数据分层和定制化展示
 *
 * @author
 * @email
 * @date
 */
public interface JijianxinxiService extends IService<JijianxinxiEntity> {

    /**
     * 分页查询寄件信息（基础版本）
     * 使用默认查询条件进行分页查询
     *
     * @param params 请求参数，包含分页参数（page、limit等）
     * @return 分页工具对象，包含分页数据和分页信息
     */
    PageUtils queryPage(Map<String, Object> params);

    /**
     * 查询寄件信息VO列表
     * 返回值对象列表，用于列表展示，包含核心业务字段
     *
     * @param wrapper 查询条件包装器
     * @return 寄件信息VO列表
     */
    List<JijianxinxiVO> selectListVO(Wrapper<JijianxinxiEntity> wrapper);

    /**
     * 查询单个寄件信息VO
     * 返回单个值对象，用于详情展示
     *
     * @param wrapper 查询条件包装器
     * @return 单个寄件信息VO对象
     */
    JijianxinxiVO selectVO(@Param("ew") Wrapper<JijianxinxiEntity> wrapper);

    /**
     * 查询寄件信息视图列表
     * 返回视图对象列表，包含完整的关联数据
     *
     * @param wrapper 查询条件包装器
     * @return 寄件信息视图列表
     */
    List<JijianxinxiView> selectListView(Wrapper<JijianxinxiEntity> wrapper);

    /**
     * 查询单个寄件信息视图
     * 返回单个视图对象，用于详情页展示，包含所有关联数据
     *
     * @param wrapper 查询条件包装器
     * @return 单个寄件信息视图对象
     */
    JijianxinxiView selectView(@Param("ew") Wrapper<JijianxinxiEntity> wrapper);

    /**
     * 分页查询寄件信息（增强版本）
     * 支持自定义查询条件和返回视图对象
     *
     * @param params 请求参数，包含分页参数
     * @param wrapper 自定义查询条件包装器
     * @return 分页工具对象，包含分页的视图数据
     */
    PageUtils queryPage(Map<String, Object> params, Wrapper<JijianxinxiEntity> wrapper);
}