当前位置:   article > 正文

苍穹外卖-day08 java实现 微信支付_update address_book set is_default = #{isdefault}

update address_book set is_default = #{isdefault} where user_id = #{userid}

苍穹外卖-day08

课程内容

  • 导入地址簿功能代码
  • 用户下单
  • 订单支付

功能实现:用户下单订单支付

用户下单效果图:

订单支付效果图:

1. 导入地址簿功能代码

1.1 需求分析和设计

1.1.1 产品原型

地址簿,指的是消费者用户的地址信息,用户登录成功后可以维护自己的地址信息。同一个用户可以有多个地址信息,但是只能有一个默认地址

效果图:

对于地址簿管理,我们需要实现以下几个功能:

  • 查询地址列表
  • 新增地址
  • 修改地址
  • 删除地址
  • 设置默认地址
  • 查询默认地址
1.1.2 接口设计

根据上述原型图粗粒度设计接口,共包含7个接口。

接口设计:

  • 新增地址
  • 查询登录用户所有地址
  • 查询默认地址
  • 根据id修改地址
  • 根据id删除地址
  • 根据id查询地址
  • 设置默认地址

接下来细粒度分析每个接口,明确每个接口的请求方式、请求路径、传入参数和返回值。

1). 新增地址

2). 查询登录用户所有地址

3). 查询默认地址

4). 修改地址

5). 根据id删除地址

6). 根据id查询地址

7). 设置默认地址

1.1.3 表设计

用户的地址信息会存储在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,实际上我们在设置默认地址时,只需要更新这个字段就可以了。

1.2 代码导入

对于这一类的单表的增删改查,我们已经写过很多了,基本的开发思路都是一样的,那么本小节的用户地址簿管理的增删改查功能,我们就不再一一实现了,基本的代码我们都已经提供了,直接导入进来,做一个测试即可。

导入课程资料中的地址簿模块功能代码:

进入到sky-server模块中

1.2.1 Mapper层

创建AddressBookMapper.java

  1. package com.sky.mapper;
  2. import com.sky.entity.AddressBook;
  3. import org.apache.ibatis.annotations.*;
  4. import java.util.List;
  5. @Mapper
  6. public interface AddressBookMapper {
  7. /**
  8. * 条件查询
  9. * @param addressBook
  10. * @return
  11. */
  12. List<AddressBook> list(AddressBook addressBook);
  13. /**
  14. * 新增
  15. * @param addressBook
  16. */
  17. @Insert("insert into address_book" +
  18. " (user_id, consignee, phone, sex, province_code, province_name, city_code, city_name, district_code," +
  19. " district_name, detail, label, is_default)" +
  20. " values (#{userId}, #{consignee}, #{phone}, #{sex}, #{provinceCode}, #{provinceName}, #{cityCode}, #{cityName}," +
  21. " #{districtCode}, #{districtName}, #{detail}, #{label}, #{isDefault})")
  22. void insert(AddressBook addressBook);
  23. /**
  24. * 根据id查询
  25. * @param id
  26. * @return
  27. */
  28. @Select("select * from address_book where id = #{id}")
  29. AddressBook getById(Long id);
  30. /**
  31. * 根据id修改
  32. * @param addressBook
  33. */
  34. void update(AddressBook addressBook);
  35. /**
  36. * 根据 用户id修改 是否默认地址
  37. * @param addressBook
  38. */
  39. @Update("update address_book set is_default = #{isDefault} where user_id = #{userId}")
  40. void updateIsDefaultByUserId(AddressBook addressBook);
  41. /**
  42. * 根据id删除地址
  43. * @param id
  44. */
  45. @Delete("delete from address_book where id = #{id}")
  46. void deleteById(Long id);
  47. }

创建AddressBookMapper.xml

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
  3. <mapper namespace="com.sky.mapper.AddressBookMapper">
  4. <select id="list" parameterType="AddressBook" resultType="AddressBook">
  5. select * from address_book
  6. <where>
  7. <if test="userId != null">
  8. and user_id = #{userId}
  9. </if>
  10. <if test="phone != null">
  11. and phone = #{phone}
  12. </if>
  13. <if test="isDefault != null">
  14. and is_default = #{isDefault}
  15. </if>
  16. </where>
  17. </select>
  18. <update id="update" parameterType="addressBook">
  19. update address_book
  20. <set>
  21. <if test="consignee != null">
  22. consignee = #{consignee},
  23. </if>
  24. <if test="sex != null">
  25. sex = #{sex},
  26. </if>
  27. <if test="phone != null">
  28. phone = #{phone},
  29. </if>
  30. <if test="detail != null">
  31. detail = #{detail},
  32. </if>
  33. <if test="label != null">
  34. label = #{label},
  35. </if>
  36. <if test="isDefault != null">
  37. is_default = #{isDefault},
  38. </if>
  39. </set>
  40. where id = #{id}
  41. </update>
  42. </mapper>
