当前位置：首页 > news >正文

苍穹外卖Day9 | 用户端、管理端接口功能开发、百度地图解析配送范围

news 2025/9/5 8:09:33

实战内容

实战要求

1. 新功能开发

用户端-查询历史订单

1. 需求分析和设计

2. 代码开发

1.2.1 user/OrderController

1.2.2 OrderService

1.2.3 OrderServiceImpl

1.2.4 OrderMapper

1.2.5 OrderMapper.xml

1.2.6 OrderDetailMapper

3. 功能测试

用户端-查询订单详情

1. 需求分析和设计

基本信息

请求参数

返回数据

2.2 代码实现

2.2.1 user/OrderController

2.2.2 OrderService

2.2.3 OrderServiceImpl

2.2.4 OrderMapper

3. 功能测试

用户端-取消订单

1. 需求分析和设计

基本信息

请求参数

返回数据

3.2 代码实现

3.2.1 user/OrderController

3.2.2 OrderService

3.2.3 OrderServiceImpl

3. 功能测试

用户端-再来一单

1. 需求分析和设计

基本信息

请求参数

返回数据

4.2 代码实现

4.2.1 user/OrderController

4.2.2 OrderService

4.2.3 OrderServiceImpl

4.2.4 ShoppingCartMapper

4.2.5 ShoppingCartMapper.xml

管理端--订单搜索

1. 需求分析和设计

1.2 代码实现

1.2.1 admin/OrderController

1.2.2 OrderService

1.2.3 OrderServiceImpl

3. 功能测试

管理端--各个状态的订单数量统计

1. 需求分析和设计

基本信息

请求参数

返回数据

2.2 代码实现

2.2.1 admin/OrderController

2.2.2 OrderService

2.2.3 OrderServiceImpl

2.2.4 OrderMapper

3. 功能测试

管理端--查询订单详情

1. 需求分析和设计

2 代码实现

3.2.1 admin/OrderController

3. 功能测试

管理端--接单

1. 需求分析和设计

2 代码实现

4.2.1 admin/OrderController

4.2.2 OrderService

4.2.3 OrderServiceImpl

管理端--拒单

1. 需求分析和设计

基本信息

请求参数

返回数据

5.2 代码实现

5.2.1 admin/OrderController

5.2.2 OrderService

5.2.3 OrderServiceImpl

管理端--取消订单

1. 需求分析和设计

基本信息

请求参数

返回数据

6.2 代码实现

6.2.1 admin/OrderController

6.2.2 OrderService

6.2.3 OrderServiceImpl

管理端--派送订单

1. 需求分析和设计

基本信息

请求参数

返回数据

7.2 代码实现

7.2.1 admin/OrderController

7.2.2 OrderService

7.2.3 OrderServiceImpl

管理端--完成订单

1. 需求分析和设计

基本信息

请求参数

返回数据

8.2 代码实现

8.2.1 admin/OrderController

8.2.2 OrderService

8.2.3 OrderServiceImpl

2. 已有功能优化

实战内容

完成用户端历史订单模块、商家端订单管理模块相关业务新功能开发和已有功能优化，具体任务列表如下：

实战要求

根据产品原型进行需求分析和接口设计
根据接口设计进行代码实现
分别通过swagger接口文档和前后端联调进行功能测试
分组实战（具体任务分工由组长分配）

1. 新功能开发

用户端历史订单模块：

查询历史订单
查询订单详情
取消订单
再来一单

商家端订单管理模块：

订单搜索
各个状态的订单数量统计
查询订单详情
接单
拒单
取消订单
派送订单
完成订单

用户端-查询历史订单

1. 需求分析和设计

业务规则

分页查询历史订单
可以根据订单状态查询
展示订单数据时，需要展示的数据包括：下单时间、订单状态、订单金额、订单明细（商品名称、图片）

2. 代码开发

