商家端订单管理模块：
订单搜索
产品原型
业务规则：
输入订单号/手机号进行搜索，支持模糊搜索
根据订单状态进行筛选
下单时间进行时间筛选
搜索内容为空，提示未找到相关订单
搜索结果页，展示包含搜索关键词的内容
分页展示搜索到的订单数据
接口设计
admin包下新建OrderController
/**
* 订单管理接口
*/
@RestController("adminOrderController")
@RequestMapping("/admin/order")
@Api(tags = "订单管理接口")
@Slf4j
public class OrderController {
@Autowired
private OrderService orderService;
/**
* 订单搜索
* @param ordersPageQueryDTO
* @return
*/
@GetMapping("/conditionSearch")
public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO){
PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);
return Result.success(pageResult);
}
}OrderService
/**
* 条件搜索订单
* @param ordersPageQueryDTO
* @return
*/
PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO);OrderServiceImpl
/**
* 订单搜索
* @param ordersPageQueryDTO
* @return
*/
public PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {
PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());
Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);
// 部分订单状态，需要额外返回订单菜品信息，将order转化为orderVO
List<OrderVO> orderVOList = getOrderVOList(page);
return new PageResult(page.getTotal(),orderVOList);
}
private List<OrderVO> getOrderVOList(Page<Orders> page) {
//需要返回订单菜品信息，自定义OrderVO响应结果
List<OrderVO> orderVOList = new ArrayList<>();
List<Orders> ordersList = page.getResult();
if (!CollectionUtils.isEmpty(ordersList)){
for (Orders orders : ordersList) {
//将共同字段复制到OrderVo中
OrderVO orderVO = new OrderVO();
BeanUtils.copyProperties(orders,orderVO);
String orderDishes = getOrderDishesStr(orders);
//将订单菜品信息封装到orderVO中，并添加到orderVoList
orderVO.setOrderDishes(orderDishes);
orderVOList.add(orderVO);
}
}
return orderVOList;
}
/**
* 根据订单id获取菜品信息字符串
*
* @param orders
* @return
*/
private String getOrderDishesStr(Orders orders) {
//查询订单菜品详情信息(订单中的菜品和数量)
List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());
//将每一头订单菜品信息拼接位字符串(格式：宫保鸡丁*3；)
List<String> orderDishList = orderDetailList.stream().map(x ->{
String orderDish = x.getName() + "*" + x.getName() + ";";
return orderDish;
}).collect(Collectors.toList());
//将该订单对应的所有菜品信息拼接在一起
return String.join("",orderDishList);
}功能测试：
各个状态的订单数量统计
产品原型
接口设计
OrderController
/**
* 各个状态的订单数量统计
* @return
*/
@GetMapping("/statistics")
@ApiOperation("各个状态的订单数量统计")
public Result<OrderStatisticsVO> statistics(){
OrderStatisticsVO orderStatisticsVO = orderService.statistics();
return Result.success(orderStatisticsVO);
}OrderService
/**
* 各个状态的订单数量统计
* @return
*/
OrderStatisticsVO statistics();OrderServiceImpl
/**
* 各个状态的订单数量统计
* @return
*/
public OrderStatisticsVO statistics() {
// 根据订单状态分别查询出 待接单、待派送、派送中的订单数量
Integer toBeConfirmed = orderMapper.statistics(Orders.TO_BE_CONFIRMED);
Integer confirmed = orderMapper.statistics(Orders.CONFIRMED);
Integer deliveryInProgress = orderMapper.statistics(Orders.DELIVERY_IN_PROGRESS);
//将查询出的数据封装到orderStatisticsVo中响应
OrderStatisticsVO orderStatisticsVO = new OrderStatisticsVO();
orderStatisticsVO.setConfirmed(confirmed);
orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);
orderStatisticsVO.setToBeConfirmed(toBeConfirmed);
return orderStatisticsVO;
}OrderMapper
/**
* 根据状态统计订单数量
* @param status
*/
@Select("select count(id) from orders where status = #{status}")
Integer statistics(Integer status);功能测试：
查询订单详情
产品原型
业务规则：
订单详情页面需要展示订单基本信息（状态、订单号、下单时间、收货人、电话、收货地址、金额等）
订单详情页面需要展示订单明细数据（商品名称、数量、单价）
接口设计
OrderController
/**
* 查看订单详情
* @param id
* @return
*/
@GetMapping("/details/{id}")
@ApiOperation("查看订单详情")
public Result<OrderVO> details(@PathVariable("id") Long id){
OrderVO orderVO = orderService.details(id);
return Result.success(orderVO);
}功能测试：
接单
产品原型
业务规则：
商家接单其实就是将订单的状态修改为“已接单”
接口设计
OrderController
/**
* 接单
* @param ordersConfirmDTO
* @return
*/
@PutMapping("/confirm")
@ApiOperation("接单")
public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO){
orderService.confirm(ordersConfirmDTO);
return Result.success();
}OrderService
/**
* 接单
* @param ordersConfirmDTO
*/
void confirm(OrdersConfirmDTO ordersConfirmDTO);OrderServiceImpl
/**
* 接单
* @param ordersConfirmDTO
*/
public void confirm(OrdersConfirmDTO ordersConfirmDTO) {
Orders orders = Orders.builder()
.id(ordersConfirmDTO.getId())
.status(Orders.CONFIRMED)
.build();
orderMapper.update(orders);
}功能测试：
拒单
产品原型
业务规则：
商家拒单其实就是将订单状态修改为“已取消”
只有订单处于“待接单”状态时可以执行拒单操作
商家拒单时需要指定拒单原因
商家拒单时，如果用户已经完成了支付，需要为用户退款
接口设计
OrderController
/**
* 拒单
* @param ordersRejectionDTO
* @return
*/
@PutMapping("/rejection")
@ApiOperation("拒单")
public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) throws Exception{
orderService.rejection(ordersRejectionDTO);
return Result.success();
}OrderService
/**
* 拒单
* @param ordersRejectionDTO
*/
void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception;OrderServiceImpl
/**
* 拒单
* @param ordersRejectionDTO
* @throws Exception
*/
public void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception {
//根据id查询订单
Orders ordersDB = orderMapper.getbyId(ordersRejectionDTO.getId());
//订单只有存在且状态为2（待接单）才可以拒单
if(ordersDB == null && !ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)){
throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
}
//支付状态
Integer payStatus = ordersDB.getPayStatus();
if(payStatus == Orders.PAID){
//用户已付款，需要退款 //伪微信支付，无须调用退款接口
// String refund = weChatPayUtil.refund(
// ordersDB.getNumber(),
// ordersDB.getNumber(),
// new BigDecimal(0.01),
// new BigDecimal(0.01));
// log.info("申请退款：{}", refund);
log.info("给订单:{}退款",ordersDB.getNumber());
}
// 拒单需要退款，根据订单id更新订单状态，拒单原因，取消时间
//！！！这里无须改支付状态因为是我们拒单，改成已取消可以了,用户主动取消则需要更改支付状态！！！
Orders orders = new Orders();
orders.setStatus(Orders.CANCELLED);
orders.setId(ordersDB.getId());
orders.setRejectionReason(ordersRejectionDTO.getRejectionReason());
orders.setCancelTime(LocalDateTime.now());
orderMapper.update(orders);
}功能测试：
取消订单
产品原型
业务规则：
取消订单其实就是将订单状态修改为“已取消”
商家取消订单时需要指定取消原因
商家取消订单时，如果用户已经完成了支付，需要为用户退款
接口设计
OrderController
/**
* 取消订单
* @param ordersCancelDTO
* @return
*/
@PutMapping("/cancel")
@ApiOperation("取消订单")
public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) throws Exception{
orderService.cancel(ordersCancelDTO);
return Result.success();
}OrderService
/**
* 商家取消订单
* @param ordersCancelDTO
*/
void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception;OrderServiceImpl
/**
* 取消订单
* @param ordersCancelDTO
* @throws Exception
*/
public void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception {
//根据id查询订单
Orders ordersDB = orderMapper.getbyId(ordersCancelDTO.getId());
//支付状态
Integer payStatus = ordersDB.getPayStatus();
if(ordersDB.getPayStatus().equals(Orders.PAID)){
//用户已付款，需要退款 //伪微信支付，无须调用退款接口
// String refund = weChatPayUtil.refund(
// ordersDB.getNumber(),
// ordersDB.getNumber(),
// new BigDecimal(0.01),
// new BigDecimal(0.01));
// log.info("申请退款：{}", refund);
log.info("给订单:{}退款",ordersDB.getNumber());
}
// 管理端取消订单需要退款，根据订单id更新订单状态、取消原因、取消时间
Orders orders = new Orders();
orders.setId(ordersCancelDTO.getId());
orders.setCancelReason(ordersCancelDTO.getCancelReason());
orders.setCancelTime(LocalDateTime.now());
orders.setStatus(Orders.CANCELLED);
orderMapper.update(orders);
}功能测试：
派送订单
产品原型
业务规则：
派送订单其实就是将订单状态修改为“派送中”
只有状态为“待派送”的订单可以执行派送订单操作
接口设计
OrderController
/**
* 派送订单
* @param id
* @return
*/
@PutMapping("/delivery/{id}")
@ApiOperation("派送订单")
public Result delivery(@PathVariable Long id){
orderService.delivery(id);
return Result.success();
}OrderService
/**
* 派送订单
* @param id
*/
void delivery(Long id);OrderServiceImpl
/**
* 派送订单
* @param id
*/
public void delivery(Long id) {
//根据id查询订单
Orders ordersDB = orderMapper.getbyId(id);
if(ordersDB == null || !ordersDB.getStatus().equals(Orders.CONFIRMED)){
throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
}
Orders orders = new Orders();
orders.setId(ordersDB.getId());
// 更新订单状态,状态转为派送中
orders.setStatus(Orders.DELIVERY_IN_PROGRESS);
orderMapper.update(orders);
}功能测试：
完成订单
产品原型
业务规则：
完成订单其实就是将订单状态修改为“已完成”
只有状态为“派送中”的订单可以执行订单完成操作
接口设计
OrderController
/**
* 完成订单
* @param id
* @return
*/
@PutMapping("/complete/{id}")
@ApiOperation("完成订单")
public Result complete(@PathVariable Long id){
orderService.complete(id);
return Result.success();
}OrderService
/**
* 完成订单
* @param id
*/
void complete(Long id);OrderServiceImpl
/**
* 完成订单
* @param id
*/
public void complete(Long id) {
//根据id查询订单
Orders ordersDB = orderMapper.getbyId(id);
// 校验订单是否存在，并且状态为4
if(ordersDB == null || !ordersDB.getStatus().equals(Orders.DELIVERY_IN_PROGRESS)){
throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);
}
Orders orders = new Orders();
orders.setId(id);
// 更新订单状态,状态转为完成
orders.setStatus(Orders.COMPLETED);
orders.setDeliveryTime(LocalDateTime.now());
orderMapper.update(orders);
}功能测试：
校验收货地址是否超出配送范围
1. 环境准备
注册账号：注册百度账号
登录百度地图开放平台：百度地图-百万开发者首选的地图服务商,提供专属的行业解决方案
进入控制台，创建应用，获取AK：
目前正在申请
319
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