1.2.2 Service层

创建AddressBookService.java

  1. package com.sky.service;
  2. import com.sky.entity.AddressBook;
  3. import java.util.List;
  4. public interface AddressBookService {
  5. List<AddressBook> list(AddressBook addressBook);
  6. void save(AddressBook addressBook);
  7. AddressBook getById(Long id);
  8. void update(AddressBook addressBook);
  9. void setDefault(AddressBook addressBook);
  10. void deleteById(Long id);
  11. }

创建AddressBookServiceImpl.java

  1. package com.sky.service.impl;
  2. import com.sky.context.BaseContext;
  3. import com.sky.entity.AddressBook;
  4. import com.sky.mapper.AddressBookMapper;
  5. import com.sky.service.AddressBookService;
  6. import lombok.extern.slf4j.Slf4j;
  7. import org.springframework.beans.factory.annotation.Autowired;
  8. import org.springframework.stereotype.Service;
  9. import org.springframework.transaction.annotation.Transactional;
  10. import java.util.List;
  11. @Service
  12. @Slf4j
  13. public class AddressBookServiceImpl implements AddressBookService {
  14. @Autowired
  15. private AddressBookMapper addressBookMapper;
  16. /**
  17. * 条件查询
  18. *
  19. * @param addressBook
  20. * @return
  21. */
  22. public List<AddressBook> list(AddressBook addressBook) {
  23. return addressBookMapper.list(addressBook);
  24. }
  25. /**
  26. * 新增地址
  27. *
  28. * @param addressBook
  29. */
  30. public void save(AddressBook addressBook) {
  31. addressBook.setUserId(BaseContext.getCurrentId());
  32. addressBook.setIsDefault(0);
  33. addressBookMapper.insert(addressBook);
  34. }
  35. /**
  36. * 根据id查询
  37. *
  38. * @param id
  39. * @return
  40. */
  41. public AddressBook getById(Long id) {
  42. AddressBook addressBook = addressBookMapper.getById(id);
  43. return addressBook;
  44. }
  45. /**
  46. * 根据id修改地址
  47. *
  48. * @param addressBook
  49. */
  50. public void update(AddressBook addressBook) {
  51. addressBookMapper.update(addressBook);
  52. }
  53. /**
  54. * 设置默认地址
  55. *
  56. * @param addressBook
  57. */
  58. @Transactional
  59. public void setDefault(AddressBook addressBook) {
  60. //1、将当前用户的所有地址修改为非默认地址 update address_book set is_default = ? where user_id = ?
  61. addressBook.setIsDefault(0);
  62. addressBook.setUserId(BaseContext.getCurrentId());
  63. addressBookMapper.updateIsDefaultByUserId(addressBook);
  64. //2、将当前地址改为默认地址 update address_book set is_default = ? where id = ?
  65. addressBook.setIsDefault(1);
  66. addressBookMapper.update(addressBook);
  67. }
  68. /**
  69. * 根据id删除地址
  70. *
  71. * @param id
  72. */
  73. public void deleteById(Long id) {
  74. addressBookMapper.deleteById(id);
  75. }
  76. }