1.2.1 user/OrderController

    /*** 历史订单查询** @param page* @param pageSize* @param status   订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消* @return*/@GetMapping("/historyOrders")@ApiOperation("历史订单查询")public Result<PageResult> page(int page, int pageSize, Integer status) {PageResult pageResult = orderService.pageQuery4User(page, pageSize, status);return Result.success(pageResult);}

1.2.2 OrderService

    /*** 用户端订单分页查询* @param page* @param pageSize* @param status* @return*/PageResult pageQuery4User(int page, int pageSize, Integer status);

1.2.3 OrderServiceImpl

/*** 用户端订单分页查询** @param pageNum* @param pageSize* @param status* @return*/public PageResult pageQuery4User(int pageNum, int pageSize, Integer status) {// 设置分页PageHelper.startPage(pageNum, pageSize);OrdersPageQueryDTO ordersPageQueryDTO = new OrdersPageQueryDTO();ordersPageQueryDTO.setUserId(BaseContext.getCurrentId());ordersPageQueryDTO.setStatus(status);// 分页条件查询Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);List<OrderVO> list = new ArrayList();// 查询出订单明细，并封装入OrderVO进行响应if (page != null && page.getTotal() > 0) {for (Orders orders : page) {Long orderId = orders.getId();// 订单id// 查询订单明细List<OrderDetail> orderDetails = orderDetailMapper.getByOrderId(orderId);OrderVO orderVO = new OrderVO();BeanUtils.copyProperties(orders, orderVO);orderVO.setOrderDetailList(orderDetails);list.add(orderVO);}}return new PageResult(page.getTotal(), list);}

1.2.4 OrderMapper

    /*** 分页条件查询并按下单时间排序* @param ordersPageQueryDTO*/Page<Orders> pageQuery(OrdersPageQueryDTO ordersPageQueryDTO);

1.2.5 OrderMapper.xml

	<select id="pageQuery" resultType="Orders">select * from orders<where><if test="number != null and number!=''">and number like concat('%',#{number},'%')</if><if test="phone != null and phone!=''">and phone like concat('%',#{phone},'%')</if><if test="userId != null">and user_id = #{userId}</if><if test="status != null">and status = #{status}</if><if test="beginTime != null">and order_time &gt;= #{beginTime}</if><if test="endTime != null">and order_time &lt;= #{endTime}</if></where>order by order_time desc</select>

1.2.6 OrderDetailMapper

    /*** 根据订单id查询订单明细* @param orderId* @return*/@Select("select * from order_detail where order_id = #{orderId}")List<OrderDetail> getByOrderId(Long orderId);

3. 功能测试

用户端-查询订单详情

1. 需求分析和设计

产品原型：

接口设计

基本信息

Path： /user/order/orderDetail/{id}

Method： GET

接口描述：

请求参数

路径参数

参数名称	示例	备注
id	101	订单id

返回数据

名称	类型	是否必须	其他信息
code	integer	非必须	format: int32
data	object	非必须
├─ address	string	非必须
├─ addressBookId	integer	非必须	format: int64
├─ amount	number	非必须
├─ cancelReason	string	非必须
├─ cancelTime	string	非必须	format: date-time
├─ checkoutTime	string	非必须	format: date-time
├─ consignee	string	非必须
├─ deliveryStatus	integer	非必须	format: int32
├─ deliveryTime	string	非必须	format: date-time
├─ estimatedDeliveryTime	string	非必须	format: date-time
├─ id	integer	非必须	format: int64
├─ number	string	非必须
├─ orderDetailList	object []	非必须	item 类型: object
├─ amount	number	非必须
├─ dishFlavor	string	非必须
├─ dishId	integer	非必须	format: int64
├─ id	integer	非必须	format: int64
├─ image	string	非必须
├─ name	string	非必须
├─ number	integer	非必须	format: int32
├─ orderId	integer	非必须	format: int64
├─ setmealId	integer	非必须	format: int64
├─ orderTime	string	非必须	format: date-time
├─ packAmount	integer	非必须	format: int32
├─ payMethod	integer	非必须	format: int32
├─ payStatus	integer	非必须	format: int32
├─ phone	string	非必须
├─ rejectionReason	string	非必须
├─ remark	string	非必须
├─ status	integer	非必须	format: int32
├─ tablewareNumber	integer	非必须	format: int32
├─ tablewareStatus	integer	非必须	format: int32
├─ userId	integer	非必须	format: int64
├─ userName	string	非必须
msg	string	非必须

2.2 代码实现

2.2.1 user/OrderController

    /*** 查询订单详情** @param id* @return*/@GetMapping("/orderDetail/{id}")@ApiOperation("查询订单详情")public Result<OrderVO> details(@PathVariable("id") Long id) {OrderVO orderVO = orderService.details(id);return Result.success(orderVO);}

2.2.2 OrderService

    /*** 查询订单详情* @param id* @return*/OrderVO details(Long id);

2.2.3 OrderServiceImpl

    /*** 查询订单详情** @param id* @return*/public OrderVO details(Long id) {// 根据id查询订单Orders orders = orderMapper.getById(id);// 查询该订单对应的菜品/套餐明细List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(orders.getId());// 将该订单及其详情封装到OrderVO并返回OrderVO orderVO = new OrderVO();BeanUtils.copyProperties(orders, orderVO);orderVO.setOrderDetailList(orderDetailList);return orderVO;}

2.2.4 OrderMapper

    /*** 根据id查询订单* @param id*/@Select("select * from orders where id=#{id}")Orders getById(Long id);

3. 功能测试

有一个问题：用户详细订单中的地址没有展示

用户端-取消订单

1. 需求分析和设计

产品原型：

业务规则：

待支付和待接单状态下，用户可直接取消订单
商家已接单状态下，用户取消订单需电话沟通商家
派送中状态下，用户取消订单需电话沟通商家
如果在待接单状态下取消订单，需要给用户退款
取消订单后需要将订单状态修改为“已取消”

接口设计：

基本信息

Path： /user/order/cancel/{id}

Method： PUT

接口描述：

请求参数

路径参数

参数名称	示例	备注
id	101	订单id

返回数据

名称	类型	是否必须	其他信息
code	integer	必须	format: int32
data	object	非必须
msg	string	非必须

3.2 代码实现

3.2.1 user/OrderController

    /*** 用户取消订单** @return*/@PutMapping("/cancel/{id}")@ApiOperation("取消订单")public Result cancel(@PathVariable("id") Long id) throws Exception {orderService.userCancelById(id);return Result.success();}

3.2.2 OrderService

    /*** 用户取消订单* @param id*/void userCancelById(Long id) throws Exception;

3.2.3 OrderServiceImpl

	/*** 用户取消订单** @param id*/public void userCancelById(Long id) throws Exception {// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在if (ordersDB == null) {throw new OrderBusinessException(MessageConstant.ORDER_NOT_FOUND);}//订单状态 1待付款 2待接单 3已接单 4派送中 5已完成 6已取消if (ordersDB.getStatus() > 2) {throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}Orders orders = new Orders();orders.setId(ordersDB.getId());// 订单处于待接单状态下取消，需要进行退款if (ordersDB.getStatus().equals(Orders.TO_BE_CONFIRMED)) {//调用微信支付退款接口weChatPayUtil.refund(ordersDB.getNumber(), //商户订单号ordersDB.getNumber(), //商户退款单号new BigDecimal(0.01),//退款金额，单位 元new BigDecimal(0.01));//原订单金额//支付状态修改为 退款orders.setPayStatus(Orders.REFUND);}// 更新订单状态、取消原因、取消时间orders.setStatus(Orders.CANCELLED);orders.setCancelReason("用户取消");orders.setCancelTime(LocalDateTime.now());orderMapper.update(orders);}

3. 功能测试

将微信退款部分注释掉，可以实现正常退款

用户端-再来一单

1. 需求分析和设计

接口设计

基本信息

Path： /user/order/repetition/{id}

Method： POST

接口描述：

请求参数

路径参数

参数名称	示例	备注
id	101	订单id

返回数据

名称	类型	是否必须	其他信息
code	integer	必须	format: int32
data	object	非必须
msg	string	非必须

4.2 代码实现

4.2.1 user/OrderController

    /*** 再来一单** @param id* @return*/@PostMapping("/repetition/{id}")@ApiOperation("再来一单")public Result repetition(@PathVariable Long id) {orderService.repetition(id);return Result.success();}

4.2.2 OrderService

    /*** 再来一单** @param id*/void repetition(Long id);

4.2.3 OrderServiceImpl

	/*** 再来一单** @param id*/public void repetition(Long id) {// 查询当前用户idLong userId = BaseContext.getCurrentId();// 根据订单id查询当前订单详情List<OrderDetail> orderDetailList = orderDetailMapper.getByOrderId(id);// 将订单详情对象转换为购物车对象List<ShoppingCart> shoppingCartList = orderDetailList.stream().map(x -> {ShoppingCart shoppingCart = new ShoppingCart();// 将原订单详情里面的菜品信息重新复制到购物车对象中BeanUtils.copyProperties(x, shoppingCart, "id");shoppingCart.setUserId(userId);shoppingCart.setCreateTime(LocalDateTime.now());return shoppingCart;}).collect(Collectors.toList());// 将购物车对象批量添加到数据库shoppingCartMapper.insertBatch(shoppingCartList);}

4.2.4 ShoppingCartMapper

    /*** 批量插入购物车数据** @param shoppingCartList*/void insertBatch(List<ShoppingCart> shoppingCartList);

4.2.5 ShoppingCartMapper.xml

<insert id="insertBatch" parameterType="list">insert into shopping_cart(name, image, user_id, dish_id, setmeal_id, dish_flavor, number, amount, create_time)values<foreach collection="shoppingCartList" item="sc" separator=",">(#{sc.name},#{sc.image},#{sc.userId},#{sc.dishId},#{sc.setmealId},#{sc.dishFlavor},#{sc.number},#{sc.amount},#{sc.createTime})</foreach>
</insert>

管理端--订单搜索

1. 需求分析和设计

业务规则：

输入订单号/手机号进行搜索，支持模糊搜索
根据订单状态进行筛选
下单时间进行时间筛选
搜索内容为空，提示未找到相关订单
搜索结果页，展示包含搜索关键词的内容
分页展示搜索到的订单数据

1.2 代码实现

1.2.1 admin/OrderController

在admin包下创建OrderController

/*** 订单管理*/
@RestController("adminOrderController")
@RequestMapping("/admin/order")
@Slf4j
@Api(tags = "订单管理接口")
public class OrderController {@Autowiredprivate OrderService orderService;/*** 订单搜索** @param ordersPageQueryDTO* @return*/@GetMapping("/conditionSearch")@ApiOperation("订单搜索")public Result<PageResult> conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {PageResult pageResult = orderService.conditionSearch(ordersPageQueryDTO);return Result.success(pageResult);}
}

1.2.2 OrderService

    /*** 条件搜索订单* @param ordersPageQueryDTO* @return*/PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO);

1.2.3 OrderServiceImpl

    /*** 订单搜索** @param ordersPageQueryDTO* @return*/public PageResult conditionSearch(OrdersPageQueryDTO ordersPageQueryDTO) {PageHelper.startPage(ordersPageQueryDTO.getPage(), ordersPageQueryDTO.getPageSize());Page<Orders> page = orderMapper.pageQuery(ordersPageQueryDTO);// 部分订单状态，需要额外返回订单菜品信息，将Orders转化为OrderVOList<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) {// 将共同字段复制到OrderVOOrderVO orderVO = new OrderVO();BeanUtils.copyProperties(orders, orderVO);String orderDishes = getOrderDishesStr(orders);// 将订单菜品信息封装到orderVO中，并添加到orderVOListorderVO.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.getNumber() + ";";return orderDish;}).collect(Collectors.toList());// 将该订单对应的所有菜品信息拼接在一起return String.join("", orderDishList);}

3. 功能测试

管理端--各个状态的订单数量统计

1. 需求分析和设计

基本信息

Path： /admin/order/statistics

Method： GET

接口描述：

请求参数

返回数据

名称	类型	是否必须	备注	其他信息
code	integer	必须		format: int32
data	object	必须
├─ confirmed	integer	必须	待派送数量	format: int32
├─ deliveryInProgress	integer	必须	派送中数量	format: int32
├─ toBeConfirmed	integer	必须	待接单数量	format: int32
msg	string	非必须

2.2 代码实现

2.2.1 admin/OrderController

    /*** 各个状态的订单数量统计** @return*/@GetMapping("/statistics")@ApiOperation("各个状态的订单数量统计")public Result<OrderStatisticsVO> statistics() {OrderStatisticsVO orderStatisticsVO = orderService.statistics();return Result.success(orderStatisticsVO);}

2.2.2 OrderService

    /*** 各个状态的订单数量统计* @return*/OrderStatisticsVO statistics();

2.2.3 OrderServiceImpl

    /*** 各个状态的订单数量统计** @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 orderStatisticsVO = new OrderStatisticsVO();orderStatisticsVO.setToBeConfirmed(toBeConfirmed);orderStatisticsVO.setConfirmed(confirmed);orderStatisticsVO.setDeliveryInProgress(deliveryInProgress);return orderStatisticsVO;}

2.2.4 OrderMapper

    /*** 根据状态统计订单数量* @param status*/@Select("select count(id) from orders where status = #{status}")Integer countStatus(Integer status);

3. 功能测试

管理端--查询订单详情

1. 需求分析和设计

业务规则：

订单详情页面需要展示订单基本信息（状态、订单号、下单时间、收货人、电话、收货地址、金额等）
订单详情页面需要展示订单明细数据（商品名称、数量、单价）

2 代码实现

3.2.1 admin/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);}

3. 功能测试

管理端--接单

1. 需求分析和设计

业务规则：

商家接单其实就是将订单的状态修改为“已接单”

2 代码实现

4.2.1 admin/OrderController

    /*** 接单** @return*/@PutMapping("/confirm")@ApiOperation("接单")public Result confirm(@RequestBody OrdersConfirmDTO ordersConfirmDTO) {orderService.confirm(ordersConfirmDTO);return Result.success();}

4.2.2 OrderService

    /*** 接单** @param ordersConfirmDTO*/void confirm(OrdersConfirmDTO ordersConfirmDTO);

4.2.3 OrderServiceImpl

    /*** 接单** @param ordersConfirmDTO*/public void confirm(OrdersConfirmDTO ordersConfirmDTO) {Orders orders = Orders.builder().id(ordersConfirmDTO.getId()).status(Orders.CONFIRMED).build();orderMapper.update(orders);}

管理端--拒单

1. 需求分析和设计

业务规则：

商家拒单其实就是将订单状态修改为“已取消”
只有订单处于“待接单”状态时可以执行拒单操作
商家拒单时需要指定拒单原因
商家拒单时，如果用户已经完成了支付，需要为用户退款

基本信息

Path： /admin/order/rejection

Method： PUT

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Body

名称	类型	是否必须	默认值	备注	其他信息
id	integer	必须		订单id	format: int64
rejectionReason	string	必须		拒单原因

返回数据

名称	类型	是否必须	其他信息
code	integer	必须	format: int32
data	object	非必须
msg	string	非必须

5.2 代码实现

5.2.1 admin/OrderController

    /*** 拒单** @return*/@PutMapping("/rejection")@ApiOperation("拒单")public Result rejection(@RequestBody OrdersRejectionDTO ordersRejectionDTO) throws Exception {orderService.rejection(ordersRejectionDTO);return Result.success();}

5.2.2 OrderService

    /*** 拒单** @param ordersRejectionDTO*/void rejection(OrdersRejectionDTO ordersRejectionDTO) throws Exception;

5.2.3 OrderServiceImpl

	/*** 拒单** @param ordersRejectionDTO*/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);}// 拒单需要退款，根据订单id更新订单状态、拒单原因、取消时间Orders orders = new Orders();orders.setId(ordersDB.getId());orders.setStatus(Orders.CANCELLED);orders.setRejectionReason(ordersRejectionDTO.getRejectionReason());orders.setCancelTime(LocalDateTime.now());orderMapper.update(orders);}

管理端--取消订单

1. 需求分析和设计

业务规则：

取消订单其实就是将订单状态修改为“已取消”
商家取消订单时需要指定取消原因
商家取消订单时，如果用户已经完成了支付，需要为用户退款

基本信息

Path： /admin/order/cancel

Method： PUT

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

Body

名称	类型	是否必须	默认值	备注	其他信息
cancelReason	string	必须		订单取消原因
id	integer	必须		订单id	format: int64

返回数据

名称	类型	是否必须	其他信息
code	integer	必须	format: int32
data	object	非必须
msg	string	非必须

6.2 代码实现

6.2.1 admin/OrderController

    /*** 取消订单** @return*/@PutMapping("/cancel")@ApiOperation("取消订单")public Result cancel(@RequestBody OrdersCancelDTO ordersCancelDTO) throws Exception {orderService.cancel(ordersCancelDTO);return Result.success();}

6.2.2 OrderService

    /*** 商家取消订单** @param ordersCancelDTO*/void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception;

6.2.3 OrderServiceImpl

	/*** 取消订单** @param ordersCancelDTO*/public void cancel(OrdersCancelDTO ordersCancelDTO) throws Exception {// 根据id查询订单Orders ordersDB = orderMapper.getById(ordersCancelDTO.getId());//支付状态Integer payStatus = ordersDB.getPayStatus();if (payStatus == 1) {//用户已支付，需要退款String refund = weChatPayUtil.refund(ordersDB.getNumber(),ordersDB.getNumber(),new BigDecimal(0.01),new BigDecimal(0.01));log.info("申请退款：{}", refund);}// 管理端取消订单需要退款，根据订单id更新订单状态、取消原因、取消时间Orders orders = new Orders();orders.setId(ordersCancelDTO.getId());orders.setStatus(Orders.CANCELLED);orders.setCancelReason(ordersCancelDTO.getCancelReason());orders.setCancelTime(LocalDateTime.now());orderMapper.update(orders);}

管理端--派送订单

1. 需求分析和设计

业务规则：

派送订单其实就是将订单状态修改为“派送中”
只有状态为“待派送”的订单可以执行派送订单操作

基本信息

Path： /admin/order/delivery/{id}

Method： PUT

接口描述：

请求参数

路径参数

参数名称	示例	备注
id	101	订单id

返回数据

名称	类型	是否必须	其他信息
code	integer	必须	format: int32
data	object	非必须
msg	string	非必须

7.2 代码实现

7.2.1 admin/OrderController

    /*** 派送订单** @return*/@PutMapping("/delivery/{id}")@ApiOperation("派送订单")public Result delivery(@PathVariable("id") Long id) {orderService.delivery(id);return Result.success();}

7.2.2 OrderService

    /*** 派送订单** @param id*/void delivery(Long id);

7.2.3 OrderServiceImpl

    /*** 派送订单** @param id*/public void delivery(Long id) {// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在，并且状态为3if (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);}

管理端--完成订单

1. 需求分析和设计

业务规则：

完成订单其实就是将订单状态修改为“已完成”
只有状态为“派送中”的订单可以执行订单完成操作

基本信息

Path： /admin/order/complete/{id}

Method： PUT

接口描述：

请求参数

Headers

参数名称	参数值	是否必须	示例	备注
Content-Type	application/json	是

路径参数

参数名称	示例	备注
id	101	订单id

返回数据

名称	类型	是否必须	其他信息
code	integer	必须	format: int32
data	object	非必须
msg	string	非必须

8.2 代码实现

8.2.1 admin/OrderController

    /*** 完成订单** @return*/@PutMapping("/complete/{id}")@ApiOperation("完成订单")public Result complete(@PathVariable("id") Long id) {orderService.complete(id);return Result.success();}

8.2.2 OrderService

    /*** 完成订单** @param id*/void complete(Long id);

8.2.3 OrderServiceImpl

    /*** 完成订单** @param id*/public void complete(Long id) {// 根据id查询订单Orders ordersDB = orderMapper.getById(id);// 校验订单是否存在，并且状态为4if (ordersDB == null || !ordersDB.getStatus().equals(Orders.DELIVERY_IN_PROGRESS)) {throw new OrderBusinessException(MessageConstant.ORDER_STATUS_ERROR);}Orders orders = new Orders();orders.setId(ordersDB.getId());// 更新订单状态,状态转为完成orders.setStatus(Orders.COMPLETED);orders.setDeliveryTime(LocalDateTime.now());orderMapper.update(orders);}

2. 已有功能优化

优化用户下单功能，加入校验逻辑，如果用户的收货地址距离商家门店超出配送范围（配送范围为5公里内），则下单失败。

提示：

1. 基于百度地图开放平台实现（https://lbsyun.baidu.com/）

2. 注册账号--->创建应用获取AK(服务端应用)--->调用接口

相关接口

地理编码 | 百度地图API SDK

百度地图-百万开发者首选的地图服务商,提供专属的行业解决方案
商家门店地址可以配置在配置文件中，例如：
```
sky:shop:address: 北京市海淀区上地十街10号
```

 /*** 检查客户的收获地址是否超出配送范围.* @param address*/private void checkOutOfRange(String address){Map map = new HashMap();map.put("address", shopAddress);map.put("output", "json");map.put("ak", ak);// 获取店铺的经纬度坐标String shopCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);JSONObject jsonObject = JSON.parseObject(shopCoordinate);if (!jsonObject.getString("status").equals("0")){throw new OrderBusinessException("店铺地址解析失败");}// 数据解析JSONObject location = jsonObject.getJSONObject("result").getJSONObject("location");String lat = location.getString("lat");String lng = location.getString("lng");// 店铺经纬度坐标String shopLngLat = lat + "," +lng;map.put("address",address);// 获取用户收获地址的经纬度坐标String userCoordinate = HttpClientUtil.doGet("https://api.map.baidu.com/geocoding/v3", map);jsonObject = JSON.parseObject(userCoordinate);if (!jsonObject.getString("status").equals("0")){throw new OrderBusinessException("收货地址解析失败");}// 数据解析location = jsonObject.getJSONObject("result").getJSONObject("location");lat = location.getString("lat");lng = location.getString("lng");// 用户收货地址经纬度坐标String userLngLat = lat + "," + lng;map.put("origin",shopLngLat);map.put("destination",userLngLat);map.put("steps_info","0");// 路线规划String json = HttpClientUtil.doGet("https://api.map.baidu.com/directionlite/v1/driving", map);jsonObject = JSON.parseObject(json);if (!jsonObject.getString("status").equals("0")){throw new OrderBusinessException("配送路线规划失败");}// 数据解析JSONObject result = jsonObject.getJSONObject("result");JSONArray jsonArray = (JSONArray) result.get("routes");Integer distance = (Integer) ((JSONObject) jsonArray.get(0)).get("distance");if (distance > 10000){//距离超过10000米throw new OrderBusinessException("超出配送范围");}}