yapi

shopping-cart-application-service/src/main/java/cn/freemud/entities/vo/AddShoppingCartGoodsRequestVo.java

@@ -12,6 +12,8 @@
  */
 package cn.freemud.entities.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Builder;
 import lombok.Data;
 import org.hibernate.validator.constraints.NotEmpty;
@@ -19,24 +21,30 @@ import org.hibernate.validator.constraints.NotEmpty;
 import java.util.List;
 
 @Data
+@ApiModel(description = "添加购物车请求参数")
 public class AddShoppingCartGoodsRequestVo extends BaseRequestVo{
 
     @NotEmpty(message = "sessionId不能为空")
+    @ApiModelProperty(value = "sessionId", required = true)
     private String sessionId;
 
     /**
      * 微信appId
      */
+    @ApiModelProperty(value = "appId", required = true)
     @NotEmpty(message = "appId不能为空")
     private String appId;
 
+    @ApiModelProperty(value = "spuId", required = true)
     @NotEmpty(message = "spuId不能为空")
     private String spuId;
 
+    @ApiModelProperty(value = "skuId")
     private String skuId;
     /**
      * 商品额外的属性
      */
+    @ApiModelProperty(value = "skuId")
     private List<CartGoods.CartGoodsExtra> extra;
 
     private String version;
@@ -44,32 +52,39 @@ public class AddShoppingCartGoodsRequestVo extends BaseRequestVo{
     /**
      * 1.6.0 版本增加  节点ID
      */
+    @ApiModelProperty(value = "节点ID")
     private String nodeId;
     /**
      * 1.6.0 版本增加 分类名
      */
+    @ApiModelProperty(value = "分类名")
     private String categoryName;
     /**
      * 套餐固定商品
      */
+    @ApiModelProperty(value = "套餐固定商品")
     private List<ComboxGoodsRequestVo> productComboList;
     /**
      * 套餐可选商品
      */
+    @ApiModelProperty(value = "套餐可选商品")
     private List<ComboxGoodsRequestVo> productGroupList;
 
-
+    @ApiModelProperty(value = "appType")
     private String appType;
 
+    @ApiModelProperty(value = "桌号")
     private String tableNumber;
     /**
      * 数量 
      */
+    @ApiModelProperty(value = "数量")
     private Integer qty;
 
     /**
      * 业务类型： 0 : 自提 1：外卖 2：微商城
      */
+    @ApiModelProperty(value = "业务类型： 0 : 自提 1：外卖 2：微商城")
     private String menuType ;
 
 }

shopping-cart-application-service/src/main/java/cn/freemud/entities/vo/UpdateShoppingCartGoodsQtyRequestVo.java

@@ -12,40 +12,49 @@
  */
 package cn.freemud.entities.vo;
 
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Data;
 import org.hibernate.validator.constraints.NotEmpty;
 
 import javax.validation.constraints.NotNull;
 
+@ApiModel(description = "修改购物车中商品数量")
 @Data
 public class UpdateShoppingCartGoodsQtyRequestVo extends BaseRequestVo {
 
     @NotEmpty(message = "sessionId不能为空")
+    @ApiModelProperty(value = "sessionId", required = true)
     private String sessionId;
 
     @NotEmpty(message = "appId不能为空")
+    @ApiModelProperty(value = "appId", required = true)
     private String appId;
     /**
      * 购物车一行的ID
      */
     @NotEmpty(message = "cartGoodsUid不能为空")
+    @ApiModelProperty(value = "购物车一行的ID", required = true)
     private String cartGoodsUid;
 
     /**
      * 商品数量
      */
     @NotNull(message = "qty不能为空")
+    @ApiModelProperty(value = "数量", required = true)
     private Integer qty;
 
     private String version;
     /**
      * 购物车版本号（围餐）
      */
+    @ApiModelProperty(value = "购物车版本号（围餐）")
     private Integer carVer;
 
     /**
      * 业务类型： 0 : 自提 1：外卖 2：微商城
      */
+    @ApiModelProperty(value = "业务类型： 0 : 自提 1：外卖 2：微商城")
     private String menuType ;
 
 }