1.2.3 Controller层
  1. package com.sky.controller.user;
  2. import com.sky.context.BaseContext;
  3. import com.sky.entity.AddressBook;
  4. import com.sky.result.Result;
  5. import com.sky.service.AddressBookService;
  6. import io.swagger.annotations.Api;
  7. import io.swagger.annotations.ApiOperation;
  8. import org.springframework.beans.factory.annotation.Autowired;
  9. import org.springframework.web.bind.annotation.*;
  10. import java.util.List;
  11. @RestController
  12. @RequestMapping("/user/addressBook")
  13. @Api(tags = "C端地址簿接口")
  14. public class AddressBookController {
  15. @Autowired
  16. private AddressBookService addressBookService;
  17. /**
  18. * 查询当前登录用户的所有地址信息
  19. *
  20. * @return
  21. */
  22. @GetMapping("/list")
  23. @ApiOperation("查询当前登录用户的所有地址信息")
  24. public Result<List<AddressBook>> list() {
  25. AddressBook addressBook = new AddressBook();
  26. addressBook.setUserId(BaseContext.getCurrentId());
  27. List<AddressBook> list = addressBookService.list(addressBook);
  28. return Result.success(list);
  29. }
  30. /**
  31. * 新增地址
  32. *
  33. * @param addressBook
  34. * @return
  35. */
  36. @PostMapping
  37. @ApiOperation("新增地址")
  38. public Result save(@RequestBody AddressBook addressBook) {
  39. addressBookService.save(addressBook);
  40. return Result.success();
  41. }
  42. @GetMapping("/{id}")
  43. @ApiOperation("根据id查询地址")
  44. public Result<AddressBook> getById(@PathVariable Long id) {
  45. AddressBook addressBook = addressBookService.getById(id);
  46. return Result.success(addressBook);
  47. }
  48. /**
  49. * 根据id修改地址
  50. *
  51. * @param addressBook
  52. * @return
  53. */
  54. @PutMapping
  55. @ApiOperation("根据id修改地址")
  56. public Result update(@RequestBody AddressBook addressBook) {
  57. addressBookService.update(addressBook);
  58. return Result.success();
  59. }
  60. /**
  61. * 设置默认地址
  62. *
  63. * @param addressBook
  64. * @return
  65. */
  66. @PutMapping("/default")
  67. @ApiOperation("设置默认地址")
  68. public Result setDefault(@RequestBody AddressBook addressBook) {
  69. addressBookService.setDefault(addressBook);
  70. return Result.success();
  71. }
  72. /**
  73. * 根据id删除地址
  74. *
  75. * @param id
  76. * @return
  77. */
  78. @DeleteMapping
  79. @ApiOperation("根据id删除地址")
  80. public Result deleteById(Long id) {
  81. addressBookService.deleteById(id);
  82. return Result.success();
  83. }
  84. /**
  85. * 查询默认地址
  86. */
  87. @GetMapping("default")
  88. @ApiOperation("查询默认地址")
  89. public Result<AddressBook> getDefault() {
  90. //SQL:select * from address_book where user_id = ? and is_default = 1
  91. AddressBook addressBook = new AddressBook();
  92. addressBook.setIsDefault(1);
  93. addressBook.setUserId(BaseContext.getCurrentId());
  94. List<AddressBook> list = addressBookService.list(addressBook);
  95. if (list != null && list.size() == 1) {
  96. return Result.success(list.get(0));
  97. }
  98. return Result.error("没有查询到默认地址");
  99. }
  100. }

1.3 功能测试

可以通过如下方式进行测试:

  • 查看控制台sql和数据库中的数据变化
  • Swagger接口文档测试
  • 前后端联调

我们直接使用前后端联调测试:

启动后台服务,编译小程序

登录进入首页-->进入个人中心-->进入地址管理

1). 新增收货地址

添加两条收货地址:

查看收货地址:

查看数据库:

2). 设置默认收货地址

设置默认地址:

查看数据库:

3). 删除收货地址

进行编辑:

删除地址:

1.4 代码提交

后续步骤和其它功能代码提交一致,不再赘述。

2. 用户下单

2.1 需求分析和设计

2.1.1 产品原型

用户下单业务说明:

在电商系统中,用户是通过下单的方式通知商家,用户已经购买了商品,需要商家进行备货和发货。

用户下单后会产生订单相关数据,订单数据需要能够体现如下信息:

用户将菜品或者套餐加入购物车后,可以点击购物车中的 "去结算" 按钮,页面跳转到订单确认页面,点击 "去支付" 按钮则完成下单操作。

用户点餐业务流程(效果图):

2.1.2 接口设计

接口分析:

接口设计:

2.1.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中插入一条或多条记录。

2.2 代码开发

2.2.1 DTO设计

根据用户下单接口的参数设计DTO:

在sky-pojo模块,OrdersSubmitDTO.java已定义

  1. package com.sky.dto;
  2. import com.fasterxml.jackson.annotation.JsonFormat;
  3. import lombok.Data;
  4. import java.io.Serializable;
  5. import java.math.BigDecimal;
  6. import java.time.LocalDateTime;
  7. @Data
  8. public class OrdersSubmitDTO implements Serializable {
  9. //地址簿id
  10. private Long addressBookId;
  11. //付款方式
  12. private int payMethod;
  13. //备注
  14. private String remark;
  15. //预计送达时间
  16. @JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
  17. private LocalDateTime estimatedDeliveryTime;
  18. //配送状态 1立即送出 0选择具体时间
  19. private Integer deliveryStatus;
  20. //餐具数量
  21. private Integer tablewareNumber;
  22. //餐具数量状态 1按餐量提供 0选择具体数量
  23. private Integer tablewareStatus;
  24. //打包费
  25. private Integer packAmount;
  26. //总金额
  27. private BigDecimal amount;
  28. }
