springbootgbu3f/KuaidiyuanService.java

package com.service;

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

/**
 * 快递员服务接口
 *
 * 核心职责：定义快递员管理模块的业务方法契约
 *
 * 技术架构：
 * 1. 继承MyBatis-Plus的IService接口 → 获得标准CRUD方法定义
 * 2. 定义快递员特有的业务方法 → 扩展业务功能
 * 3. 使用VO和View对象 → 实现数据分层和定制化展示
 *
 * @author
 * @email
 * @date 2023-02-17 16:59:28
 */
public interface KuaidiyuanService extends IService<KuaidiyuanEntity> {

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

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

    /**
     * 查询单个快递员VO
     * 返回单个值对象，用于详情展示
     *
     * @param wrapper 查询条件包装器
     * @return 单个快递员VO对象
     */
    KuaidiyuanVO selectVO(@Param("ew") Wrapper<KuaidiyuanEntity> wrapper);

    /**
     * 查询快递员视图列表
     * 返回视图对象列表，包含完整的关联数据
     *
     * @param wrapper 查询条件包装器
     * @return 快递员视图列表
     */
    List<KuaidiyuanView> selectListView(Wrapper<KuaidiyuanEntity> wrapper);

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

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