Showing
1 changed file
with
38 additions
and
0 deletions
新员工入职培训/查询购物车接口业务逻辑.md
0 → 100644
1 | +查询购物车接口业务逻辑 | ||
2 | +------------ | ||
3 | +##一、入口和返回 | ||
4 | +###1.入口 | ||
5 | +method=app.Shopping.add,参数:uid、sale_channel、shopping_key,皆非必选参数,通常传uid或shopping_key | ||
6 | +postman调用示例: | ||
7 | +http://192.168.102.205:8080/gateway?method=app.Shopping.cart&uid=8041834&debug=XYZ | ||
8 | +该接口由类com.yoho.gateway.controller.order.shopping的cart方法实现, | ||
9 | +@RequestMapping(params = "method=app.Shopping.cart") | ||
10 | +@ResponseBody | ||
11 | +public ApiResponse cart(HttpServletRequest httpServletRequest, | ||
12 | + @RequestParam(value = "sale_channel", required = false) String saleChannel, | ||
13 | + @RequestParam(value = "uid", required = false) Integer uid, | ||
14 | + @RequestParam(value = "shopping_key", required = false) String shoppingKey) | ||
15 | +###2.返回 | ||
16 | +主要分两类数据,预售商品和普通商品,因这两类数据是分开结算的。每类数据包括:促销信息和结算费用,各商品详情等。 | ||
17 | +##二、服务调用 | ||
18 | +该接口会调用order模块的cartShopping服务,该服务会实现具体的查询业务。而该服务具体执行过程中会调用商品和促销模块的相关服务 | ||
19 | +##三、具体实现逻辑 | ||
20 | +1.进入gateway模块的com.yoho.gateway.controller.order.shopping.cart()方法 | ||
21 | +2.cart方法调用order.cartShopping服务 | ||
22 | +3.进入order模块的com.yoho.yhorder.shopping.restapi.ShoppingCartController.query()方法,该方法提供order.cartShopping服务 | ||
23 | +4.query方法调用com.yoho.yhorder.shopping.service.impl.ShoppingCartServiceImpl.query()方法。 | ||
24 | +5.再调用com.yoho.yhorder.shopping.service.impl.ShoppingCartQueryService.query()方法, | ||
25 | +6.在ShoppingCartQueryService.query()方法中开始进行业务操作,先进行普通商品算费,再进行预售商品算费,然后将两类结果包装到ShoppingQueryResponse中返回。具体如下: | ||
26 | +普通商品算费: | ||
27 | +1)构建算费参数对象ChargeParam,设置CartType=ORDINARY_CART_TYPE、ChargeType=ORDINARY_CHARGE_TYPE。 | ||
28 | +2)生成算费上下文ChargeContext ordinaryChargeContext | ||
29 | +3)调用ChargerService.charge()进行算费,算费结果在ChargeContext对象的ChargeTotal中 | ||
30 | +4)从ChargeContext中取出结果信息ShoppingChargeResult ordinaryChargeResult。 | ||
31 | +预售商品算费: | ||
32 | +1)生成预售商品算费上下文ChargeContext preSaleChargeContext | ||
33 | +2)构建预售商品算费对象(CartType=PRESALE_CART_TYPE、ChargeType=ADVANCE_CHARGE_TYPE)并设置到上下文preSaleChargeContext中,同时将商品列表(从ordinaryChargeContext获取)和用户信息保存上下文中。 | ||
34 | +3)调用ChargerService.charge()进行算费。 | ||
35 | +4)从preSaleChargeContext取出结果信息ShoppingChargeResult preSaleChargeResult | ||
36 | +由ordinaryChargeResult和preSaleChargeResult构造结果ShoppingQueryResponse response,并返回。 | ||
37 | + | ||
38 | +###在ShoppingCartQueryService.query()中涉及到两个公共的业务:构建算费上下文和算费。具体实现见后续文档 |
-
Please register or login to post a comment