2.2.2 VO设计

根据用户下单接口的返回结果设计VO:

在sky-pojo模块,OrderSubmitVO.java已定义

  1. package com.sky.vo;
  2. import java.math.BigDecimal;
  3. import java.time.LocalDateTime;
  4. @Data
  5. @Builder
  6. @NoArgsConstructor
  7. @AllArgsConstructor
  8. public class OrderSubmitVO implements Serializable {
  9. //订单id
  10. private Long id;
  11. //订单号
  12. private String orderNumber;
  13. //订单金额
  14. private BigDecimal orderAmount;
  15. //下单时间
  16. private LocalDateTime orderTime;
  17. }
2.2.3 Controller层

创建OrderController并提供用户下单方法:

  1. package com.sky.controller.user;
  2. import org.springframework.beans.factory.annotation.Autowired;
  3. import org.springframework.web.bind.annotation.*;
  4. /**
  5. * 订单
  6. */
  7. @RestController("userOrderController")
  8. @RequestMapping("/user/order")
  9. @Slf4j
  10. @Api(tags = "C端-订单接口")
  11. public class OrderController {
  12. @Autowired
  13. private OrderService orderService;
  14. /**
  15. * 用户下单
  16. *
  17. * @param ordersSubmitDTO
  18. * @return
  19. */
  20. @PostMapping("/submit")
  21. @ApiOperation("用户下单")
  22. public Result<OrderSubmitVO> submit(@RequestBody OrdersSubmitDTO ordersSubmitDTO) {
  23. log.info("用户下单:{}", ordersSubmitDTO);
  24. OrderSubmitVO orderSubmitVO = orderService.submitOrder(ordersSubmitDTO);
  25. return Result.success(orderSubmitVO);
  26. }
  27. }
2.2.4 Service层接口

创建OrderService接口,并声明用户下单方法:

  1. package com.sky.service;
  2. import com.sky.dto.*;
  3. import com.sky.vo.OrderSubmitVO;
  4. public interface OrderService {
  5. /**
  6. * 用户下单
  7. * @param ordersSubmitDTO
  8. * @return
  9. */
  10. OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO);
  11. }
2.2.5 Service层实现类

创建OrderServiceImpl实现OrderService接口:

  1. package com.sky.service.impl;
  2. /**
  3. * 订单
  4. */
  5. @Service
  6. @Slf4j
  7. public class OrderServiceImpl implements OrderService {
  8. @Autowired
  9. private OrderMapper orderMapper;
  10. @Autowired
  11. private OrderDetailMapper orderDetailMapper;
  12. @Autowired
  13. private ShoppingCartMapper shoppingCartMapper;
  14. @Autowired
  15. private AddressBookMapper addressBookMapper;
  16. /**
  17. * 用户下单
  18. *
  19. * @param ordersSubmitDTO
  20. * @return
  21. */
  22. @Transactional
  23. public OrderSubmitVO submitOrder(OrdersSubmitDTO ordersSubmitDTO) {
  24. //异常情况的处理(收货地址为空、超出配送范围、购物车为空)
  25. AddressBook addressBook = addressBookMapper.getById(ordersSubmitDTO.getAddressBookId());
  26. if (addressBook == null) {
  27. throw new AddressBookBusinessException(MessageConstant.ADDRESS_BOOK_IS_NULL);
  28. }
  29. Long userId = BaseContext.getCurrentId();
  30. ShoppingCart shoppingCart = new ShoppingCart();
  31. shoppingCart.setUserId(userId);
  32. //查询当前用户的购物车数据
  33. List<ShoppingCart> shoppingCartList = shoppingCartMapper.list(shoppingCart);
  34. if (shoppingCartList == null || shoppingCartList.size() == 0) {
  35. throw new ShoppingCartBusinessException(MessageConstant.SHOPPING_CART_IS_NULL);
  36. }
  37. //构造订单数据
  38. Orders order = new Orders();
  39. BeanUtils.copyProperties(ordersSubmitDTO,order);
  40. order.setPhone(addressBook.getPhone());
  41. order.setAddress(addressBook.getDetail());
  42. order.setConsignee(addressBook.getConsignee());
  43. order.setNumber(String.valueOf(System.currentTimeMillis()));
  44. order.setUserId(userId);
  45. order.setStatus(Orders.PENDING_PAYMENT);
  46. order.setPayStatus(Orders.UN_PAID);
  47. order.setOrderTime(LocalDateTime.now());
  48. //向订单表插入1条数据
  49. orderMapper.insert(order);
  50. //订单明细数据
  51. List<OrderDetail> orderDetailList = new ArrayList<>();
  52. for (ShoppingCart cart : shoppingCartList) {
  53. OrderDetail orderDetail = new OrderDetail();
  54. BeanUtils.copyProperties(cart, orderDetail);
  55. orderDetail.setOrderId(order.getId());
  56. orderDetailList.add(orderDetail);
  57. }
  58. //向明细表插入n条数据
  59. orderDetailMapper.insertBatch(orderDetailList);
  60. //清理购物车中的数据
  61. shoppingCartMapper.deleteByUserId(userId);
  62. //封装返回结果
  63. OrderSubmitVO orderSubmitVO = OrderSubmitVO.builder()
  64. .id(order.getId())
  65. .orderNumber(order.getNumber())
  66. .orderAmount(order.getAmount())
  67. .orderTime(order.getOrderTime())
  68. .build();
  69. return orderSubmitVO;
  70. }
  71. }
