🔥 本文由 程序喵正在路上 原创,CSDN首发!
💖 系列专栏:苍穹外卖项目实战
🌠 首发时间:2024年5月21日
🦋 欢迎关注🖱点赞👍收藏🌟留言🐾
目录
订单搜索
需求分析和设计
产品原型:
业务规则:
- 输入订单号/手机号进行搜索,支持模糊搜索
- 根据订单状态进行筛选
- 下单时间进行时间筛选
- 搜索内容为空,提示未找到相关订单
- 搜索结果页,展示包含搜索关键词的内容
- 分页展示搜索到的订单数据
接口设计:
代码实现
在 admin 下新建 OrderController并创建 conditionSearch 方法:
import com.sky.dto.OrdersPageQueryDTO;
import com.sky.result.PageResult;
import com.sky.result.Result;
import com.sky.service.OrderService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController("adminOrderController")
@Api(tags = "订单管理接口")
@RequestMapping("/admin/order")
@Slf4j
public class OrderController {
@Autowired
private OrderService orderService;
/**
* 订单搜索
*
* @param ordersPageQueryDTO
* @return
*/
@GetMapping({"/conditionSearch"})
@ApiOperation("订单搜索")
public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {
PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);
return Result.success(pageResult);
}
}
在 OrderService 接口中声明 conditionSearch 方法:
/**
* 订单搜索
*
* @param ordersPageQueryDTO
* @return
*/
PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO);
在 OrderServiceImpl 中实现 conditionSearch 方法:
/**
* 订单搜索
*
* @param ordersPageQueryDTO
* @return
*/
public PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {
//开始分页查询
PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());
Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);
//部分订单, 需要我们返回订单菜品信息
List<OrderVO> orderVOList = getOrderVOList(page);
return new PageResult(page.getTotal(), orderVOList);
}
/**
* 获取订单菜品信息
*
* @param page
* @return
*/
private List<OrderVO> getOrderVOList(Page<Orders> page) {
//需要返回订单菜品信息, 自定义OrderVO响应结果
List<OrderVO> orderVOList = new ArrayList<>();
List<Orders> ordersList = page.getResult();
if (!CollectionUtils.isEmpty(ordersList)) {
ordersList.forEach(orders -> {
OrderVO orderVO = new OrderVO();
BeanUtils.copyProperties(orders, orderVO);
String orderDishes = getOrderDishesStr(orders); //获取订单菜品信息
orderVO.setOrderDishes(orderDishes);
orderVOList.add(orderVO);
});
}
return orderVOList;
}
/**
* 获取订单菜品信息字符串
*
* @param orders
* @return
*/
private String getOrderDishesStr(Orders orders) {
//查询订单菜品详情信息
List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());
//将每一条订单菜品信息拼接位字符串
List<String> orderDishList = orderDetailList.stream().map(x -> {
return x.getName() + "*" + x.getNumber() + ";";
}).collect(Collectors.toList());
//将该订单对应的所有菜品信息拼接在一起
return String.join("", orderDishList);
}
功能测试
各个状态的订单数量统计
需求分析和设计
产品原型:
接口设计:
代码实现
在 OrderController 中创建 statistics 方法:
/**
* 各个状态的订单数量统计
*
* @return
*/
@GetMapping("/statistics")
@ApiOperation("各个状态的订单数量统计")
public Result<OrderStatisticsVO> statistics() {
OrderStatisticsVO orderStatisticsVO = orderService.statistics();
return Result.success(orderStatisticsVO);
}
在 OrderService 接口中声明 statistics 方法:
/**
* 各个状态的订单数量统计
*
* @return
*/
OrderStatisticsVO statistics();
在 OrderServiceImpl 中实现 statistics 方法:
/**
* 各个状态的订单数量统计
*
* @return
*/
public OrderStatisticsVO statistics() {
//查询各个状态的订单数量
Integer toBeConfirmed = orderMapper.countStatus(Orders.TO_BE_CONFIRMED);//待接单
Integer confirmed = orderMapper.countStatus(Orders.CONFIRMED);//待派送
Integer deliveryInProgress = orderMapper.countStatus(Orders.DELIVERY_IN_PROGRESS);//派送中
//封装数据
OrderStatisticsVO orderStatisticsVO = new OrderStatisticsVO();
orderStatisticsVO.setToBeConfirmed(toBeConfirmed);
orderStatisticsVO.setConfirmed(confirmed);
orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);
return orderStatisticsVO;
}
在 OrderMapper 中创建 countStatus 方法并配置 SQL:
/**
* 根据状态统计订单数量
*
* @param status
*/
@Select("select count(*) from orders where status = #{status};")
Integer countStatus(Integer status);
功能测试
查询订单详情
需求分析和设计
产品原型:
业务规则:
- 订单详情页面需要展示订单基本信息(状态、订单号、下单时间、收货人、电话、收货地址、金额等)
- 订单详情页面需要展示订单明细数据(商品名称、数量、单价)
接口设计:
代码实现
在 OrderController 中创建 details 方法:
/**
* 查询订单详情
*
* @param id
* @return
*/
@GetMapping("/details/{id}")
@ApiOperation("查询订单详情")
public Result<OrderVO> details(@PathVariable Long id) {
return Result.success(orderService.details(id));
}
功能测试
接单
需求分析和设计
产品原型:
业务规则:
- 商家接单其实就是将订单的状态修改为 “已接单”
接口设计:
代码实现
在 OrderController 中创建 confirm 方法:
/**
* 接单
*
* @param ordersConfirmDTO
* @return
*/
@PutMapping("/confirm")
@ApiOperation("接单")
public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO) {
orderService.confirm(ordersConfirmDTO);
return Result.success();
}
在 OrderService 接口中声明 confirm 方法:
/**
* 接单
*
* @param ordersConfirmDTO
*/
void confirm(OrdersConfirmDTO ordersConfirmDTO);
在 OrderServiceImpl 中实现 confirm 方法:
/**
* 接单
*
* @param ordersConfirmDTO
*/
public void confirm(OrdersConfirmDTO ordersConfirmDTO) {
Orders orders = Orders.builder()
.id(ordersConfirmDTO.getId())
.status(Orders.CONFIRMED)
.build();
orderMapper.update(orders);
}
功能测试
接单完状态变为待派送:
拒单
需求分析和设计
产品原型:
业务规则:
- 商家拒单其实就是将订单状态修改为 “已取消”
- 只有订单处于 “待接单” 状态时可以执行拒单操作
- 商家拒单时需要指定拒单原因
- 商家拒单时,如果用户已经完成了支付,需要为用户退款
接口设计:
代码实现
在 OrderController 中创建 rejection 方法:
/**
* 拒单
*
* @param ordersRejectionDTO
* @return
*/
@PutMapping("/rejection")
@ApiOperation("拒单")
public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) {
orderService.rejection(ordersRejectionDTO);
return Result.success();
}
在 OrderService 接口中声明 rejection 方法:
/**
* 拒单
*
* @param ordersRejectionDTO
*/
void rejection(OrdersRejectionDTO ordersRejectionDTO);
在 OrderServiceImpl 中实现 rejection 方法:
/**
* 拒单
*
* @param ordersRejectionDTO
*/
public void rejection(OrdersRejectionDTO ordersRejectionDTO) {
//根据id查询订单
Orders orders = orderMapper.getById(ordersRejectionDTO.getId());
//订单只有存在并且状态为待接单才可以拒单
if (orders == null || !orders.getStatus().equals(Orders.TO_BE_CONFIRMED)) {
throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
}
//如果用户已支付, 需要退款
Integer payStatus = orders.getPayStatus();
if (payStatus.equals(Orders.PAID)) {
/*
//用户已支付,需要退款
String refund = weChatPayUtil.refund(
orders.getNumber(),
orders.getNumber(),
new BigDecimal(0.01),
new BigDecimal(0.01));
log.info("申请退款:{}", refund);
*/
log.info("拒单,退款:{}元", orders.getAmount());
}
//更新订单状态、拒单原因和取消时间
Orders newOrder = new Orders();
newOrder.setId(orders.getId());
newOrder.setStatus(Orders.CANCELLED); //已取消
newOrder.setRejectionReason(ordersRejectionDTO.getRejectionReason());
newOrder.setCancelTime(LocalDateTime.now());
orderMapper.update(newOrder);
}
功能测试
取消订单
需求分析和设计
产品原型:
业务规则:
- 取消订单其实就是将订单状态修改为 “已取消”
- 商家取消订单时需要指定取消原因
- 商家取消订单时,如果用户已经完成了支付,需要为用户退款
接口设计:
代码实现
在 OrderController 中创建 cancel 方法:
/**
* 取消订单
*
* @param ordersCancelDTO
* @return
*/
@PutMapping("/cancel")
@ApiOperation("取消订单")
public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) {
orderService.cancel(ordersCancelDTO);
return Result.success();
}
在 OrderService 接口中声明 cancel 方法:
/**
* 商家取消订单
* @param ordersCancelDTO
*/
void cancel(OrdersCancelDTO ordersCancelDTO);
在 OrderServiceImpl 中实现 cancel 方法,思路和拒单差不多:
/**
* 商家取消订单
*
* @param ordersCancelDTO
*/
public void cancel(OrdersCancelDTO ordersCancelDTO) {
//根据id查询订单
Orders orders = orderMapper.getById(ordersCancelDTO.getId());
//如果用户已支付, 需要退款
Integer payStatus = orders.getPayStatus();
if (payStatus.equals(Orders.PAID)) {
/*
//用户已支付,需要退款
String refund = weChatPayUtil.refund(
orders.getNumber(),
orders.getNumber(),
new BigDecimal(0.01),
new BigDecimal(0.01));
log.info("申请退款:{}", refund);
*/
log.info("商家取消订单,退款:{}元", orders.getAmount());
}
//更新订单状态、取消原因和取消时间
Orders newOrder = new Orders();
newOrder.setId(orders.getId());
newOrder.setStatus(Orders.CANCELLED); //已取消
newOrder.setCancelReason(ordersCancelDTO.getCancelReason());
newOrder.setCancelTime(LocalDateTime.now());
orderMapper.update(newOrder);
}
功能测试
派送订单
需求分析和设计
产品原型:
业务规则:
- 派送订单其实就是将订单状态修改为“派送中”
- 只有状态为“待派送”的订单可以执行派送订单操作
接口设计:
代码实现
在 OrderController 中创建 delivery 方法:
/**
* 派送订单
*
* @param id
* @return
*/
@PutMapping("/delivery/{id}")
@ApiOperation("派送订单")
public Result delivery(@PathVariable Long id) {
orderService.delivery(id);
return Result.success();
}
在 OrderService 接口中声明 delivery 方法:
/**
* 派送订单
*
* @param id
*/
void delivery(Long id);
在 OrderServiceImpl 中实现 delivery 方法:
/**
* 派送订单
*
* @param id
*/
public void delivery(Long id) {
//根据id查询订单
Orders orders = orderMapper.getById(id);
//校验订单是否存在并且状态为已接单
if (orders == null || !orders.getStatus().equals(Orders.CONFIRMED)) {
throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
}
//更新订单状态
Orders newOrder = Orders.builder()
.id(id)
.status(Orders.DELIVERY_IN_PROGRESS)
.build();
orderMapper.update(newOrder);
}
功能测试
完成订单
需求分析和设计
产品原型:
业务规则:
- 完成订单其实就是将订单状态修改为 “已完成”
- 只有状态为 “派送中” 的订单可以执行订单完成操作
接口设计:
代码实现
在 OrderController 中创建 complete 方法:
/**
* 完成订单
*
* @param id
* @return
*/
@PutMapping("/complete/{id}")
@ApiOperation("完成订单")
public Result complete(@PathVariable Long id) {
orderService.complete(id);
return Result.success();
}
在 OrderService 接口中声明 complete 方法:
/**
* 完成订单
*
* @param id
*/
void complete(Long id);
在 OrderServiceImpl 中实现 complete 方法:
/**
* 完成订单
*
* @param id
*/
public void complete(Long id) {
//根据id查询订单
Orders orders = orderMapper.getById(id);
//校验订单是否存在并且状态为派送中
if (orders == null || !orders.getStatus().equals(Orders.DELIVERY_IN_PROGRESS)) {
throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
}
//更新订单状态
Orders newOrder = Orders.builder()
.id(id)
.status(Orders.COMPLETED)
.build();
orderMapper.update(newOrder);
}