# 苍穹外卖 - day08
# 课程内容
功能实现:用户下单、订单支付
用户下单效果图:
订单支付效果图:
# 导入地址簿功能代码
# 需求分析和设计
# 产品原型
地址簿,指的是消费者用户的地址信息,用户登录成功后可以维护自己的地址信息。同一个用户可以有多个地址信息,但是只能有一个默认地址。
效果图:
对于地址簿管理,我们需要实现以下几个功能:
- 查询地址列表
- 新增地址
- 修改地址
- 删除地址
- 设置默认地址
- 查询默认地址
# 接口设计
根据上述原型图先粗粒度设计接口,共包含 7 个接口。
接口设计:
- 新增地址
- 查询登录用户所有地址
- 查询默认地址
- 根据 id 修改地址
- 根据 id 删除地址
- 根据 id 查询地址
- 设置默认地址
接下来细粒度分析每个接口,明确每个接口的请求方式、请求路径、传入参数和返回值。
1). 新增地址
2). 查询登录用户所有地址
3). 查询默认地址
4). 修改地址
5). 根据 id 删除地址
6). 根据 id 查询地址
7). 设置默认地址
# 表设计
用户的地址信息会存储在 address_book 表,即地址簿表中。具体表结构如下:
字段名 | 数据类型 | 说明 | 备注 |
---|
id | bigint | 主键 | 自增 |
user_id | bigint | 用户 id | 逻辑外键 |
consignee | varchar(50) | 收货人 | |
sex | varchar(2) | 性别 | |
phone | varchar(11) | 手机号 | |
province_code | varchar(12) | 省份编码 | |
province_name | varchar(32) | 省份名称 | |
city_code | varchar(12) | 城市编码 | |
city_name | varchar(32) | 城市名称 | |
district_code | varchar(12) | 区县编码 | |
district_name | varchar(32) | 区县名称 | |
detail | varchar(200) | 详细地址信息 | 具体到门牌号 |
label | varchar(100) | 标签 | 公司、家、学校 |
is_default | tinyint(1) | 是否默认地址 | 1 是 0 否 |
这里面有一个字段 is_default,实际上我们在设置默认地址时,只需要更新这个字段就可以了。
# 代码导入
对于这一类的单表的增删改查,我们已经写过很多了,基本的开发思路都是一样的,那么本小节的用户地址簿管理的增删改查功能,我们就不再一一实现了,基本的代码我们都已经提供了,直接导入进来,做一个测试即可。
导入课程资料中的地址簿模块功能代码:
进入到 sky-server 模块中
# Mapper 层
创建 AddressBookMapper.java
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
| package com.sky.mapper;
import com.sky.entity.AddressBook; import org.apache.ibatis.annotations.*; import java.util.List;
@Mapper public interface AddressBookMapper {
List<AddressBook> list(AddressBook addressBook);
@Insert("insert into address_book" + " (user_id, consignee, phone, sex, province_code, province_name, city_code, city_name, district_code," + " district_name, detail, label, is_default)" + " values (#{userId}, #{consignee}, #{phone}, #{sex}, #{provinceCode}, #{provinceName}, #{cityCode}, #{cityName}," + " #{districtCode}, #{districtName}, #{detail}, #{label}, #{isDefault})") void insert(AddressBook addressBook);
@Select("select * from address_book where id = #{id}") AddressBook getById(Long id);
void update(AddressBook addressBook);
@Update("update address_book set is_default = #{isDefault} where user_id = #{userId}") void updateIsDefaultByUserId(AddressBook addressBook);
@Delete("delete from address_book where id = #{id}") void deleteById(Long id);
}
|
创建 AddressBookMapper.xml
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45
| <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" > <mapper namespace="com.sky.mapper.AddressBookMapper">
<select id="list" parameterType="AddressBook" resultType="AddressBook"> select * from address_book <where> <if test="userId != null"> and user_id = #{userId} </if> <if test="phone != null"> and phone = #{phone} </if> <if test="isDefault != null"> and is_default = #{isDefault} </if> </where> </select>
<update id="update" parameterType="addressBook"> update address_book <set> <if test="consignee != null"> consignee = #{consignee}, </if> <if test="sex != null"> sex = #{sex}, </if> <if test="phone != null"> phone = #{phone}, </if> <if test="detail != null"> detail = #{detail}, </if> <if test="label != null"> label = #{label}, </if> <if test="isDefault != null"> is_default = #{isDefault}, </if> </set> where id = #{id} </update>
</mapper>
|
# Service 层
创建 AddressBookService.java
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
| package com.sky.service;
import com.sky.entity.AddressBook; import java.util.List;
public interface AddressBookService {
List<AddressBook> list(AddressBook addressBook);
void save(AddressBook addressBook);
AddressBook getById(Long id);
void update(AddressBook addressBook);
void setDefault(AddressBook addressBook);
void deleteById(Long id);
}
|
创建 AddressBookServiceImpl.java
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86
| package com.sky.service.impl;
import com.sky.context.BaseContext; import com.sky.entity.AddressBook; import com.sky.mapper.AddressBookMapper; import com.sky.service.AddressBookService; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.util.List;
@Service @Slf4j public class AddressBookServiceImpl implements AddressBookService { @Autowired private AddressBookMapper addressBookMapper;
public List<AddressBook> list(AddressBook addressBook) { return addressBookMapper.list(addressBook); }
public void save(AddressBook addressBook) { addressBook.setUserId(BaseContext.getCurrentId()); addressBook.setIsDefault(0); addressBookMapper.insert(addressBook); }
public AddressBook getById(Long id) { AddressBook addressBook = addressBookMapper.getById(id); return addressBook; }
public void update(AddressBook addressBook) { addressBookMapper.update(addressBook); }
@Transactional public void setDefault(AddressBook addressBook) { addressBook.setIsDefault(0); addressBook.setUserId(BaseContext.getCurrentId()); addressBookMapper.updateIsDefaultByUserId(addressBook);
addressBook.setIsDefault(1); addressBookMapper.update(addressBook); }
public void deleteById(Long id) { addressBookMapper.deleteById(id); }
}
|
# Controller 层
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
| package com.sky.controller.user;
import com.sky.context.BaseContext; import com.sky.entity.AddressBook; import com.sky.result.Result; import com.sky.service.AddressBookService; import io.swagger.annotations.Api; import io.swagger.annotations.ApiOperation; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; import java.util.List;
@RestController @RequestMapping("/user/addressBook") @Api(tags = "C端地址簿接口") public class AddressBookController {
@Autowired private AddressBookService addressBookService;
@GetMapping("/list") @ApiOperation("查询当前登录用户的所有地址信息") public Result<List<AddressBook>> list() { AddressBook addressBook = new AddressBook(); addressBook.setUserId(BaseContext.getCurrentId()); List<AddressBook> list = addressBookService.list(addressBook); return Result.success(list); }
@PostMapping @ApiOperation("新增地址") public Result save(@RequestBody AddressBook addressBook) { addressBookService.save(addressBook); return Result.success(); }
@GetMapping("/{id}") @ApiOperation("根据id查询地址") public Result<AddressBook> getById(@PathVariable Long id) { AddressBook addressBook = addressBookService.getById(id); return Result.success(addressBook); }
@PutMapping @ApiOperation("根据id修改地址") public Result update(@RequestBody AddressBook addressBook) { addressBookService.update(addressBook); return Result.success(); }
@PutMapping("/default") @ApiOperation("设置默认地址") public Result setDefault(@RequestBody AddressBook addressBook) { addressBookService.setDefault(addressBook); return Result.success(); }
@DeleteMapping @ApiOperation("根据id删除地址") public Result deleteById(Long id) { addressBookService.deleteById(id); return Result.success(); }
@GetMapping("default") @ApiOperation("查询默认地址") public Result<AddressBook> getDefault() { AddressBook addressBook = new AddressBook(); addressBook.setIsDefault(1); addressBook.setUserId(BaseContext.getCurrentId()); List<AddressBook> list = addressBookService.list(addressBook);
if (list != null && list.size() == 1) { return Result.success(list.get(0)); }
return Result.error("没有查询到默认地址"); }
}
|
# 功能测试
可以通过如下方式进行测试:
- 查看控制台 sql 和数据库中的数据变化
- Swagger 接口文档测试
- 前后端联调
我们直接使用前后端联调测试:
启动后台服务,编译小程序
登录进入首页 --> 进入个人中心 --> 进入地址管理
1). 新增收货地址
添加两条收货地址:
查看收货地址:
查看数据库:
2). 设置默认收货地址
设置默认地址:
查看数据库:
3). 删除收货地址
进行编辑:
删除地址:
查看数据库:
# 用户下单
# 需求分析和设计
# 产品原型
用户下单业务说明:
在电商系统中,用户是通过下单的方式通知商家,用户已经购买了商品,需要商家进行备货和发货。
用户下单后会产生订单相关数据,订单数据需要能够体现如下信息:
用户将菜品或者套餐加入购物车后,可以点击购物车中的 "去结算" 按钮,页面跳转到订单确认页面,点击 "去支付" 按钮则完成下单操作。
用户点餐业务流程 (效果图):
# 接口设计
接口分析:
接口设计:
# 表设计
用户下单业务对应的数据表为 orders 表和 order_detail 表 (一对多关系,一个订单关联多个订单明细):
表名 | 含义 | 说明 |
---|
orders | 订单表 | 主要存储订单的基本信息 (如:订单号、状态、金额、支付方式、下单用户、收件地址等) |
order_detail | 订单明细表 | 主要存储订单详情信息 (如:该订单关联的套餐及菜品的信息) |
具体的表结构如下:
1). orders 订单表
字段名 | 数据类型 | 说明 | 备注 |
---|
id | bigint | 主键 | 自增 |
number | varchar(50) | 订单号 | |
status | int | 订单状态 | 1 待付款 2 待接单 3 已接单 4 派送中 5 已完成 6 已取消 |
user_id | bigint | 用户 id | 逻辑外键 |
address_book_id | bigint | 地址 id | 逻辑外键 |
order_time | datetime | 下单时间 | |
checkout_time | datetime | 付款时间 | |
pay_method | int | 支付方式 | 1 微信支付 2 支付宝支付 |
pay_status | tinyint | 支付状态 | 0 未支付 1 已支付 2 退款 |
amount | decimal(10,2) | 订单金额 | |
remark | varchar(100) | 备注信息 | |
phone | varchar(11) | 手机号 | 冗余字段 |
address | varchar(255) | 详细地址信息 | 冗余字段 |
consignee | varchar(32) | 收货人 | 冗余字段 |
cancel_reason | varchar(255) | 订单取消原因 | |
rejection_reason | varchar(255) | 拒单原因 | |
cancel_time | datetime | 订单取消时间 | |
estimated_delivery_time | datetime | 预计送达时间 | |
delivery_status | tinyint | 配送状态 | 1 立即送出 0 选择具体时间 |
delivery_time | datetime | 送达时间 | |
pack_amount | int | 打包费 | |
tableware_number | int | 餐具数量 | |
tableware_status | tinyint | 餐具数量状态 | 1 按餐量提供 0 选择具体数量 |
2). order_detail 订单明细表
字段名 | 数据类型 | 说明 | 备注 |
---|
id | bigint | 主键 | 自增 |
name | varchar(32) | 商品名称 | 冗余字段 |
image | varchar(255) | 商品图片路径 | 冗余字段 |
order_id | bigint | 订单 id | 逻辑外键 |
dish_id | bigint | 菜品 id | 逻辑外键 |
setmeal_id | bigint | 套餐 id | 逻辑外键 |
dish_flavor | varchar(50) | 菜品口味 | |
number | int | 商品数量 | |
amount | decimal(10,2) | 商品单价 | |
说明:
用户提交订单时,需要往订单表 orders 中插入一条记录,并且需要往 order_detail 中插入一条或多条记录。
# 代码开发
# DTO 设计
根据用户下单接口的参数设计 DTO:
在 sky-pojo 模块,OrdersSubmitDTO.java 已定义
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
| package com.sky.dto;
import com.fasterxml.jackson.annotation.JsonFormat; import lombok.Data; import java.io.Serializable; import java.math.BigDecimal; import java.time.LocalDateTime;
@Data public class OrdersSubmitDTO implements Serializable { private Long addressBookId; private int payMethod; private String remark; @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss") private LocalDateTime estimatedDeliveryTime; private Integer deliveryStatus; private Integer tablewareNumber; private Integer tablewareStatus; private Integer packAmount; private BigDecimal amount; }
|
# VO 设计
根据用户下单接口的返回结果设计 VO:
在 sky-pojo 模块,OrderSubmitVO.java 已定义
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
| package com.sky.vo;
import lombok.AllArgsConstructor; import lombok.Builder; import lombok.Data; import lombok.NoArgsConstructor; import java.io.Serializable; import java.math.BigDecimal; import java.time.LocalDateTime;
@Data @Builder @NoArgsConstructor @AllArgsConstructor public class OrderSubmitVO implements Serializable { private Long id; private String orderNumber; private BigDecimal orderAmount; private LocalDateTime orderTime; }
|
# Controller 层
创建 OrderController 并提供用户下单方法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43
| package com.sky.controller.user;
import com.sky.dto.OrdersPaymentDTO; import com.sky.dto.OrdersSubmitDTO; import com.sky.result.PageResult; import com.sky.result.Result; import com.sky.service.OrderService; import com.sky.vo.OrderPaymentVO; import com.sky.vo.OrderSubmitVO; import com.sky.vo.OrderVO; 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.*;
@RestController("userOrderController") @RequestMapping("/user/order") @Slf4j @Api(tags = "C端-订单接口") public class OrderController {
@Autowired private OrderService orderService;
@PostMapping("/submit") @ApiOperation("用户下单") public Result<OrderSubmitVO> submit(@RequestBody OrdersSubmitDTO ordersSubmitDTO) { log.info("用户下单:{}", ordersSubmitDTO); OrderSubmitVO orderSubmitVO = orderService.submitOrder(ordersSubmitDTO); return Result.success(orderSubmitVO); }
}
|
# Service 层接口
创建 OrderService 接口,并声明用户下单方法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| package com.sky.service;
import com.sky.dto.*; import com.sky.vo.OrderSubmitVO;
public interface OrderService {
OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO); }
|
# Service 层实现类
创建 OrderServiceImpl 实现 OrderService 接口:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84
| package com.sky.service.impl;
@Service @Slf4j public class OrderServiceImpl implements OrderService { @Autowired private OrderMapper orderMapper; @Autowired private OrderDetailMapper orderDetailMapper; @Autowired private ShoppingCartMapper shoppingCartMapper; @Autowired private AddressBookMapper addressBookMapper;
@Transactional public OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO) { AddressBook addressBook = addressBookMapper.getById(ordersSubmitDTO.getAddressBookId()); if (addressBook == null) { throw new AddressBookBusinessException(MessageConstant.ADDRESS_BOOK_IS_NULL); }
Long userId = BaseContext.getCurrentId(); ShoppingCart shoppingCart = new ShoppingCart(); shoppingCart.setUserId(userId);
List<ShoppingCart> shoppingCartList = shoppingCartMapper.list(shoppingCart); if (shoppingCartList == null || shoppingCartList.size() == 0) { throw new ShoppingCartBusinessException(MessageConstant.SHOPPING_CART_IS_NULL); }
Orders order = new Orders(); BeanUtils.copyProperties(ordersSubmitDTO,order); order.setPhone(addressBook.getPhone()); order.setAddress(addressBook.getDetail()); order.setConsignee(addressBook.getConsignee()); order.setNumber(String.valueOf(System.currentTimeMillis())); order.setUserId(userId); order.setStatus(Orders.PENDING_PAYMENT); order.setPayStatus(Orders.UN_PAID); order.setOrderTime(LocalDateTime.now());
orderMapper.insert(order);
List<OrderDetail> orderDetailList = new ArrayList<>(); for (ShoppingCart cart : shoppingCartList) { OrderDetail orderDetail = new OrderDetail(); BeanUtils.copyProperties(cart, orderDetail); orderDetail.setOrderId(order.getId()); orderDetailList.add(orderDetail); }
orderDetailMapper.insertBatch(orderDetailList);
shoppingCartMapper.deleteByUserId(userId);
OrderSubmitVO orderSubmitVO = OrderSubmitVO.builder() .id(order.getId()) .orderNumber(order.getNumber()) .orderAmount(order.getAmount()) .orderTime(order.getOrderTime()) .build();
return orderSubmitVO; } }
|
# Mapper 层
创建 OrderMapper 接口和对应的 xml 映射文件:
OrderMapper.java
1 2 3 4 5 6 7 8 9 10 11
| package com.sky.mapper;
@Mapper public interface OrderMapper {
void insert(Orders order); }
|
OrderMapper.xml
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
| <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" > <mapper namespace="com.sky.mapper.OrderMapper">
<insert id="insert" parameterType="Orders" useGeneratedKeys="true" keyProperty="id"> insert into orders (number, status, user_id, address_book_id, order_time, checkout_time, pay_method, pay_status, amount, remark, phone, address, consignee, estimated_delivery_time, delivery_status, pack_amount, tableware_number, tableware_status) values (#{number}, #{status}, #{userId}, #{addressBookId}, #{orderTime}, #{checkoutTime}, #{payMethod}, #{payStatus}, #{amount}, #{remark}, #{phone}, #{address}, #{consignee}, #{estimatedDeliveryTime}, #{deliveryStatus}, #{packAmount}, #{tablewareNumber}, #{tablewareStatus}) </insert> </mapper>
|
创建 OrderDetailMapper 接口和对应的 xml 映射文件:
OrderDetailMapper.java
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
| package com.sky.mapper;
import com.sky.entity.OrderDetail; import java.util.List;
@Mapper public interface OrderDetailMapper {
void insertBatch(List<OrderDetail> orderDetails);
}
|
OrderDetailMapper.xml
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
| <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" > <mapper namespace="com.sky.mapper.OrderDetailMapper">
<insert id="insertBatch" parameterType="list"> insert into order_detail (name, order_id, dish_id, setmeal_id, dish_flavor, number, amount, image) values <foreach collection="orderDetails" item="od" separator=","> (#{od.name},#{od.orderId},#{od.dishId},#{od.setmealId},#{od.dishFlavor}, #{od.number},#{od.amount},#{od.image}) </foreach> </insert>
</mapper>
|
# 功能测试
登录小程序,完成下单操作
下单操作时,同时会删除购物车中的数据
查看 shopping_cart 表:
去结算 --> 去支付
查看 orders 表:
查看 order_detail 表:
同时,购物车表中数据删除:
# 订单支付
# 微信支付介绍
前面的课程已经实现了用户下单,那接下来就是订单支付,就是完成付款功能。支付大家应该都不陌生了,在现实生活中经常购买商品并且使用支付功能来付款,在付款的时候可能使用比较多的就是微信支付和支付宝支付了。在苍穹外卖项目中,选择的就是微信支付这种支付方式。
要实现微信支付就需要注册微信支付的一个商户号,这个商户号是必须要有一家企业并且有正规的营业执照。只有具备了这些资质之后,才可以去注册商户号,才能开通支付权限。
个人不具备这种资质,所以我们在学习微信支付时,最重要的是了解微信支付的流程,并且能够阅读微信官方提供的接口文档,能够和第三方支付平台对接起来就可以了。
微信支付产品:
本项目选择小程序支付
参考:https://pay.weixin.qq.com/static/product/product_index.shtml
微信支付接入流程:
微信小程序支付时序图:
微信支付相关接口:
JSAPI 下单:
商户系统调用该接口在微信支付服务后台生成预支付交易单 (对应时序图的第 5 步)
微信小程序调起支付:
通过 JSAPI 下单接口获取到发起支付的必要参数 prepay_id,然后使用微信支付提供的小程序方法调起小程序支付 (对应时序图的第 10 步)
# 微信支付准备工作
# 如何保证数据安全?
完成微信支付有两个关键的步骤:
第一个就是需要在商户系统当中调用微信后台的一个下单接口,就是生成预支付交易单。
第二个就是支付成功之后微信后台会给推送消息。
这两个接口数据的安全性,要求其实是非常高的。
解决:
微信提供的方式就是对数据进行加密、解密、签名多种方式。要完成数据加密解密,需要提前准备相应的一些文件,其实就是一些证书。
获取微信支付平台证书、商户私钥文件:
在后绪程序开发过程中,就会使用到这两个文件,需要提前把这两个文件准备好。
# 如何调用到商户系统?
微信后台会调用到商户系统给推送支付的结果,在这里我们就会遇到一个问题,就是微信后台怎么就能调用到我们这个商户系统呢?因为这个调用过程,其实本质上也是一个 HTTP 请求。
目前,商户系统它的 ip 地址就是当前自己电脑的 ip 地址,只是一个局域网内的 ip 地址,微信后台无法调用到。
解决:内网穿透。通过 cpolar 软件可以获得一个临时域名,而这个临时域名是一个公网 ip,这样,微信后台就可以请求到商户系统了。
cpolar 软件的使用:
1). 下载与安装
下载地址:https://dashboard.cpolar.com/get-started
在资料中已提供,可无需下载。
安装过程中,一直下一步即可,不再演示。
2). cpolar 指定 authtoken
复制 authtoken:
执行命令:
3). 获取临时域名
执行命令:
获取域名:
4). 验证临时域名有效性
访问接口文档
使用 localhost:8080 访问
使用临时域名访问
证明临时域名生效。
# 代码导入
导入资料中的微信支付功能代码即可
# 微信支付相关配置
application-dev.yml
1 2 3 4 5 6 7 8 9 10 11
| sky: wechat: appid: wxcd2e39f677fd30ba secret: 84fbfdf5ea288f0c432d829599083637 mchid : 1561414331 mchSerialNo: 4B3B3DC35414AD50B1B755BAF8DE9CC7CF407606 privateKeyFilePath: D:\apiclient_key.pem apiV3Key: CZBK51236435wxpay435434323FFDuv3 weChatPayCertFilePath: D:\wechatpay_166D96F876F45C7D07CE98952A96EC980368ACFC.pem notifyUrl: https://www.weixin.qq.com/wxpay/pay.php refundNotifyUrl: https://www.weixin.qq.com/wxpay/pay.php
|
application.yml
1 2 3 4 5 6 7 8 9 10 11 12
| sky: wechat: appid: ${sky.wechat.appid} secret: ${sky.wechat.secret} mchid : ${sky.wechat.mchid} mchSerialNo: ${sky.wechat.mchSerialNo} privateKeyFilePath: ${sky.wechat.privateKeyFilePath} apiV3Key: ${sky.wechat.apiV3Key} weChatPayCertFilePath: ${sky.wechat.weChatPayCertFilePath} notifyUrl: ${sky.wechat.notifyUrl} refundNotifyUrl: ${sky.wechat.refundNotifyUrl}
|
WeChatProperties.java:读取配置 (已定义)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
| package com.sky.properties;
import lombok.Data; import org.springframework.beans.factory.annotation.Value; import org.springframework.boot.context.properties.ConfigurationProperties; import org.springframework.stereotype.Component;
@Component @ConfigurationProperties(prefix = "sky.wechat") @Data public class WeChatProperties {
private String appid; private String secret; private String mchid; private String mchSerialNo; private String privateKeyFilePath; private String apiV3Key; private String weChatPayCertFilePath; private String notifyUrl; private String refundNotifyUrl; }
|
# Mapper 层
在 OrderMapper.java 中添加 getByNumberAndUserId 和 update 两个方法
1 2 3 4 5 6 7 8 9 10 11 12 13
|
@Select("select * from orders where number = #{orderNumber} and user_id= #{userId}") Orders getByNumberAndUserId(String orderNumber, Long userId);
void update(Orders orders);
|
在 OrderMapper.xml 中添加
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
| <update id="update" parameterType="com.sky.entity.Orders"> update orders <set> <if test="cancelReason != null and cancelReason!='' "> cancel_reason=#{cancelReason}, </if> <if test="rejectionReason != null and rejectionReason!='' "> rejection_reason=#{rejectionReason}, </if> <if test="cancelTime != null"> cancel_time=#{cancelTime}, </if> <if test="payStatus != null"> pay_status=#{payStatus}, </if> <if test="payMethod != null"> pay_method=#{payMethod}, </if> <if test="checkoutTime != null"> checkout_time=#{checkoutTime}, </if> <if test="status != null"> status = #{status}, </if> <if test="deliveryTime != null"> delivery_time = #{deliveryTime} </if> </set> where id = #{id} </update>
|
# Service 层
在 OrderService.java 中添加 payment 和 paySuccess 两个方法定义
1 2 3 4 5 6 7 8 9 10 11 12
|
OrderPaymentVO payment(OrdersPaymentDTO ordersPaymentDTO) throws Exception;
void paySuccess(String outTradeNo);
|
在 OrderServiceImpl.java 中实现 payment 和 paySuccess 两个方法
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
| @Autowired private UserMapper userMapper; @Autowired private WeChatPayUtil weChatPayUtil;
public OrderPaymentVO payment(OrdersPaymentDTO ordersPaymentDTO) throws Exception { Long userId = BaseContext.getCurrentId(); User user = userMapper.getById(userId);
JSONObject jsonObject = weChatPayUtil.pay( ordersPaymentDTO.getOrderNumber(), new BigDecimal(0.01), "苍穹外卖订单", user.getOpenid() );
if (jsonObject.getString("code") != null && jsonObject.getString("code").equals("ORDERPAID")) { throw new OrderBusinessException("该订单已支付"); }
OrderPaymentVO vo = jsonObject.toJavaObject(OrderPaymentVO.class); vo.setPackageStr(jsonObject.getString("package"));
return vo; }
public void paySuccess(String outTradeNo) { Long userId = BaseContext.getCurrentId();
Orders ordersDB = orderMapper.getByNumberAndUserId(outTradeNo, userId);
Orders orders = Orders.builder() .id(ordersDB.getId()) .status(Orders.TO_BE_CONFIRMED) .payStatus(Orders.PAID) .checkoutTime(LocalDateTime.now()) .build();
orderMapper.update(orders); }
|
# Controller 层
在 OrderController.java 中添加 payment 方法
1 2 3 4 5 6 7 8 9 10 11 12 13 14
|
@PutMapping("/payment") @ApiOperation("订单支付") public Result<OrderPaymentVO> payment(@RequestBody OrdersPaymentDTO ordersPaymentDTO) throws Exception { log.info("订单支付:{}", ordersPaymentDTO); OrderPaymentVO orderPaymentVO = orderService.payment(ordersPaymentDTO); log.info("生成预支付交易单:{}", orderPaymentVO); return Result.success(orderPaymentVO); }
|
PayNotifyController.java
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118
| package com.sky.controller.notify;
import com.alibaba.druid.support.json.JSONUtils; import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.JSONObject; import com.sky.annotation.IgnoreToken; import com.sky.properties.WeChatProperties; import com.sky.service.OrderService; import com.wechat.pay.contrib.apache.httpclient.util.AesUtil; import lombok.extern.slf4j.Slf4j; import org.apache.http.entity.ContentType; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.BufferedReader; import java.nio.charset.StandardCharsets; import java.util.HashMap;
@RestController @RequestMapping("/notify") @Slf4j public class PayNotifyController { @Autowired private OrderService orderService; @Autowired private WeChatProperties weChatProperties;
@RequestMapping("/paySuccess") public void paySuccessNotify(HttpServletRequest request, HttpServletResponse response) throws Exception { String body = readData(request); log.info("支付成功回调:{}", body);
String plainText = decryptData(body); log.info("解密后的文本:{}", plainText);
JSONObject jsonObject = JSON.parseObject(plainText); String outTradeNo = jsonObject.getString("out_trade_no"); String transactionId = jsonObject.getString("transaction_id");
log.info("商户平台订单号:{}", outTradeNo); log.info("微信支付交易号:{}", transactionId);
orderService.paySuccess(outTradeNo);
responseToWeixin(response); }
private String readData(HttpServletRequest request) throws Exception { BufferedReader reader = request.getReader(); StringBuilder result = new StringBuilder(); String line = null; while ((line = reader.readLine()) != null) { if (result.length() > 0) { result.append("\n"); } result.append(line); } return result.toString(); }
private String decryptData(String body) throws Exception { JSONObject resultObject = JSON.parseObject(body); JSONObject resource = resultObject.getJSONObject("resource"); String ciphertext = resource.getString("ciphertext"); String nonce = resource.getString("nonce"); String associatedData = resource.getString("associated_data");
AesUtil aesUtil = new AesUtil(weChatProperties.getApiV3Key().getBytes(StandardCharsets.UTF_8)); String plainText = aesUtil.decryptToString(associatedData.getBytes(StandardCharsets.UTF_8), nonce.getBytes(StandardCharsets.UTF_8), ciphertext);
return plainText; }
private void responseToWeixin(HttpServletResponse response) throws Exception{ response.setStatus(200); HashMap<Object, Object> map = new HashMap<>(); map.put("code", "SUCCESS"); map.put("message", "SUCCESS"); response.setHeader("Content-type", ContentType.APPLICATION_JSON.toString()); response.getOutputStream().write(JSONUtils.toJSONString(map).getBytes(StandardCharsets.UTF_8)); response.flushBuffer(); } }
|
# 功能测试
测试过程中,可通过断点方式查看后台每一步执行情况。
下单:
去支付:
确认支付:
进行扫码支付即可。