2.2.6 Mapper层

创建OrderMapper接口和对应的xml映射文件:

OrderMapper.java

  1. package com.sky.mapper;
  2. @Mapper
  3. public interface OrderMapper {
  4. /**
  5. * 插入订单数据
  6. * @param order
  7. */
  8. void insert(Orders order);
  9. }

OrderMapper.xml

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
  3. <mapper namespace="com.sky.mapper.OrderMapper">
  4. <insert id="insert" parameterType="Orders" useGeneratedKeys="true" keyProperty="id">
  5. insert into orders
  6. (number, status, user_id, address_book_id, order_time, checkout_time, pay_method, pay_status, amount, remark,
  7. phone, address, consignee, estimated_delivery_time, delivery_status, pack_amount, tableware_number,
  8. tableware_status)
  9. values (#{number}, #{status}, #{userId}, #{addressBookId}, #{orderTime}, #{checkoutTime}, #{payMethod},
  10. #{payStatus}, #{amount}, #{remark}, #{phone}, #{address}, #{consignee},
  11. #{estimatedDeliveryTime}, #{deliveryStatus}, #{packAmount}, #{tablewareNumber}, #{tablewareStatus})
  12. </insert>
  13. </mapper>

创建OrderDetailMapper接口和对应的xml映射文件:

OrderDetailMapper.java

  1. package com.sky.mapper;
  2. import com.sky.entity.OrderDetail;
  3. import java.util.List;
  4. @Mapper
  5. public interface OrderDetailMapper {
  6. /**
  7. * 批量插入订单明细数据
  8. * @param orderDetails
  9. */
  10. void insertBatch(List<OrderDetail> orderDetails);
  11. }

OrderDetailMapper.xml

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
  3. <mapper namespace="com.sky.mapper.OrderDetailMapper">
  4. <insert id="insertBatch" parameterType="list">
  5. insert into order_detail
  6. (name, order_id, dish_id, setmeal_id, dish_flavor, number, amount, image)
  7. values
  8. <foreach collection="orderDetails" item="od" separator=",">
  9. (#{od.name},#{od.orderId},#{od.dishId},#{od.setmealId},#{od.dishFlavor},
  10. #{od.number},#{od.amount},#{od.image})
  11. </foreach>
  12. </insert>
  13. </mapper>

2.3 功能测试

登录小程序,完成下单操作

下单操作时,同时会删除购物车中的数据

查看shopping_cart表:

去结算-->去支付

2.4 代码提交

后续步骤和其它功能代码提交一致,不再赘述。

3. 订单支付

3.1 微信支付介绍

前面的课程已经实现了用户下单,那接下来就是订单支付,就是完成付款功能。支付大家应该都不陌生了,在现实生活中经常购买商品并且使用支付功能来付款,在付款的时候可能使用比较多的就是微信支付和支付宝支付了。在苍穹外卖项目中,选择的就是微信支付这种支付方式。

要实现微信支付就需要注册微信支付的一个商户号,这个商户号是必须要有一家企业并且有正规的营业执照。只有具备了这些资质之后,才可以去注册商户号,才能开通支付权限。

个人不具备这种资质,所以我们在学习微信支付时,最重要的是了解微信支付的流程,并且能够阅读微信官方提供的接口文档,能够和第三方支付平台对接起来就可以了。

微信支付产品:

本项目选择小程序支付

参考:产品中心 - 微信支付商户平台

微信支付接入流程:

微信小程序支付时序图:

微信支付相关接口:

**JSAPI下单:**商户系统调用该接口在微信支付服务后台生成预支付交易单(对应时序图的第5步)

**微信小程序调起支付:**通过JSAPI下单接口获取到发起支付的必要参数prepay_id,然后使用微信支付提供的小程序方法调起小程序支付(对应时序图的第10步)

3.2 微信支付准备工作

3.2.1 如何保证数据安全?

完成微信支付有两个关键的步骤:

第一个就是需要在商户系统当中调用微信后台的一个下单接口,就是生成预支付交易单。

第二个就是支付成功之后微信后台会给推送消息。

这两个接口数据的安全性,要求其实是非常高的。

**解决:**微信提供的方式就是对数据进行加密、解密、签名多种方式。要完成数据加密解密,需要提前准备相应的一些文件,其实就是一些证书。

获取微信支付平台证书、商户私钥文件:

在后绪程序开发过程中,就会使用到这两个文件,需要提前把这两个文件准备好。

3.2.2 如何调用到商户系统?

微信后台会调用到商户系统给推送支付的结果,在这里我们就会遇到一个问题,就是微信后台怎么就能调用到我们这个商户系统呢?因为这个调用过程,其实本质上也是一个HTTP请求。

目前,商户系统它的ip地址就是当前自己电脑的ip地址,只是一个局域网内的ip地址,微信后台无法调用到。

解决:内网穿透。通过cpolar软件可以获得一个临时域名,而这个临时域名是一个公网ip,这样,微信后台就可以请求到商户系统了。

cpolar软件的使用:

1). 下载与安装

下载地址:cpolar - secure introspectable tunnels to localhost

在资料中已提供,可无需下载。

安装过程中,一直下一步即可,不再演示。

2). cpolar指定authtoken

