ADD file via upload

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