ADD file via upload

KuaidiyuanServiceImpl.java

@@ -0,0 +1,109 @@
+package com.service.impl;
+
+import org.springframework.stereotype.Service;
+import java.util.Map;
+import java.util.List;
+
+import com.baomidou.mybatisplus.mapper.Wrapper;
+import com.baomidou.mybatisplus.mapper.EntityWrapper;
+import com.baomidou.mybatisplus.plugins.Page;
+import com.baomidou.mybatisplus.service.impl.ServiceImpl;
+import com.utils.PageUtils;
+import com.utils.Query;
+
+import com.dao.KuaidiyuanDao;
+import com.entity.KuaidiyuanEntity;
+import com.service.KuaidiyuanService;
+import com.entity.vo.KuaidiyuanVO;
+import com.entity.view.KuaidiyuanView;
+
+/**
+ * 快递员服务实现类
+ * 核心职责：管理快递员（Kuaidiyuan）数据的业务逻辑
+ *
+ * 技术架构：
+ * 1. 继承MyBatis-Plus的ServiceImpl，获得基础的CRUD能力
+ * 2. 实现自定义的KuaidiyuanService接口，定义快递员特有的业务方法
+ * 3. 使用VO（Value Object）和View对象实现数据分层
+ */
+@Service("kuaidiyuanService")  // Spring服务注解，指定bean名称为"kuaidiyuanService"
+public class KuaidiyuanServiceImpl extends ServiceImpl<KuaidiyuanDao, KuaidiyuanEntity> implements KuaidiyuanService {
+
+    /**
+     * 分页查询快递员信息（基础版本）
+     * 使用默认的EntityWrapper进行条件查询
+     * @param params 请求参数，包含分页参数（page、limit等）
+     * @return 分页工具对象，包含分页数据和分页信息
+     */
+    @Override
+    public PageUtils queryPage(Map<String, Object> params) {
+        // 创建分页查询：使用Query工具类解析参数创建Page对象
+        Page<KuaidiyuanEntity> page = this.selectPage(
+                new Query<KuaidiyuanEntity>(params).getPage(),  // 解析分页参数
+                new EntityWrapper<KuaidiyuanEntity>()           // 创建空的查询条件包装器
+        );
+        return new PageUtils(page);  // 返回自定义的分页工具对象
+    }
+
+    /**
+     * 分页查询快递员信息（增强版本）
+     * 支持自定义查询条件和返回视图对象
+     * @param params 请求参数，包含分页参数
+     * @param wrapper 自定义查询条件包装器
+     * @return 分页工具对象，包含分页的视图数据
+     */
+    @Override
+    public PageUtils queryPage(Map<String, Object> params, Wrapper<KuaidiyuanEntity> wrapper) {
+        // 创建分页对象
+        Page<KuaidiyuanView> page = new Query<KuaidiyuanView>(params).getPage();
+        // 执行分页查询，获取视图数据
+        page.setRecords(baseMapper.selectListView(page, wrapper));
+        // 封装分页结果
+        PageUtils pageUtil = new PageUtils(page);
+        return pageUtil;
+    }
+
+    /**
+     * 查询快递员VO列表
+     * 返回值对象列表，用于列表展示
+     * @param wrapper 查询条件包装器
+     * @return 快递员VO列表
+     */
+    @Override
+    public List<KuaidiyuanVO> selectListVO(Wrapper<KuaidiyuanEntity> wrapper) {
+        return baseMapper.selectListVO(wrapper);
+    }
+
+    /**
+     * 查询单个快递员VO
+     * 返回单个值对象，用于详情展示
+     * @param wrapper 查询条件包装器
+     * @return 单个快递员VO对象
+     */
+    @Override
+    public KuaidiyuanVO selectVO(Wrapper<KuaidiyuanEntity> wrapper) {
+        return baseMapper.selectVO(wrapper);
+    }
+
+    /**
+     * 查询快递员视图列表
+     * 返回视图对象列表，包含关联数据
+     * @param wrapper 查询条件包装器
+     * @return 快递员视图列表
+     */
+    @Override
+    public List<KuaidiyuanView> selectListView(Wrapper<KuaidiyuanEntity> wrapper) {
+        return baseMapper.selectListView(wrapper);
+    }
+
+    /**
+     * 查询单个快递员视图
+     * 返回单个视图对象，包含完整的关联数据
+     * @param wrapper 查询条件包装器
+     * @return 单个快递员视图对象
+     */
+    @Override
+    public KuaidiyuanView selectView(Wrapper<KuaidiyuanEntity> wrapper) {
+        return baseMapper.selectView(wrapper);
+    }
+}