复制authtoken:

执行命令:

3). 获取临时域名

执行命令:

获取域名:

4). 验证临时域名有效性

访问接口文档

使用localhost:8080访问

使用临时域名访问

证明临时域名生效。

3.3 代码导入

导入资料中的微信支付功能代码即可

3.3.1 微信支付相关配置

application-dev.yml

  1. sky:
  2. wechat:
  3. appid: wxcd2e39f677fd30ba
  4. secret: 84fbfdf5ea288f0c432d829599083637
  5. mchid : 1561414331
  6. mchSerialNo: 4B3B3DC35414AD50B1B755BAF8DE9CC7CF407606
  7. privateKeyFilePath: D:\apiclient_key.pem
  8. apiV3Key: CZBK51236435wxpay435434323FFDuv3
  9. weChatPayCertFilePath: D:\wechatpay_166D96F876F45C7D07CE98952A96EC980368ACFC.pem
  10. notifyUrl: https://www.weixin.qq.com/wxpay/pay.php
  11. refundNotifyUrl: https://www.weixin.qq.com/wxpay/pay.php

application.yml

  1. sky:
  2. wechat:
  3. appid: ${sky.wechat.appid}
  4. secret: ${sky.wechat.secret}
  5. mchid : ${sky.wechat.mchid}
  6. mchSerialNo: ${sky.wechat.mchSerialNo}
  7. privateKeyFilePath: ${sky.wechat.privateKeyFilePath}
  8. apiV3Key: ${sky.wechat.apiV3Key}
  9. weChatPayCertFilePath: ${sky.wechat.weChatPayCertFilePath}
  10. notifyUrl: ${sky.wechat.notifyUrl}
  11. refundNotifyUrl: ${sky.wechat.refundNotifyUrl}

WeChatProperties.java:读取配置(已定义)

  1. package com.sky.properties;
  2. import lombok.Data;
  3. import org.springframework.beans.factory.annotation.Value;
  4. import org.springframework.boot.context.properties.ConfigurationProperties;
  5. import org.springframework.stereotype.Component;
  6. @Component
  7. @ConfigurationProperties(prefix = "sky.wechat")
  8. @Data
  9. public class WeChatProperties {
  10. private String appid; //小程序的appid
  11. private String secret; //小程序的秘钥
  12. private String mchid; //商户号
  13. private String mchSerialNo; //商户API证书的证书序列号
  14. private String privateKeyFilePath; //商户私钥文件
  15. private String apiV3Key; //证书解密的密钥
  16. private String weChatPayCertFilePath; //平台证书
  17. private String notifyUrl; //支付成功的回调地址
  18. private String refundNotifyUrl; //退款成功的回调地址
  19. }
