|
|
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.JijianxinxiDao;
|
|
|
import com.entity.JijianxinxiEntity;
|
|
|
import com.service.JijianxinxiService;
|
|
|
import com.entity.vo.JijianxinxiVO;
|
|
|
import com.entity.view.JijianxinxiView;
|
|
|
|
|
|
//类定义与继承关系
|
|
|
@Service("jijianxinxiService")
|
|
|
public class JijianxinxiServiceImpl extends ServiceImpl<JijianxinxiDao, JijianxinxiEntity> implements JijianxinxiService {
|
|
|
//作用：这是寄件信息服务的具体实现类，被Spring标记为服务组件（@Service），在Spring容器中的名称为jijianxinxiService。
|
|
|
//继承：
|
|
|
//继承了MyBatis-Plus的ServiceImpl，因此默认拥有了18个基础的CRUD操作方法。
|
|
|
//实现了自定义的JijianxinxiService接口，提供了更多特定于寄件信息的功能。
|
|
|
|
|
|
//方法1：基础分页查询
|
|
|
@Override
|
|
|
public PageUtils queryPage(Map<String, Object> params) {
|
|
|
Page<JijianxinxiEntity> page = this.selectPage(
|
|
|
new Query<JijianxinxiEntity>(params).getPage(),
|
|
|
new EntityWrapper<JijianxinxiEntity>()
|
|
|
);
|
|
|
return new PageUtils(page);
|
|
|
}
|
|
|
//作用：查询寄件信息的分页数据，不包含任何条件（即查询所有寄件信息）。
|
|
|
//流程：
|
|
|
//Query<JijianxinxiEntity>(params).getPage()：将请求参数params（包含page页码和limit每页条数）转换为MyBatis-Plus的Page对象。
|
|
|
//new EntityWrapper<JijianxinxiEntity>()：创建一个空的查询条件包装器，表示无条件查询。
|
|
|
//this.selectPage(...)：调用MyBatis-Plus提供的基础分页查询方法，返回分页结果。
|
|
|
//将分页结果包装为PageUtils对象返回（该对象通常包含分页数据和分页信息）。
|
|
|
|
|
|
//方法2：带条件的分页查询
|
|
|
@Override
|
|
|
public PageUtils queryPage(Map<String, Object> params, Wrapper<JijianxinxiEntity> wrapper) {
|
|
|
Page<JijianxinxiView> page =new Query<JijianxinxiView>(params).getPage();
|
|
|
page.setRecords(baseMapper.selectListView(page,wrapper));
|
|
|
PageUtils pageUtil = new PageUtils(page);
|
|
|
return pageUtil;
|
|
|
}
|
|
|
//作用：根据条件查询寄件信息的分页数据，返回的是JijianxinxiView视图对象的分页结果。
|
|
|
//特点：
|
|
|
//支持复杂的查询条件（通过Wrapper参数）。
|
|
|
//返回的是视图对象（JijianxinxiView）的分页数据，通常视图对象会包含关联表的信息（如用户姓名、快递公司名称等）。
|
|
|
//流程：
|
|
|
//根据params构建分页参数（Page<JijianxinxiView>对象）。
|
|
|
//调用baseMapper.selectListView(page, wrapper)执行分页查询，并设置结果到page对象中。
|
|
|
//将page对象包装为PageUtils返回。
|
|
|
|
|
|
//方法3：查询VO列表
|
|
|
@Override
|
|
|
public List<JijianxinxiVO> selectListVO(Wrapper<JijianxinxiEntity> wrapper) {
|
|
|
return baseMapper.selectListVO(wrapper);
|
|
|
}
|
|
|
//作用：根据条件查询寄件信息的VO（Value Object）列表。
|
|
|
//说明：
|
|
|
//JijianxinxiVO是一个值对象，通常只包含寄件信息的部分字段，或者包含一些计算字段，用于特定的业务场景（如导出、报表等）。
|
|
|
//通过wrapper可以添加查询条件。
|
|
|
|
|
|
//方法4：查询单个VO
|
|
|
@Override
|
|
|
public JijianxinxiVO selectVO(Wrapper<JijianxinxiEntity> wrapper) {
|
|
|
return baseMapper.selectVO(wrapper);
|
|
|
}
|
|
|
//作用：根据条件查询单个寄件信息的VO对象。
|
|
|
//适用场景：查询单条寄件记录的特定视图，如寄件详情页。
|
|
|
|
|
|
//方法5：查询视图列表
|
|
|
@Override
|
|
|
public List<JijianxinxiView> selectListView(Wrapper<JijianxinxiEntity> wrapper) {
|
|
|
return baseMapper.selectListView(wrapper);
|
|
|
}
|
|
|
//作用：根据条件查询寄件信息的视图对象列表（非分页）。
|
|
|
//说明：
|
|
|
//JijianxinxiView通常是一个包含关联信息的视图对象，比如关联了用户表、地址表等。
|
|
|
//与selectListVO的区别在于，视图对象通常用于展示更复杂的数据结构（包含关联表字段）。
|
|
|
|
|
|
//方法6：查询单个视图
|
|
|
@Override
|
|
|
public JijianxinxiView selectView(Wrapper<JijianxinxiEntity> wrapper) {
|
|
|
return baseMapper.selectView(wrapper);
|
|
|
}
|
|
|
//作用：根据条件查询单个寄件信息的视图对象。
|
|
|
//适用场景：获取单条寄件记录的详情，包含关联信息（如寄件人详细信息、收件人地址信息等）。
|
|
|
|
|
|
}
|
