up:: SpringBoot电商项目订单模块前台订单详情接口

说明:

(1) 本篇博客主要内容:开发【前台:订单列表】接口;

(2) 本篇博客一个并没有深入研究的疑问,这儿只是做了简单的尝试:

● 我们在实例化PageInfo的时候,一定要通过Mybatis直接查询出来的List,去实例化吗?:

● 但是,在这儿,自己经过实测:发现也是可以的;

● 所以,根据上面的测试发现,我们在实例化PageInfo的时候,但就从使用角度来说,还是比较简单的;

● 但是,就自己来说,在实际操作的时候,如果情况OK并合适(比如,List<Order>和List<OrderVO>,仅仅存在结构上的差别,元素数量等没有改变的话),最好按照本篇博客的做法:【先利用直接通过Mybatis查询出来的List,去实例化PageInfo】→【然后,在把PageInfo的list,设置为我们处理后的List】;(其实,这种方式,有点点怪怪的……)


一:【前台:订单列表】接口介绍;

1.【前台:订单列表】接口,接口文档;

● 这个接口,获取的是:当前用户的、订单列表;自然,一个用户可能有多个订单,所以,这个接口是分页的;(而且,根据接口要求,可以发现,我们可以通过PageInfo去包装分页数据)

● 具体,这个列表中的每个数据,都是订单详情数据;(也就是我们在开发【前台:订单详情】接口时,获取的OrderVO格式的数据)

2.【前台:订单列表】接口,在界面上的表现;


二:正式开发;

1.在OrderController中,创建处理【前台:订单列表】接口请求的方法:list()方法;

 
         /**
          * 【前台:订单列表】接口;
          * @param pageNum
          * @param pageSize
          * @return
          */
         @ApiOperation("订单列表")
         @GetMapping("/order/list")
         public ApiRestResponse list(@RequestParam("pageNum") Integer pageNum,@RequestParam("pageSize") Integer pageSize) {
             PageInfo pageInfo = orderService.listForCustomer(pageNum,  pageSize);
             return ApiRestResponse.success(pageInfo);
         }

说明:

(1) 请求方式、url、参数,要符合接口要求;

(2) 我们在Service层,编写了一个针对获取【前台:订单列表】的逻辑方法:listForCustomer();在下一部分会介绍;

2.在OrderServiceImpl中,定义获取【前台:订单列表】的逻辑方法:listForCustomer();

 
      /**
          * 前台的,获取某用户的订单列表
          * @param pageNum
          * @param pageSize
          * @return
          */
         @Override
         public PageInfo listForCustomer(Integer pageNum, Integer pageSize) {
             //首先,获取当前登录用户的userId;
             Integer userId = UserFilter.currentUser.getId();
             //然后,调用Dao层的方法,去查order表,根据userId查询List<order;
             List<Order> orderList = orderMapper.selectOrderForCustomer(userId);
 
						 //由于接口要求,返回的数据格式,需要是OrderVO;;;所以,编写工具方法:把List<Order拼装成List<OrderVO;
             List<OrderVO> orderVOList = orderListToOrderVOList(orderList);
             //然后,设置分页的:当前页和每页条目数
             PageHelper.startPage(pageNum, pageSize);
             //然后,以Mybatis层返回的查询结果List,得到PageInfo对象
             PageInfo pageInfo = new PageInfo<>(orderList);
             //然后,……
             pageInfo.setList(orderVOList);
             return pageInfo;
         }
 
 
         /**
          * 工具方法:把List<Order拼装成List<OrderVO
          * @param orderList
          * @return
          */
         private List<OrderVO> orderListToOrderVOList(List<Order orderList)
 {
             List<OrderVO> orderVOList = new ArrayList<>();
             for (int i = 0; i < orderList.size(); i++) {
                 Order order = orderList.get(i);
                 //调用getOrderVO()方法,把每个Order拼装成OrderVO
                 OrderVO orderVO = getOrderVO(order);
                 orderVOList.add(orderVO);
             }
             return orderVOList;
         }

` 说明:

(1) 首先,我们根据当前登录用户的userId,去查询隶属于该用户的所有订单信息;(为此,我们在OrderMapper中,定义了一个根据userId查询order的方法)

(2) 然后,编写一个工具方法:按照接口要求,把List<Order>包装成List<OrderVO>;

(3) 然后,因为根据接口对返回数据格式的要求,我们使用PageHelper的PageInfo去包装数据;所以,我们作以下处理;( PS:这儿的处理策略,需要留意哦!

● 有关PageHelper分页的,可以参考【附加PageHelper分页插件的Page和PageInfo的区别】;

(4) 最后,把处理好的PageInfo返回即可;

3.在OrderService中,反向生成listForCustomer()的声明;


三:测试;

启动项目;

发现,其返回的数据是OK的;

 
     {
         "status": 10000,
         "msg": "SUCCESS",
         "data": {
             "total": 2,
             "list": [
                 {
                     "orderNo": "2022040300005586987",
                     "userId": 11,
                     "totalPrice": 222,
                     "receiverName": "小李",
                     "receiverMobile": "18888888888",
                     "receiverAddress": "**市,**区,**街道,**号",
                     "orderStatus": 10,
                     "postage": 0,
                     "paymentType": 1,
                     "deliveryTime": null,
                     "payTime": null,
                     "endTime": null,
                     "createTime": "2022-04-02T16:00:55.000+0000",
                     "updateTime": "2022-04-02T16:00:55.000+0000",
                     "orderStatusName": "未付款",
                     "orderItemVOList": [
                         {
                             "orderNo": "2022040300005586987",
                             "productName": "越南进口红心火龙果 4个装 红肉中果 单果约330-420g",
                             "productImg":"http://111.231.103.117:8081/images/hongxinhuolongguo.jpg",
                             "unitPrice": 222,
                             "quantity": 1,
                             "totalPrice": 222
                         }
                     ]
                 },
                 {
                     "orderNo": "2022033123421453213",
                     "userId": 11,
                     "totalPrice": 484,
                     "receiverName": "小李",
                     "receiverMobile": "18888888888",
                     "receiverAddress": "**市,**区,**街道,**号",
                     "orderStatus": 10,
                     "postage": 0,
                     "paymentType": 1,
                     "deliveryTime": null,
                     "payTime": null,
                     "endTime": null,
                     "createTime": "2022-03-31T15:42:14.000+0000",
                     "updateTime": "2022-03-31T15:42:14.000+0000",
                     "orderStatusName": "未付款",
                     "orderItemVOList": [
                         {
                             "orderNo": "2022033123421453213",
                             "productName": "进口牛油果 中果6粒装 单果约130-160g",
                             "productImg":  "http://111.231.103.117:8081/images/niuyouguo.jpg",
                             "unitPrice": 222,
                             "quantity": 2,
                             "totalPrice": 444
                         },
                         {
                             "orderNo": "2022033123421453213",
                             "productName": "福建六鳌红薯5斤",
                             "productImg":  "http://111.231.103.117:8081/images/hongshu.jpg",
                             "unitPrice": 40,
                             "quantity": 1,
                             "totalPrice": 40
                         }
                     ]
                 }
             ],
             "pageNum": 1,
             "pageSize": 2,
             "size": 2,
             "startRow": 0,
             "endRow": 1,
             "pages": 1,
             "prePage": 0,
             "nextPage": 0,
             "isFirstPage": true,
             "isLastPage": true,
             "hasPreviousPage": false,
             "hasNextPage": false,
             "navigatePages": 8,
             "navigatepageNums": [
                 1
             ],
             "navigateFirstPage": 1,
             "navigateLastPage": 1
         }
     }