3.3.2 Mapper层

在OrderMapper.java中添加getByNumberAndUserId和update两个方法

  1. /**
  2. * 根据订单号和用户id查询订单
  3. * @param orderNumber
  4. * @param userId
  5. */
  6. @Select("select * from orders where number = #{orderNumber} and user_id= #{userId}")
  7. Orders getByNumberAndUserId(String orderNumber, Long userId);
  8. /**
  9. * 修改订单信息
  10. * @param orders
  11. */
  12. void update(Orders orders);

在OrderMapper.xml中添加

  1. <update id="update" parameterType="com.sky.entity.Orders">
  2. update orders
  3. <set>
  4. <if test="cancelReason != null and cancelReason!='' ">
  5. cancel_reason=#{cancelReason},
  6. </if>
  7. <if test="rejectionReason != null and rejectionReason!='' ">
  8. rejection_reason=#{rejectionReason},
  9. </if>
  10. <if test="cancelTime != null">
  11. cancel_time=#{cancelTime},
  12. </if>
  13. <if test="payStatus != null">
  14. pay_status=#{payStatus},
  15. </if>
  16. <if test="payMethod != null">
  17. pay_method=#{payMethod},
  18. </if>
  19. <if test="checkoutTime != null">
  20. checkout_time=#{checkoutTime},
  21. </if>
  22. <if test="status != null">
  23. status = #{status},
  24. </if>
  25. <if test="deliveryTime != null">
  26. delivery_time = #{deliveryTime}
  27. </if>
  28. </set>
  29. where id = #{id}
  30. </update>
3.3.3 Service层

在OrderService.java中添加payment和paySuccess两个方法定义

  1. /**
  2. * 订单支付
  3. * @param ordersPaymentDTO
  4. * @return
  5. */
  6. OrderPaymentVO payment(OrdersPaymentDTO ordersPaymentDTO) throws Exception;
  7. /**
  8. * 支付成功,修改订单状态
  9. * @param outTradeNo
  10. */
  11. void paySuccess(String outTradeNo);

在OrderServiceImpl.java中实现payment和paySuccess两个方法

  1. @Autowired
  2. private UserMapper userMapper;
  3. @Autowired
  4. private WeChatPayUtil weChatPayUtil;
  5. /**
  6. * 订单支付
  7. *
  8. * @param ordersPaymentDTO
  9. * @return
  10. */
  11. public OrderPaymentVO payment(OrdersPaymentDTO ordersPaymentDTO) throws Exception {
  12. // 当前登录用户id
  13. Long userId = BaseContext.getCurrentId();
  14. User user = userMapper.getById(userId);
  15. //调用微信支付接口,生成预支付交易单
  16. JSONObject jsonObject = weChatPayUtil.pay(
  17. ordersPaymentDTO.getOrderNumber(), //商户订单号
  18. new BigDecimal(0.01), //支付金额,单位 元
  19. "苍穹外卖订单", //商品描述
  20. user.getOpenid() //微信用户的openid
  21. );
  22. if (jsonObject.getString("code") != null && jsonObject.getString("code").equals("ORDERPAID")) {
  23. throw new OrderBusinessException("该订单已支付");
  24. }
  25. OrderPaymentVO vo = jsonObject.toJavaObject(OrderPaymentVO.class);
  26. vo.setPackageStr(jsonObject.getString("package"));
  27. return vo;
  28. }
  29. /**
  30. * 支付成功,修改订单状态
  31. *
  32. * @param outTradeNo
  33. */
  34. public void paySuccess(String outTradeNo) {
  35. // 当前登录用户id
  36. Long userId = BaseContext.getCurrentId();
  37. // 根据订单号查询当前用户的订单
  38. Orders ordersDB = orderMapper.getByNumberAndUserId(outTradeNo, userId);
  39. // 根据订单id更新订单的状态、支付方式、支付状态、结账时间
  40. Orders orders = Orders.builder()
  41. .id(ordersDB.getId())
  42. .status(Orders.TO_BE_CONFIRMED)
  43. .payStatus(Orders.PAID)
  44. .checkoutTime(LocalDateTime.now())
  45. .build();
  46. orderMapper.update(orders);
  47. }
3.3.4 Controller层

