|
|
package com.service;
|
|
|
|
|
|
import com.baomidou.mybatisplus.mapper.Wrapper;
|
|
|
import com.baomidou.mybatisplus.service.IService;
|
|
|
import com.utils.PageUtils;
|
|
|
import com.entity.KuaidixinxiEntity;
|
|
|
import java.util.List;
|
|
|
import java.util.Map;
|
|
|
import com.entity.vo.KuaidixinxiVO;
|
|
|
import org.apache.ibatis.annotations.Param;
|
|
|
import com.entity.view.KuaidixinxiView;
|
|
|
|
|
|
/**
|
|
|
* 快递信息服务接口
|
|
|
*
|
|
|
* 核心职责：定义快递信息模块的业务方法契约
|
|
|
*
|
|
|
* 技术架构：
|
|
|
* 1. 继承MyBatis-Plus的IService接口 → 获得标准CRUD方法定义
|
|
|
* 2. 定义快递信息特有的业务方法 → 扩展业务功能
|
|
|
* 3. 使用VO和View对象 → 实现数据分层和定制化展示
|
|
|
*
|
|
|
* @author
|
|
|
* @email
|
|
|
* @date 2023-02-17 16:59:28
|
|
|
*/
|
|
|
public interface KuaidixinxiService extends IService<KuaidixinxiEntity> {
|
|
|
|
|
|
/**
|
|
|
* 分页查询快递信息（基础版本）
|
|
|
* 使用默认查询条件进行分页查询
|
|
|
*
|
|
|
* @param params 请求参数，包含分页参数（page、limit等）
|
|
|
* @return 分页工具对象，包含分页数据和分页信息
|
|
|
*/
|
|
|
PageUtils queryPage(Map<String, Object> params);
|
|
|
|
|
|
/**
|
|
|
* 查询快递信息VO列表
|
|
|
* 返回值对象列表，用于列表展示，包含核心业务字段
|
|
|
*
|
|
|
* @param wrapper 查询条件包装器
|
|
|
* @return 快递信息VO列表
|
|
|
*/
|
|
|
List<KuaidixinxiVO> selectListVO(Wrapper<KuaidixinxiEntity> wrapper);
|
|
|
|
|
|
/**
|
|
|
* 查询单个快递信息VO
|
|
|
* 返回单个值对象，用于详情展示
|
|
|
*
|
|
|
* @param wrapper 查询条件包装器
|
|
|
* @return 单个快递信息VO对象
|
|
|
*/
|
|
|
KuaidixinxiVO selectVO(@Param("ew") Wrapper<KuaidixinxiEntity> wrapper);
|
|
|
|
|
|
/**
|
|
|
* 查询快递信息视图列表
|
|
|
* 返回视图对象列表，包含完整的关联数据
|
|
|
*
|
|
|
* @param wrapper 查询条件包装器
|
|
|
* @return 快递信息视图列表
|
|
|
*/
|
|
|
List<KuaidixinxiView> selectListView(Wrapper<KuaidixinxiEntity> wrapper);
|
|
|
|
|
|
/**
|
|
|
* 查询单个快递信息视图
|
|
|
* 返回单个视图对象，用于详情页展示，包含所有关联数据
|
|
|
*
|
|
|
* @param wrapper 查询条件包装器
|
|
|
* @return 单个快递信息视图对象
|
|
|
*/
|
|
|
KuaidixinxiView selectView(@Param("ew") Wrapper<KuaidixinxiEntity> wrapper);
|
|
|
|
|
|
/**
|
|
|
* 分页查询快递信息（增强版本）
|
|
|
* 支持自定义查询条件和返回视图对象
|
|
|
*
|
|
|
* @param params 请求参数，包含分页参数
|
|
|
* @param wrapper 自定义查询条件包装器
|
|
|
* @return 分页工具对象，包含分页的视图数据
|
|
|
*/
|
|
|
PageUtils queryPage(Map<String, Object> params, Wrapper<KuaidixinxiEntity> wrapper);
|
|
|
} |