在OrderController.java中添加payment方法

  1. /**
  2. * 订单支付
  3. *
  4. * @param ordersPaymentDTO
  5. * @return
  6. */
  7. @PutMapping("/payment")
  8. @ApiOperation("订单支付")
  9. public Result<OrderPaymentVO> payment(@RequestBody OrdersPaymentDTO ordersPaymentDTO) throws Exception {
  10. log.info("订单支付:{}", ordersPaymentDTO);
  11. OrderPaymentVO orderPaymentVO = orderService.payment(ordersPaymentDTO);
  12. log.info("生成预支付交易单:{}", orderPaymentVO);
  13. return Result.success(orderPaymentVO);
  14. }

PayNotifyController.java

  1. package com.sky.controller.notify;
  2. import java.nio.charset.StandardCharsets;
  3. import java.util.HashMap;
  4. /**
  5. * 支付回调相关接口
  6. */
  7. @RestController
  8. @RequestMapping("/notify")
  9. @Slf4j
  10. public class PayNotifyController {
  11. @Autowired
  12. private OrderService orderService;
  13. @Autowired
  14. private WeChatProperties weChatProperties;
  15. /**
  16. * 支付成功回调
  17. *
  18. * @param request
  19. */
  20. @RequestMapping("/paySuccess")
  21. public void paySuccessNotify(HttpServletRequest request, HttpServletResponse response) throws Exception {
  22. //读取数据
  23. String body = readData(request);
  24. log.info("支付成功回调:{}", body);
  25. //数据解密
  26. String plainText = decryptData(body);
  27. log.info("解密后的文本:{}", plainText);
  28. JSONObject jsonObject = JSON.parseObject(plainText);
  29. String outTradeNo = jsonObject.getString("out_trade_no");//商户平台订单号
  30. String transactionId = jsonObject.getString("transaction_id");//微信支付交易号
  31. log.info("商户平台订单号:{}", outTradeNo);
  32. log.info("微信支付交易号:{}", transactionId);
  33. //业务处理,修改订单状态、来单提醒
  34. orderService.paySuccess(outTradeNo);
  35. //给微信响应
  36. responseToWeixin(response);
  37. }
  38. /**
  39. * 读取数据
  40. *
  41. * @param request
  42. * @return
  43. * @throws Exception
  44. */
  45. private String readData(HttpServletRequest request) throws Exception {
  46. BufferedReader reader = request.getReader();
  47. StringBuilder result = new StringBuilder();
  48. String line = null;
  49. while ((line = reader.readLine()) != null) {
  50. if (result.length() > 0) {
  51. result.append("\n");
  52. }
  53. result.append(line);
  54. }
  55. return result.toString();
  56. }
  57. /**
  58. * 数据解密
  59. *
  60. * @param body
  61. * @return
  62. * @throws Exception
  63. */
  64. private String decryptData(String body) throws Exception {
  65. JSONObject resultObject = JSON.parseObject(body);
  66. JSONObject resource = resultObject.getJSONObject("resource");
  67. String ciphertext = resource.getString("ciphertext");
  68. String nonce = resource.getString("nonce");
  69. String associatedData = resource.getString("associated_data");
  70. AesUtil aesUtil = new AesUtil(weChatProperties.getApiV3Key().getBytes(StandardCharsets.UTF_8));
  71. //密文解密
  72. String plainText = aesUtil.decryptToString(associatedData.getBytes(StandardCharsets.UTF_8),
  73. nonce.getBytes(StandardCharsets.UTF_8),
  74. ciphertext);
  75. return plainText;
  76. }
  77. /**
  78. * 给微信响应
  79. * @param response
  80. */
  81. private void responseToWeixin(HttpServletResponse response) throws Exception{
  82. response.setStatus(200);
  83. HashMap<Object, Object> map = new HashMap<>();
  84. map.put("code", "SUCCESS");
  85. map.put("message", "SUCCESS");
  86. response.setHeader("Content-type", ContentType.APPLICATION_JSON.toString());
  87. response.getOutputStream().write(JSONUtils.toJSONString(map).getBytes(StandardCharsets.UTF_8));
  88. response.flushBuffer();
  89. }
  90. }

3.4 功能测试

测试过程中,可通过断点方式查看后台每一步执行情况。

下单:

去支付:

确认支付:

进行扫码支付即可。

3.5 代码提交

后续步骤和其它功能代码提交一致,不再赘述。

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/小小林熬夜学编程/article/detail/504963
推荐阅读
相关标签
  

闽ICP备14008679号