wqy
/
JinTong-Back-Java
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

使用spring doc代替spring fox，openapi 3.0规范

Browse Source
master
FrozenWatermelon 3 years ago
parent a906a9c369
commit 53a2d9644b
98 changed files with 788 additions and 1044 deletions
Show Stats Download Patch File Download Diff File

31
README.md
Unescape View File

@ -45,22 +45,21 @@ uni-app：https://gitee.com/gz-yami/mall4uni
## 技术选型 ## 技术选型
| 技术 | 版本 | 说明 | | 技术 | 版本 | 说明 |
| ---------------------- | ------ | --------------------------------------- | |------------------------|--------|------------------------------|
| Spring Boot | 2.7.0 | MVC核心框架 | | Spring Boot | 2.7.0 | MVC核心框架 |
| Spring Security oauth2 | 2.7.0 | 认证和授权框架 | | Spring Security oauth2 | 2.7.0 | 认证和授权框架 |
| MyBatis | 3.5.0 | ORM框架 | | MyBatis | 3.5.0 | ORM框架 |
| MyBatisPlus | 3.1.0 | 基于mybatis，使用lambda表达式的 | | MyBatisPlus | 3.1.0 | 基于mybatis，使用lambda表达式的 |
| Swagger-UI | 2.9.2 | 文档生产工具 | | spring-doc | 1.6.9 | 接口文档工具 |
| Hibernator-Validator | 6.0.17 | 验证框架 | | Hibernator-Validator | 6.0.17 | 验证框架 |
| redisson | 3.10.6 | 对redis进行封装、集成分布式锁等 | | redisson | 3.10.6 | 对redis进行封装、集成分布式锁等 |
| hikari | 3.2.0 | 数据库连接池 | | hikari | 3.2.0 | 数据库连接池 |
| log4j2 | 2.11.2 | 更快的log日志工具 | | logback | 1.2.11 | log日志工具 |
| fst | 2.57 | 更快的序列化和反序列化工具 | | orika | 1.5.4 | 更快的bean复制工具 |
| orika | 1.5.4 | 更快的bean复制工具 | | lombok | 1.18.8 | 简化对象封装工具 |
| lombok | 1.18.8 | 简化对象封装工具 | | hutool | 5.7.22 | 更适合国人的java工具集 |
| hutool | 5.7.22 | 更适合国人的java工具集 | | knife4j | 4.0.0 | 基于swagger，更便于国人使用的swagger ui |
| knife4j | 3.0.3 | 基于swagger，更便于国人使用的swagger ui |

208
doc/基本框架设计/Swagger文档.md
Unescape View File

@ -1,208 +0,0 @@
> 有很多人不清楚我们的swagger ui的路径，由于我们使用了更为好用的`swagger-bootstrap-ui`，实际上使 域名+端口 +/doc.html，如：http://localhost:8086/doc.html
在没有Swagger之前，我们需要自己手写文档，手写文档的出现问题：
1. 文档更新时需要要与前端人员进行对接，文档存在更新不及时
2. 接口文档多，没有进行分组管理，增加管理难度
3. 不能直接在线接口调试，通常需要借助工具（如postman）,效率大大降低
4. 接口说明与返回结果不明确
而通过swagger就能轻松解决这些问题，而且`spirngboot`整合swagger也相对简单
[swagger官网](https://swagger.io/)
## 添加依赖
```
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>1.9.3</version>
</dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>2.9.2</version>
</dependency>
```
## 添加配置类并开启
在**yami-shop-api**工程中的**config**文件下，有swagger相应的配置类，只要了解具体能配置哪些东西就好了，毕竟这个东西配置一次之后就不用再动了
```java
@Configuration
@EnableSwagger2
public class SwaggerConfiguration {
@Bean
public Docket baseRestApi() {
return new Docket(DocumentationType.SWAGGER_2)
.apiInfo(apiInfo())
.groupName("基础版")
.select()
.apis(RequestHandlerSelectors.basePackage("com.yami.shop.api"))
.paths(PathSelectors.any())
.build();
}
@Bean
public ApiInfo apiInfo() {
return new ApiInfoBuilder()
.title("mall4j商城接口文档")
.description("mall4j商城接口文档Swagger版")
.termsOfServiceUrl("http://www.gz-yami.com/")
.contact(new Contact("广州市蓝海创新科技有限公司","https://www.mall4j.com/", ""))
.version("1.0")
.build();
}
}
```
特别要注意的是里面配置了api文件也就是controller包的路径，不然生成的文档扫描不到接口
```java
apis(RequestHandlerSelectors.basePackage("com.yami.shop.api"))
```
用`@Configuration`注解该类，让spring托管这个类，`@Bean`标注方法等价于XML中配置bean
用`@EnableSwagger2`标识要开启`Swagger2`
## 接口使用
在配置好之后，我们就可以对swagger进行使用,比如在`AreaController`类中
```java
@RestController
@RequestMapping("/p/area")
@Api(tags="省市区接口")
public class AreaController {
@Autowired
private AreaService areaService;
@GetMapping("/listByPid")
@ApiOperation(value="获取省市区信息", notes="根据省市区的pid获取地址信息")
@ApiImplicitParam(name = "pid", value = "省市区的pid(pid为0获取所有省份)", required = true, dataType = "String")
public ResponseEntity<List<Area>> listByPid(Long pid){
List<Area> list = areaService.listByPid(pid);
return ResponseEntity.ok(list);
}
}
```
`@Api(tags="省市区接口")`定义标签分组接口，在这个类下定义的所有接口将位于这个标签之下
`@ApiOperation()`定义具体的接口标题信息，notes可以为这个标签添加注释
`@ApiImplicitParam()`对应的参数列表信息，用户告诉前端开发人员，这个接口需要传递什么参数及参数的说明
如有多个参数需要说明，可使用`@ApiImplicitParams()`下面可包含多个`@ApiImplicitParam()`
## 实体类
```java
@Data
@TableName("tz_area")
public class Area implements Serializable {
private static final long serialVersionUID = -6013320537436191451L;
@TableId
@ApiModelProperty(value = "地区id",required=true)
private Long areaId;
@ApiModelProperty(value = "地区名称",required=true)
private String areaName;
@ApiModelProperty(value = "地区上级id",required=true)
private Long parentId;
@ApiModelProperty(value = "地区层级",required=true)
private Integer level;
@TableField(exist=false)
private List<Area> areas;
}
```
`@ApiModelProperty()`利用这个注解可以告诉前端开发人员该字段代表的含义
## 常用注解
| 注解 | 作用 |
| ------------------ | ------------------------------------ |
| @Api | 修饰整个类，描述Controller的作用 |
| @ApiOperation | 描述一个类的一个方法，或者说一个接口 |
| @ApiParam | 单个参数描述 |
| @ApiModel | 用对象来接收参数 |
| @ApiProperty | 用对象接收参数时，描述对象的一个字段 |
| @ApiResponse | HTTP响应其中1个描述 |
| @ApiResponses | HTTP响应整体描述 |
| @ApiIgnore | 使用该注解忽略这个API |
| @ApiError | 发生错误返回的信息 |
| @ApiImplicitParam | 一个请求参数 |
| @ApiImplicitParams | 多个请求参数 |
## 分页参数的文档以及关于swagger文档的骚操作
我们仔细留意swagger文档，可以发现 swagger文档返回接口数据的url为：`/v2/api-docs` 。这个url被 `springfox.documentation.swagger2.web.Swagger2Controlle#getDocumentation()` 关联。通过`jsonSerializer.toJson(swagger)` 生成特定的json文档。
当我们使用`PageParam<T>` 这个分页参数生成文档的时候，总是会返回泛型里面的对象信息，我们根据无论使用`@ApiParam(hidden = true)` 又或者是 `@JsonIgnore` 都无效，所以我们可以修改自己的`jsonSerializer`生成的响应的json
自定义Swagger 的序列化，去除分页参数中的records值
```java
public class SpringfoxJsonSerializer extends JsonSerializer {
public SpringfoxJsonSerializer(List<JacksonModuleRegistrar> modules) {
super(modules);
}
@Override
public Json toJson(Object toSerialize) {
if (!(toSerialize instanceof Swagger)) {
return super.toJson(toSerialize);
}
Swagger swagger = (Swagger)toSerialize;
swagger.getPaths().forEach((key, path) ->{
Operation get = path.getGet();
if (get != null) {
List<Parameter> parameters = get.getParameters();
if (parameters != null) {
parameters.removeIf(parameter -> parameter.getName().startsWith("records[0]."));
}
}
});
return super.toJson(swagger);
}
}
```
新序列化的bean
```java
@Configuration
public class SpringFoxJsonSerializerConfig {
@Bean
@Primary
public JsonSerializer yamiSpringfoxJsonSerializer(List<JacksonModuleRegistrar> moduleRegistrars) {
return new SpringfoxJsonSerializer(moduleRegistrars);
}
}
```

14
doc/接口设计/1. 购物车的设计.md
Unescape View File

@ -15,7 +15,7 @@
```java ```java
@PostMapping("/info") @PostMapping("/info")
@ApiOperation(value = "获取用户购物车信息", notes = "获取用户购物车信息，参数为用户选中的活动项数组,以购物车id为key") @Operation(summary = "获取用户购物车信息" , description = "获取用户购物车信息，参数为用户选中的活动项数组,以购物车id为key")
public ResponseEntity<List<ShopCartDto>> info(@RequestBody Map<Long, ShopCartParam> basketIdShopCartParamMap) { public ResponseEntity<List<ShopCartDto>> info(@RequestBody Map<Long, ShopCartParam> basketIdShopCartParamMap) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -47,13 +47,13 @@
@Data @Data
public class ShopCartDto implements Serializable { public class ShopCartDto implements Serializable {
@ApiModelProperty(value = "店铺ID", required = true) @Schema(description = "店铺ID" , required = true)
private Long shopId; private Long shopId;
@ApiModelProperty(value = "店铺名称", required = true) @Schema(description = "店铺名称" , required = true)
private String shopName; private String shopName;
@ApiModelProperty(value = "购物车满减活动携带的商品", required = true) @Schema(description = "购物车满减活动携带的商品" , required = true)
private List<ShopCartItemDiscountDto> shopCartItemDiscounts; private List<ShopCartItemDiscountDto> shopCartItemDiscounts;
} }
@ -64,10 +64,10 @@ public class ShopCartDto implements Serializable {
```java ```java
public class ShopCartItemDiscountDto implements Serializable { public class ShopCartItemDiscountDto implements Serializable {
@ApiModelProperty(value = "已选满减项", required = true) @Schema(description = "已选满减项" , required = true)
private ChooseDiscountItemDto chooseDiscountItemDto; private ChooseDiscountItemDto chooseDiscountItemDto;
@ApiModelProperty(value = "商品列表") @Schema(description = "商品列表" )
private List<ShopCartItemDto> shopCartItems; private List<ShopCartItemDto> shopCartItems;
} }
``` ```
@ -75,7 +75,7 @@ public class ShopCartItemDiscountDto implements Serializable {
我们再留意`ShopCartItemDto` 这个`bean` ，发现还有这个东西： 我们再留意`ShopCartItemDto` 这个`bean` ，发现还有这个东西：
```java ```java
@ApiModelProperty("参与满减活动列表") @Schema(description = "参与满减活动列表" )
private List<DiscountDto> discounts = new ArrayList<>(); private List<DiscountDto> discounts = new ArrayList<>();
``` ```

30
doc/接口设计/2. 订单设计-确认订单.md
Unescape View File

@ -17,10 +17,10 @@
```java ```java
public class OrderParam { public class OrderParam {
@ApiModelProperty(value = "购物车id 数组") @Schema(description = "购物车id 数组" )
private List<Long> basketIds; private List<Long> basketIds;
@ApiModelProperty(value = "立即购买时提交的商品项") @Schema(description = "立即购买时提交的商品项" )
private OrderItemParam orderItem; private OrderItemParam orderItem;
} }
``` ```
@ -38,7 +38,7 @@ public class OrderParam {
```java ```java
@PostMapping("/confirm") @PostMapping("/confirm")
@ApiOperation(value = "结算，生成订单信息", notes = "传入下单所需要的参数进行下单") @Operation(summary = "结算，生成订单信息" , description = "传入下单所需要的参数进行下单")
public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) { public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) {
// 根据店铺组装购车中的商品信息，返回每个店铺中的购物车商品信息 // 根据店铺组装购车中的商品信息，返回每个店铺中的购物车商品信息
List<ShopCartDto> shopCarts = basketService.getShopCarts(shopCartItems); List<ShopCartDto> shopCarts = basketService.getShopCarts(shopCartItems);
@ -61,14 +61,14 @@ public class OrderParam {
```java ```java
public class OrderParam { public class OrderParam {
@ApiModelProperty(value = "地址ID，0为默认地址",required=true) @Schema(description = "地址ID，0为默认地址" ,required=true)
@NotNull(message = "地址不能为空") @NotNull(message = "地址不能为空")
private Long addrId; private Long addrId;
@ApiModelProperty(value = "用户是否改变了优惠券的选择，如果用户改变了优惠券的选择，则完全根据传入参数进行优惠券的选择") @Schema(description = "用户是否改变了优惠券的选择，如果用户改变了优惠券的选择，则完全根据传入参数进行优惠券的选择" )
private Integer userChangeCoupon; private Integer userChangeCoupon;
@ApiModelProperty(value = "优惠券id数组") @Schema(description = "优惠券id数组" )
private List<Long> couponIds; private List<Long> couponIds;
} }
``` ```
@ -81,7 +81,7 @@ public class OrderParam {
```java ```java
@PostMapping("/confirm") @PostMapping("/confirm")
@ApiOperation(value = "结算，生成订单信息", notes = "传入下单所需要的参数进行下单") @Operation(summary = "结算，生成订单信息" , description = "传入下单所需要的参数进行下单")
public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) { public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) {
for (ShopCartDto shopCart : shopCarts) { for (ShopCartDto shopCart : shopCarts) {
applicationContext.publishEvent(new ConfirmOrderEvent(shopCartOrder,orderParam,shopAllShopCartItems)); applicationContext.publishEvent(new ConfirmOrderEvent(shopCartOrder,orderParam,shopAllShopCartItems));
@ -167,25 +167,25 @@ public class ConfirmOrderListener {
@Data @Data
public class ShopCartOrderMergerDto implements Serializable{ public class ShopCartOrderMergerDto implements Serializable{
@ApiModelProperty(value = "实际总值", required = true) @Schema(description = "实际总值" , required = true)
private Double actualTotal; private Double actualTotal;
@ApiModelProperty(value = "商品总值", required = true) @Schema(description = "商品总值" , required = true)
private Double total; private Double total;
@ApiModelProperty(value = "商品总数", required = true) @Schema(description = "商品总数" , required = true)
private Integer totalCount; private Integer totalCount;
@ApiModelProperty(value = "订单优惠金额(所有店铺优惠金额相加)", required = true) @Schema(description = "订单优惠金额(所有店铺优惠金额相加)" , required = true)
private Double orderReduce; private Double orderReduce;
@ApiModelProperty(value = "地址Dto", required = true) @Schema(description = "地址Dto" , required = true)
private UserAddrDto userAddr; private UserAddrDto userAddr;
@ApiModelProperty(value = "每个店铺的购物车信息", required = true) @Schema(description = "每个店铺的购物车信息" , required = true)
private List<ShopCartOrderDto> shopCartOrders; private List<ShopCartOrderDto> shopCartOrders;
@ApiModelProperty(value = "整个订单可以使用的优惠券列表", required = true) @Schema(description = "整个订单可以使用的优惠券列表" , required = true)
private List<CouponOrderDto> coupons; private List<CouponOrderDto> coupons;
} }
@ -194,7 +194,7 @@ public class ShopCartOrderMergerDto implements Serializable{
这里又有一段我们熟悉的代码： 这里又有一段我们熟悉的代码：
```java ```java
@ApiModelProperty(value = "每个店铺的购物车信息", required = true) @Schema(description = "每个店铺的购物车信息" , required = true)
private List<ShopCartOrderDto> shopCartOrders; private List<ShopCartOrderDto> shopCartOrders;
``` ```
没错这里返回的数据格式，和购物车的格式是一样的，因为第一步当中已经说明，订单来自于购物车的计算，所以会在基础上条件新的数据，基本上就是返回给前端的数据了。 没错这里返回的数据格式，和购物车的格式是一样的，因为第一步当中已经说明，订单来自于购物车的计算，所以会在基础上条件新的数据，基本上就是返回给前端的数据了。

4
doc/接口设计/3. 订单设计-提交订单.md
Unescape View File

@ -9,7 +9,7 @@
我们返回确认订单的接口，看到这样一行代码： 我们返回确认订单的接口，看到这样一行代码：
```java ```java
@ApiOperation(value = "结算，生成订单信息", notes = "传入下单所需要的参数进行下单") @Operation(summary = "结算，生成订单信息" , description = "传入下单所需要的参数进行下单")
public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) { public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) {
orderService.putConfirmOrderCache(userId,shopCartOrderMergerDto); orderService.putConfirmOrderCache(userId,shopCartOrderMergerDto);
} }
@ -21,7 +21,7 @@
```java ```java
@PostMapping("/submit") @PostMapping("/submit")
@ApiOperation(value = "提交订单，返回支付流水号", notes = "根据传入的参数判断是否为购物车提交订单，同时对购物车进行删除，用户开始进行支付") @Operation(summary = "提交订单，返回支付流水号" , description = "根据传入的参数判断是否为购物车提交订单，同时对购物车进行删除，用户开始进行支付")
public ResponseEntity<OrderNumbersDto> submitOrders(@Valid @RequestBody SubmitOrderParam submitOrderParam) { public ResponseEntity<OrderNumbersDto> submitOrders(@Valid @RequestBody SubmitOrderParam submitOrderParam) {
ShopCartOrderMergerDto mergerOrder = orderService.getConfirmOrderCache(userId); ShopCartOrderMergerDto mergerOrder = orderService.getConfirmOrderCache(userId);
if (mergerOrder == null) { if (mergerOrder == null) {

16
pom.xml
Unescape View File

@ -38,7 +38,7 @@
<redisson.version>3.12.5</redisson.version> <redisson.version>3.12.5</redisson.version>
<transmittable-thread-local.version>2.12.1</transmittable-thread-local.version> <transmittable-thread-local.version>2.12.1</transmittable-thread-local.version>
<log4j.version>2.17.2</log4j.version> <log4j.version>2.17.2</log4j.version>
<knife4j.version>3.0.3</knife4j.version> <knife4j.version>4.0.0</knife4j.version>
<xxl-job.version>2.3.1</xxl-job.version> <xxl-job.version>2.3.1</xxl-job.version>
<spring-cloud-commons.version>3.1.1</spring-cloud-commons.version> <spring-cloud-commons.version>3.1.1</spring-cloud-commons.version>
</properties> </properties>
@ -52,6 +52,13 @@
<type>pom</type> <type>pom</type>
<scope>import</scope> <scope>import</scope>
</dependency> </dependency>
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-dependencies</artifactId>
<version>${knife4j.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency> <dependency>
<groupId>com.github.binarywang</groupId> <groupId>com.github.binarywang</groupId>
<artifactId>weixin-java-pay</artifactId> <artifactId>weixin-java-pay</artifactId>
@ -168,8 +175,11 @@
</dependency> </dependency>
<dependency> <dependency>
<groupId>com.github.xiaoymin</groupId> <groupId>com.github.xiaoymin</groupId>
<artifactId>knife4j-spring-boot-starter</artifactId> <artifactId>knife4j-openapi3-spring-boot-starter</artifactId>
<version>${knife4j.version}</version> </dependency>
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-ui</artifactId>
</dependency> </dependency>
</dependencies> </dependencies>

53
yami-shop-admin/src/main/java/com/yami/shop/admin/config/SwaggerConfiguration.java
Unescape View File

@ -10,47 +10,36 @@
package com.yami.shop.admin.config; package com.yami.shop.admin.config;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springdoc.core.GroupedOpenApi;
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
/** /**
* Swagger文档，只有在测试环境才会使用 * Swagger文档，只有在测试环境才会使用
* @author LGH * @author LGH
*/ */
//@Profile("dev") //@Profile("dev")
@Configuration @Configuration
@EnableSwagger2
public class SwaggerConfiguration { public class SwaggerConfiguration {
@Bean @Bean
public Docket createRestApi() { public GroupedOpenApi baseRestApi() {
return new Docket(DocumentationType.SWAGGER_2) return GroupedOpenApi.builder()
.apiInfo(apiInfo()) .group("基础版")
.groupName("基础版") .packagesToScan("com.yami.shop.api")
.select() .build();
.apis(RequestHandlerSelectors.basePackage("com.yami.shop.admin")) }
.paths(PathSelectors.any())
.build();
}
@Bean @Bean
public ApiInfo apiInfo() { public OpenAPI springShopOpenAPI() {
return new ApiInfoBuilder() return new OpenAPI()
.title("mall4j管理系统接口文档") .info(new Info().title("Mall4j接口文档")
.description("mall4j商城接口文档Swagger版") .description("Mall4j接口文档，openapi3.0 接口，用于前端对接")
.termsOfServiceUrl("https://www.mall4j.com/") .version("v0.0.1")
.contact(new Contact("广州市蓝海创新科技有限公司","https://www.mall4j.com/", "")) .license(new License().name("使用请遵守AGPL3.0授权协议").url("https://www.mall4j.com")));
.version("1.0") }
.build(); }
}
}

8
yami-shop-admin/src/main/java/com/yami/shop/admin/controller/AdminLoginController.java
Unescape View File

@ -27,8 +27,8 @@ import com.yami.shop.sys.model.SysMenu;
import com.yami.shop.sys.model.SysUser; import com.yami.shop.sys.model.SysUser;
import com.yami.shop.sys.service.SysMenuService; import com.yami.shop.sys.service.SysMenuService;
import com.yami.shop.sys.service.SysUserService; import com.yami.shop.sys.service.SysUserService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.PostMapping;
@ -47,7 +47,7 @@ import java.util.stream.Collectors;
* @date 2020/6/30 * @date 2020/6/30
*/ */
@RestController @RestController
@Api(tags = "登录") @Tag(name = "登录")
public class AdminLoginController { public class AdminLoginController {
@Autowired @Autowired
@ -69,7 +69,7 @@ public class AdminLoginController {
private PasswordManager passwordManager; private PasswordManager passwordManager;
@PostMapping("/adminLogin") @PostMapping("/adminLogin")
@ApiOperation(value = "账号密码 + 验证码登录(用于后台登录)", notes = "通过账号/手机号/用户名密码登录") @Operation(summary = "账号密码 + 验证码登录(用于后台登录)" , description = "通过账号/手机号/用户名密码登录")
public ResponseEntity<?> login( public ResponseEntity<?> login(
@Valid @RequestBody CaptchaAuthenticationDTO captchaAuthenticationDTO) { @Valid @RequestBody CaptchaAuthenticationDTO captchaAuthenticationDTO) {
// 登陆后台登录需要再校验一遍验证码 // 登陆后台登录需要再校验一遍验证码

3
yami-shop-admin/src/main/resources/application.yml
Unescape View File

@ -11,9 +11,6 @@ spring:
jackson: jackson:
date-format: yyyy-MM-dd HH:mm:ss date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8 time-zone: GMT+8
mvc:
pathmatch:
matching-strategy: ANT_PATH_MATCHER
# mybaits-plus配置 # mybaits-plus配置
mybatis-plus: mybatis-plus:
# MyBatis Mapper所对应的XML文件位置 # MyBatis Mapper所对应的XML文件位置

53
yami-shop-api/src/main/java/com/yami/shop/api/config/SwaggerConfiguration.java
Unescape View File

@ -10,47 +10,36 @@
package com.yami.shop.api.config; package com.yami.shop.api.config;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springdoc.core.GroupedOpenApi;
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
/** /**
* Swagger文档，只有在测试环境才会使用 * Swagger文档，只有在测试环境才会使用
* @author LGH * @author LGH
*/ */
//@Profile("dev") //@Profile("dev")
@Configuration @Configuration
@EnableSwagger2
public class SwaggerConfiguration { public class SwaggerConfiguration {
@Bean @Bean
public Docket baseRestApi() { public GroupedOpenApi createRestApi() {
return new Docket(DocumentationType.SWAGGER_2) return GroupedOpenApi.builder()
.apiInfo(apiInfo()) .group("接口文档")
.groupName("基础版") .packagesToScan("com.yami")
.select() .build();
.apis(RequestHandlerSelectors.basePackage("com.yami.shop.api")) }
.paths(PathSelectors.any())
.build();
}
@Bean @Bean
public ApiInfo apiInfo() { public OpenAPI springShopOpenApi() {
return new ApiInfoBuilder() return new OpenAPI()
.title("mall4j商城接口文档") .info(new Info().title("Mall4j接口文档")
.description("mall4j商城接口文档Swagger版") .description("Mall4j接口文档，openapi3.0 接口，用于前端对接")
.termsOfServiceUrl("http://www.mall4j.com/") .version("v0.0.1")
.contact(new Contact("广州市蓝海创新科技有限公司","https://www.mall4j.com/", "")) .license(new License().name("使用请遵守AGPL3.0授权协议").url("https://www.mall4j.com")));
.version("1.0") }
.build(); }
}
}

24
yami-shop-api/src/main/java/com/yami/shop/api/controller/AddrController.java
Unescape View File

@ -17,9 +17,9 @@ import com.yami.shop.bean.model.UserAddr;
import com.yami.shop.common.exception.YamiShopBindException; import com.yami.shop.common.exception.YamiShopBindException;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.UserAddrService; import com.yami.shop.service.UserAddrService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
@ -33,7 +33,7 @@ import java.util.List;
@RestController @RestController
@RequestMapping("/p/address") @RequestMapping("/p/address")
@Api(tags = "地址接口") @Tag(name = "地址接口")
@AllArgsConstructor @AllArgsConstructor
public class AddrController { public class AddrController {
@ -46,7 +46,7 @@ public class AddrController {
* 选择订单配送地址 * 选择订单配送地址
*/ */
@GetMapping("/list") @GetMapping("/list")
@ApiOperation(value = "用户地址列表", notes = "获取用户的所有地址信息") @Operation(summary = "用户地址列表" , description = "获取用户的所有地址信息")
public ResponseEntity<List<UserAddrDto>> dvyList() { public ResponseEntity<List<UserAddrDto>> dvyList() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
List<UserAddr> userAddrs = userAddrService.list(new LambdaQueryWrapper<UserAddr>().eq(UserAddr::getUserId, userId).orderByDesc(UserAddr::getCommonAddr).orderByDesc(UserAddr::getUpdateTime)); List<UserAddr> userAddrs = userAddrService.list(new LambdaQueryWrapper<UserAddr>().eq(UserAddr::getUserId, userId).orderByDesc(UserAddr::getCommonAddr).orderByDesc(UserAddr::getUpdateTime));
@ -54,7 +54,7 @@ public class AddrController {
} }
@PostMapping("/addAddr") @PostMapping("/addAddr")
@ApiOperation(value = "新增用户地址", notes = "新增用户地址") @Operation(summary = "新增用户地址" , description = "新增用户地址")
public ResponseEntity<String> addAddr(@Valid @RequestBody AddrParam addrParam) { public ResponseEntity<String> addAddr(@Valid @RequestBody AddrParam addrParam) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -85,7 +85,7 @@ public class AddrController {
* 修改订单配送地址 * 修改订单配送地址
*/ */
@PutMapping("/updateAddr") @PutMapping("/updateAddr")
@ApiOperation(value = "修改订单用户地址", notes = "修改用户地址") @Operation(summary = "修改订单用户地址" , description = "修改用户地址")
public ResponseEntity<String> updateAddr(@Valid @RequestBody AddrParam addrParam) { public ResponseEntity<String> updateAddr(@Valid @RequestBody AddrParam addrParam) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -109,8 +109,8 @@ public class AddrController {
* 删除订单配送地址 * 删除订单配送地址
*/ */
@DeleteMapping("/deleteAddr/{addrId}") @DeleteMapping("/deleteAddr/{addrId}")
@ApiOperation(value = "删除订单用户地址", notes = "根据地址id，删除用户地址") @Operation(summary = "删除订单用户地址" , description = "根据地址id，删除用户地址")
@ApiImplicitParam(name = "addrId", value = "地址ID", required = true, dataType = "Long") @Parameter(name = "addrId", description = "地址ID" , required = true)
public ResponseEntity<String> deleteDvy(@PathVariable("addrId") Long addrId) { public ResponseEntity<String> deleteDvy(@PathVariable("addrId") Long addrId) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
UserAddr userAddr = userAddrService.getUserAddrByUserId(addrId, userId); UserAddr userAddr = userAddrService.getUserAddrByUserId(addrId, userId);
@ -129,7 +129,7 @@ public class AddrController {
* 设置默认地址 * 设置默认地址
*/ */
@PutMapping("/defaultAddr/{addrId}") @PutMapping("/defaultAddr/{addrId}")
@ApiOperation(value = "设置默认地址", notes = "根据地址id，设置默认地址") @Operation(summary = "设置默认地址" , description = "根据地址id，设置默认地址")
public ResponseEntity<String> defaultAddr(@PathVariable("addrId") Long addrId) { public ResponseEntity<String> defaultAddr(@PathVariable("addrId") Long addrId) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -144,8 +144,8 @@ public class AddrController {
* 获取地址信息订单配送地址 * 获取地址信息订单配送地址
*/ */
@GetMapping("/addrInfo/{addrId}") @GetMapping("/addrInfo/{addrId}")
@ApiOperation(value = "获取地址信息", notes = "根据地址id，获取地址信息") @Operation(summary = "获取地址信息" , description = "根据地址id，获取地址信息")
@ApiImplicitParam(name = "addrId", value = "地址ID", required = true, dataType = "Long") @Parameter(name = "addrId", description = "地址ID" , required = true)
public ResponseEntity<UserAddrDto> addrInfo(@PathVariable("addrId") Long addrId) { public ResponseEntity<UserAddrDto> addrInfo(@PathVariable("addrId") Long addrId) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
UserAddr userAddr = userAddrService.getUserAddrByUserId(addrId, userId); UserAddr userAddr = userAddrService.getUserAddrByUserId(addrId, userId);

12
yami-shop-api/src/main/java/com/yami/shop/api/controller/AreaController.java
Unescape View File

@ -21,9 +21,9 @@ import org.springframework.web.bind.annotation.RestController;
import com.yami.shop.bean.model.Area; import com.yami.shop.bean.model.Area;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
/** /**
* *
@ -31,7 +31,7 @@ import io.swagger.annotations.ApiOperation;
*/ */
@RestController @RestController
@RequestMapping("/p/area") @RequestMapping("/p/area")
@Api(tags="省市区接口") @Tag(name = "省市区接口")
public class AreaController { public class AreaController {
@Autowired @Autowired
@ -41,8 +41,8 @@ public class AreaController {
* 分页获取 * 分页获取
*/ */
@GetMapping("/listByPid") @GetMapping("/listByPid")
@ApiOperation(value="获取省市区信息", notes="根据省市区的pid获取地址信息") @Operation(summary = "获取省市区信息" , description = "根据省市区的pid获取地址信息")
@ApiImplicitParam(name = "pid", value = "省市区的pid(pid为0获取所有省份)", required = true, dataType = "String") @Parameter(name = "pid", description = "省市区的pid(pid为0获取所有省份)" , required = true)
public ResponseEntity<List<Area>> listByPid(Long pid){ public ResponseEntity<List<Area>> listByPid(Long pid){
List<Area> list = areaService.listByPid(pid); List<Area> list = areaService.listByPid(pid);
return ResponseEntity.ok(list); return ResponseEntity.ok(list);

12
yami-shop-api/src/main/java/com/yami/shop/api/controller/CategoryController.java
Unescape View File

@ -23,14 +23,14 @@ import com.yami.shop.bean.app.dto.CategoryDto;
import com.yami.shop.bean.model.Category; import com.yami.shop.bean.model.Category;
import com.yami.shop.service.CategoryService; import com.yami.shop.service.CategoryService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
@RestController @RestController
@RequestMapping("/category") @RequestMapping("/category")
@Api(tags = "分类接口") @Tag(name = "分类接口")
public class CategoryController { public class CategoryController {
@Autowired @Autowired
@ -43,8 +43,8 @@ public class CategoryController {
* 分类信息列表接口 * 分类信息列表接口
*/ */
@GetMapping("/categoryInfo") @GetMapping("/categoryInfo")
@ApiOperation(value = "分类信息列表", notes = "获取所有的产品分类信息，顶级分类的parentId为0,默认为顶级分类") @Operation(summary = "分类信息列表" , description = "获取所有的产品分类信息，顶级分类的parentId为0,默认为顶级分类")
@ApiImplicitParam(name = "parentId", value = "分类ID", required = false, dataType = "Long") @Parameter(name = "parentId", description = "分类ID", required = false)
public ResponseEntity<List<CategoryDto>> categoryInfo(@RequestParam(value = "parentId", defaultValue = "0") Long parentId) { public ResponseEntity<List<CategoryDto>> categoryInfo(@RequestParam(value = "parentId", defaultValue = "0") Long parentId) {
List<Category> categories = categoryService.listByParentId(parentId); List<Category> categories = categoryService.listByParentId(parentId);
List<CategoryDto> categoryDtos = mapperFacade.mapAsList(categories, CategoryDto.class); List<CategoryDto> categoryDtos = mapperFacade.mapAsList(categories, CategoryDto.class);

12
yami-shop-api/src/main/java/com/yami/shop/api/controller/DeliveryController.java
Unescape View File

@ -24,13 +24,13 @@ import com.yami.shop.common.util.Json;
import com.yami.shop.service.DeliveryService; import com.yami.shop.service.DeliveryService;
import cn.hutool.http.HttpUtil; import cn.hutool.http.HttpUtil;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
@RestController @RestController
@RequestMapping("/delivery") @RequestMapping("/delivery")
@Api(tags="查看物流接口") @Tag(name = "查看物流接口")
public class DeliveryController { public class DeliveryController {
@Autowired @Autowired
@ -42,8 +42,8 @@ public class DeliveryController {
* 查看物流接口 * 查看物流接口
*/ */
@GetMapping("/check") @GetMapping("/check")
@ApiOperation(value="查看物流", notes="根据订单号查看物流") @Operation(summary = "查看物流" , description = "根据订单号查看物流")
@ApiImplicitParam(name = "orderNumber", value = "订单号", required = true, dataType = "String") @Parameter(name = "orderNumber", description = "订单号" , required = true)
public ResponseEntity<DeliveryDto> checkDelivery(String orderNumber) { public ResponseEntity<DeliveryDto> checkDelivery(String orderNumber) {
Order order = orderService.getOrderByOrderNumber(orderNumber); Order order = orderService.getOrderByOrderNumber(orderNumber);

10
yami-shop-api/src/main/java/com/yami/shop/api/controller/IndexImgController.java
Unescape View File

@ -13,9 +13,9 @@ package com.yami.shop.api.controller;
import com.yami.shop.bean.app.dto.IndexImgDto; import com.yami.shop.bean.app.dto.IndexImgDto;
import com.yami.shop.bean.model.IndexImg; import com.yami.shop.bean.model.IndexImg;
import com.yami.shop.service.IndexImgService; import com.yami.shop.service.IndexImgService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -26,7 +26,7 @@ import org.springframework.web.bind.annotation.RestController;
import java.util.List; import java.util.List;
@RestController @RestController
@Api(tags = "首页轮播图接口") @Tag(name = "首页轮播图接口")
public class IndexImgController { public class IndexImgController {
@Autowired @Autowired
private MapperFacade mapperFacade; private MapperFacade mapperFacade;
@ -38,7 +38,7 @@ public class IndexImgController {
* 首页轮播图接口 * 首页轮播图接口
*/ */
@GetMapping("/indexImgs") @GetMapping("/indexImgs")
@ApiOperation(value = "首页轮播图", notes = "获取首页轮播图列表信息") @Operation(summary = "首页轮播图" , description = "获取首页轮播图列表信息")
public ResponseEntity<List<IndexImgDto>> indexImgs() { public ResponseEntity<List<IndexImgDto>> indexImgs() {
List<IndexImg> indexImgList = indexImgService.listIndexImgs(); List<IndexImg> indexImgList = indexImgService.listIndexImgs();
List<IndexImgDto> indexImgDtos = mapperFacade.mapAsList(indexImgList, IndexImgDto.class); List<IndexImgDto> indexImgDtos = mapperFacade.mapAsList(indexImgList, IndexImgDto.class);

32
yami-shop-api/src/main/java/com/yami/shop/api/controller/MyOrderController.java
Unescape View File

@ -22,10 +22,10 @@ import com.yami.shop.common.util.Arith;
import com.yami.shop.common.util.PageParam; import com.yami.shop.common.util.PageParam;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.*; import com.yami.shop.service.*;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiImplicitParams; import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -37,7 +37,7 @@ import java.util.Objects;
@RestController @RestController
@RequestMapping("/p/myOrder") @RequestMapping("/p/myOrder")
@Api(tags = "我的订单接口") @Tag(name = "我的订单接口")
@AllArgsConstructor @AllArgsConstructor
public class MyOrderController { public class MyOrderController {
@ -62,8 +62,8 @@ public class MyOrderController {
* 订单详情信息接口 * 订单详情信息接口
*/ */
@GetMapping("/orderDetail") @GetMapping("/orderDetail")
@ApiOperation(value = "订单详情信息", notes = "根据订单号获取订单详情信息") @Operation(summary = "订单详情信息" , description = "根据订单号获取订单详情信息")
@ApiImplicitParam(name = "orderNumber", value = "订单号", required = true, dataType = "String") @Parameter(name = "orderNumber", description = "订单号" , required = true)
public ResponseEntity<OrderShopDto> orderDetail(@RequestParam(value = "orderNumber", required = true) String orderNumber) { public ResponseEntity<OrderShopDto> orderDetail(@RequestParam(value = "orderNumber", required = true) String orderNumber) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -112,9 +112,9 @@ public class MyOrderController {
* 订单列表接口 * 订单列表接口
*/ */
@GetMapping("/myOrder") @GetMapping("/myOrder")
@ApiOperation(value = "订单列表信息", notes = "根据订单状态获取订单列表信息，状态为0时获取所有订单") @Operation(summary = "订单列表信息" , description = "根据订单状态获取订单列表信息，状态为0时获取所有订单")
@ApiImplicitParams({ @Parameters({
@ApiImplicitParam(name = "status", value = "订单状态 1:待付款 2:待发货 3:待收货 4:待评价 5:成功 6:失败", required = false, dataType = "Integer") @Parameter(name = "status", description = "订单状态 1:待付款 2:待发货 3:待收货 4:待评价 5:成功 6:失败")
}) })
public ResponseEntity<IPage<MyOrderDto>> myOrder(@RequestParam(value = "status") Integer status,PageParam<MyOrderDto> page) { public ResponseEntity<IPage<MyOrderDto>> myOrder(@RequestParam(value = "status") Integer status,PageParam<MyOrderDto> page) {
@ -127,8 +127,8 @@ public class MyOrderController {
* 取消订单 * 取消订单
*/ */
@PutMapping("/cancel/{orderNumber}") @PutMapping("/cancel/{orderNumber}")
@ApiOperation(value = "根据订单号取消订单", notes = "根据订单号取消订单") @Operation(summary = "根据订单号取消订单" , description = "根据订单号取消订单")
@ApiImplicitParam(name = "orderNumber", value = "订单号", required = true, dataType = "String") @Parameter(name = "orderNumber", description = "订单号" , required = true)
public ResponseEntity<String> cancel(@PathVariable("orderNumber") String orderNumber) { public ResponseEntity<String> cancel(@PathVariable("orderNumber") String orderNumber) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
Order order = orderService.getOrderByOrderNumber(orderNumber); Order order = orderService.getOrderByOrderNumber(orderNumber);
@ -156,7 +156,7 @@ public class MyOrderController {
* 确认收货 * 确认收货
*/ */
@PutMapping("/receipt/{orderNumber}") @PutMapping("/receipt/{orderNumber}")
@ApiOperation(value = "根据订单号确认收货", notes = "根据订单号确认收货") @Operation(summary = "根据订单号确认收货" , description = "根据订单号确认收货")
public ResponseEntity<String> receipt(@PathVariable("orderNumber") String orderNumber) { public ResponseEntity<String> receipt(@PathVariable("orderNumber") String orderNumber) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
Order order = orderService.getOrderByOrderNumber(orderNumber); Order order = orderService.getOrderByOrderNumber(orderNumber);
@ -182,8 +182,8 @@ public class MyOrderController {
* 删除订单 * 删除订单
*/ */
@DeleteMapping("/{orderNumber}") @DeleteMapping("/{orderNumber}")
@ApiOperation(value = "根据订单号删除订单", notes = "根据订单号删除订单") @Operation(summary = "根据订单号删除订单" , description = "根据订单号删除订单")
@ApiImplicitParam(name = "orderNumber", value = "订单号", required = true, dataType = "String") @Parameter(name = "orderNumber", description = "订单号" , required = true)
public ResponseEntity<String> delete(@PathVariable("orderNumber") String orderNumber) { public ResponseEntity<String> delete(@PathVariable("orderNumber") String orderNumber) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -208,7 +208,7 @@ public class MyOrderController {
* 获取我的订单订单数量 * 获取我的订单订单数量
*/ */
@GetMapping("/orderCount") @GetMapping("/orderCount")
@ApiOperation(value = "获取我的订单订单数量", notes = "获取我的订单订单数量") @Operation(summary = "获取我的订单订单数量" , description = "获取我的订单订单数量")
public ResponseEntity<OrderCountData> getOrderCount() { public ResponseEntity<OrderCountData> getOrderCount() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
OrderCountData orderCountMap = orderService.getOrderCount(userId); OrderCountData orderCountMap = orderService.getOrderCount(userId);

16
yami-shop-api/src/main/java/com/yami/shop/api/controller/NoticeController.java
Unescape View File

@ -16,9 +16,9 @@ import com.yami.shop.bean.app.dto.NoticeDto;
import com.yami.shop.bean.model.Notice; import com.yami.shop.bean.model.Notice;
import com.yami.shop.common.util.PageParam; import com.yami.shop.common.util.PageParam;
import com.yami.shop.service.NoticeService; import com.yami.shop.service.NoticeService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParams; import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -31,7 +31,7 @@ import java.util.List;
@RestController @RestController
@RequestMapping("/shop/notice") @RequestMapping("/shop/notice")
@Api(tags = "公告管理接口") @Tag(name = "公告管理接口")
@AllArgsConstructor @AllArgsConstructor
public class NoticeController { public class NoticeController {
@ -43,7 +43,7 @@ public class NoticeController {
* 置顶公告列表接口 * 置顶公告列表接口
*/ */
@GetMapping("/topNoticeList") @GetMapping("/topNoticeList")
@ApiOperation(value = "置顶公告列表信息", notes = "获取所有置顶公告列表信息") @Operation(summary = "置顶公告列表信息" , description = "获取所有置顶公告列表信息")
@JsonView(NoticeDto.NoContent.class) @JsonView(NoticeDto.NoContent.class)
public ResponseEntity<List<NoticeDto>> getTopNoticeList() { public ResponseEntity<List<NoticeDto>> getTopNoticeList() {
List<Notice> noticeList = noticeService.listNotice(); List<Notice> noticeList = noticeService.listNotice();
@ -55,7 +55,7 @@ public class NoticeController {
* 获取公告详情 * 获取公告详情
*/ */
@GetMapping("/info/{id}") @GetMapping("/info/{id}")
@ApiOperation(value = "公告详情", notes = "获取公告id公告详情") @Operation(summary = "公告详情" , description = "获取公告id公告详情")
@JsonView(NoticeDto.WithContent.class) @JsonView(NoticeDto.WithContent.class)
public ResponseEntity<NoticeDto> getNoticeById(@PathVariable("id") Long id) { public ResponseEntity<NoticeDto> getNoticeById(@PathVariable("id") Long id) {
Notice notice = noticeService.getNoticeById(id); Notice notice = noticeService.getNoticeById(id);
@ -67,8 +67,8 @@ public class NoticeController {
* 公告列表 * 公告列表
*/ */
@GetMapping("/noticeList") @GetMapping("/noticeList")
@ApiOperation(value = "公告列表信息", notes = "获取所有公告列表信息") @Operation(summary = "公告列表信息" , description = "获取所有公告列表信息")
@ApiImplicitParams({ @Parameters({
}) })
public ResponseEntity<IPage<NoticeDto>> pageNotice(PageParam<NoticeDto> page) { public ResponseEntity<IPage<NoticeDto>> pageNotice(PageParam<NoticeDto> page) {

10
yami-shop-api/src/main/java/com/yami/shop/api/controller/OrderController.java
Unescape View File

@ -22,8 +22,8 @@ import com.yami.shop.common.exception.YamiShopBindException;
import com.yami.shop.common.util.Arith; import com.yami.shop.common.util.Arith;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.*; import com.yami.shop.service.*;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.ApplicationContext; import org.springframework.context.ApplicationContext;
@ -40,7 +40,7 @@ import java.util.Objects;
@RestController @RestController
@RequestMapping("/p/order") @RequestMapping("/p/order")
@Api(tags = "订单接口") @Tag(name = "订单接口")
public class OrderController { public class OrderController {
@Autowired @Autowired
@ -63,7 +63,7 @@ public class OrderController {
* 生成订单 * 生成订单
*/ */
@PostMapping("/confirm") @PostMapping("/confirm")
@ApiOperation(value = "结算，生成订单信息", notes = "传入下单所需要的参数进行下单") @Operation(summary = "结算，生成订单信息" , description = "传入下单所需要的参数进行下单")
public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) { public ResponseEntity<ShopCartOrderMergerDto> confirm(@Valid @RequestBody OrderParam orderParam) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -139,7 +139,7 @@ public class OrderController {
* 购物车/立即购买 提交订单,根据店铺拆单 * 购物车/立即购买 提交订单,根据店铺拆单
*/ */
@PostMapping("/submit") @PostMapping("/submit")
@ApiOperation(value = "提交订单，返回支付流水号", notes = "根据传入的参数判断是否为购物车提交订单，同时对购物车进行删除，用户开始进行支付") @Operation(summary = "提交订单，返回支付流水号" , description = "根据传入的参数判断是否为购物车提交订单，同时对购物车进行删除，用户开始进行支付")
public ResponseEntity<OrderNumbersDto> submitOrders(@Valid @RequestBody SubmitOrderParam submitOrderParam) { public ResponseEntity<OrderNumbersDto> submitOrders(@Valid @RequestBody SubmitOrderParam submitOrderParam) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
ShopCartOrderMergerDto mergerOrder = orderService.getConfirmOrderCache(userId); ShopCartOrderMergerDto mergerOrder = orderService.getConfirmOrderCache(userId);

10
yami-shop-api/src/main/java/com/yami/shop/api/controller/PayController.java
Unescape View File

@ -16,8 +16,8 @@ import com.yami.shop.bean.pay.PayInfoDto;
import com.yami.shop.security.api.model.YamiUser; import com.yami.shop.security.api.model.YamiUser;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.PayService; import com.yami.shop.service.PayService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import lombok.SneakyThrows; import lombok.SneakyThrows;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -28,7 +28,7 @@ import org.springframework.web.bind.annotation.RestController;
@RestController @RestController
@RequestMapping("/p/order") @RequestMapping("/p/order")
@Api(tags = "订单接口") @Tag(name = "订单接口")
@AllArgsConstructor @AllArgsConstructor
public class PayController { public class PayController {
@ -38,7 +38,7 @@ public class PayController {
* 支付接口 * 支付接口
*/ */
@PostMapping("/pay") @PostMapping("/pay")
@ApiOperation(value = "根据订单号进行支付", notes = "根据订单号进行支付") @Operation(summary = "根据订单号进行支付" , description = "根据订单号进行支付")
@SneakyThrows @SneakyThrows
public ResponseEntity<WxPayMpOrderResult> pay(@RequestBody PayParam payParam) { public ResponseEntity<WxPayMpOrderResult> pay(@RequestBody PayParam payParam) {
YamiUser user = SecurityUtils.getUser(); YamiUser user = SecurityUtils.getUser();
@ -54,7 +54,7 @@ public class PayController {
* 普通支付接口 * 普通支付接口
*/ */
@PostMapping("/normalPay") @PostMapping("/normalPay")
@ApiOperation(value = "根据订单号进行支付", notes = "根据订单号进行支付") @Operation(summary = "根据订单号进行支付" , description = "根据订单号进行支付")
@SneakyThrows @SneakyThrows
public ResponseEntity<Boolean> normalPay(@RequestBody PayParam payParam) { public ResponseEntity<Boolean> normalPay(@RequestBody PayParam payParam) {

6
yami-shop-api/src/main/java/com/yami/shop/api/controller/PayNoticeController.java
Unescape View File

@ -13,9 +13,9 @@ package com.yami.shop.api.controller;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController; import org.springframework.web.bind.annotation.RestController;
import springfox.documentation.annotations.ApiIgnore; import io.swagger.v3.oas.annotations.Hidden;
@ApiIgnore @Hidden
@RestController @RestController
@RequestMapping("/notice/pay") @RequestMapping("/notice/pay")
@AllArgsConstructor @AllArgsConstructor
@ -42,4 +42,4 @@ public class PayNoticeController {
// //
// return ResponseEntity.ok().build(); // return ResponseEntity.ok().build();
// } // }
} }

26
yami-shop-api/src/main/java/com/yami/shop/api/controller/ProdCommController.java
Unescape View File

@ -19,10 +19,10 @@ import com.yami.shop.bean.model.ProdComm;
import com.yami.shop.common.util.PageParam; import com.yami.shop.common.util.PageParam;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.ProdCommService; import com.yami.shop.service.ProdCommService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiImplicitParams; import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*; import org.springframework.web.bind.annotation.*;
@ -31,7 +31,7 @@ import java.util.Date;
@RestController @RestController
@RequestMapping("/prodComm") @RequestMapping("/prodComm")
@Api(tags = "评论接口") @Tag(name = "评论接口")
@AllArgsConstructor @AllArgsConstructor
public class ProdCommController { public class ProdCommController {
@ -39,29 +39,29 @@ public class ProdCommController {
@GetMapping("/prodCommData") @GetMapping("/prodCommData")
@ApiOperation(value = "返回商品评论数据(好评率 好评数量 中评数 差评数)", notes = "根据商品id获取") @Operation(summary = "返回商品评论数据(好评率 好评数量 中评数 差评数)" , description = "根据商品id获取")
public ResponseEntity<ProdCommDataDto> getProdCommData(Long prodId) { public ResponseEntity<ProdCommDataDto> getProdCommData(Long prodId) {
return ResponseEntity.ok(prodCommService.getProdCommDataByProdId(prodId)); return ResponseEntity.ok(prodCommService.getProdCommDataByProdId(prodId));
} }
@GetMapping("/prodCommPageByUser") @GetMapping("/prodCommPageByUser")
@ApiOperation(value = "根据用户返回评论分页数据", notes = "传入页码") @Operation(summary = "根据用户返回评论分页数据" , description = "传入页码")
public ResponseEntity<IPage<ProdCommDto>> getProdCommPage(PageParam page) { public ResponseEntity<IPage<ProdCommDto>> getProdCommPage(PageParam page) {
return ResponseEntity.ok(prodCommService.getProdCommDtoPageByUserId(page, SecurityUtils.getUser().getUserId())); return ResponseEntity.ok(prodCommService.getProdCommDtoPageByUserId(page, SecurityUtils.getUser().getUserId()));
} }
@GetMapping("/prodCommPageByProd") @GetMapping("/prodCommPageByProd")
@ApiOperation(value = "根据商品返回评论分页数据", notes = "传入商品id和页码") @Operation(summary = "根据商品返回评论分页数据" , description = "传入商品id和页码")
@ApiImplicitParams({ @Parameters({
@ApiImplicitParam(name = "prodId", value = "商品id", required = true, dataType = "Long"), @Parameter(name = "prodId", description = "商品id" , required = true),
@ApiImplicitParam(name = "evaluate", value = "-1或null 全部，0好评 1中评 2差评 3有图", required = true, dataType = "Long"), @Parameter(name = "evaluate", description = "-1或null 全部，0好评 1中评 2差评 3有图" , required = true),
}) })
public ResponseEntity<IPage<ProdCommDto>> getProdCommPageByProdId(PageParam page, Long prodId, Integer evaluate) { public ResponseEntity<IPage<ProdCommDto>> getProdCommPageByProdId(PageParam page, Long prodId, Integer evaluate) {
return ResponseEntity.ok(prodCommService.getProdCommDtoPageByProdId(page, prodId, evaluate)); return ResponseEntity.ok(prodCommService.getProdCommDtoPageByProdId(page, prodId, evaluate));
} }
@PostMapping @PostMapping
@ApiOperation(value = "添加评论") @Operation(summary = "添加评论")
public ResponseEntity<Void> saveProdCommPage(ProdCommParam prodCommParam) { public ResponseEntity<Void> saveProdCommPage(ProdCommParam prodCommParam) {
ProdComm prodComm = new ProdComm(); ProdComm prodComm = new ProdComm();
prodComm.setProdId(prodCommParam.getProdId()); prodComm.setProdId(prodCommParam.getProdId());
@ -79,7 +79,7 @@ public class ProdCommController {
} }
@DeleteMapping @DeleteMapping
@ApiOperation(value = "删除评论", notes = "根据id删除") @Operation(summary = "删除评论" , description = "根据id删除")
public ResponseEntity<Void> deleteProdComm(Long prodCommId) { public ResponseEntity<Void> deleteProdComm(Long prodCommId) {
prodCommService.removeById(prodCommId); prodCommService.removeById(prodCommId);
return ResponseEntity.ok().build(); return ResponseEntity.ok().build();

36
yami-shop-api/src/main/java/com/yami/shop/api/controller/ProdController.java
Unescape View File

@ -21,10 +21,10 @@ import com.yami.shop.common.util.PageParam;
import com.yami.shop.service.ProductService; import com.yami.shop.service.ProductService;
import com.yami.shop.service.SkuService; import com.yami.shop.service.SkuService;
import com.yami.shop.service.TransportService; import com.yami.shop.service.TransportService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiImplicitParams; import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -41,7 +41,7 @@ import java.util.stream.Collectors;
*/ */
@RestController @RestController
@RequestMapping("/prod") @RequestMapping("/prod")
@Api(tags = "商品接口") @Tag(name = "商品接口")
public class ProdController { public class ProdController {
@Autowired @Autowired
@ -58,9 +58,9 @@ public class ProdController {
@GetMapping("/pageProd") @GetMapping("/pageProd")
@ApiOperation(value = "通过分类id商品列表信息", notes = "根据分类ID获取该分类下所有的商品列表信息") @Operation(summary = "通过分类id商品列表信息" , description = "根据分类ID获取该分类下所有的商品列表信息")
@ApiImplicitParams({ @Parameters({
@ApiImplicitParam(name = "categoryId", value = "分类ID", required = true, dataType = "Long"), @Parameter(name = "categoryId", description = "分类ID" , required = true),
}) })
public ResponseEntity<IPage<ProductDto>> prodList( public ResponseEntity<IPage<ProductDto>> prodList(
@RequestParam(value = "categoryId") Long categoryId,PageParam<ProductDto> page) { @RequestParam(value = "categoryId") Long categoryId,PageParam<ProductDto> page) {
@ -69,8 +69,8 @@ public class ProdController {
} }
@GetMapping("/prodInfo") @GetMapping("/prodInfo")
@ApiOperation(value = "商品详情信息", notes = "根据商品ID（prodId）获取商品信息") @Operation(summary = "商品详情信息" , description = "根据商品ID（prodId）获取商品信息")
@ApiImplicitParam(name = "prodId", value = "商品ID", required = true, dataType = "Long") @Parameter(name = "prodId", description = "商品ID" , required = true)
public ResponseEntity<ProductDto> prodInfo(Long prodId) { public ResponseEntity<ProductDto> prodInfo(Long prodId) {
Product product = prodService.getProductByProdId(prodId); Product product = prodService.getProductByProdId(prodId);
@ -97,8 +97,8 @@ public class ProdController {
} }
@GetMapping("/lastedProdPage") @GetMapping("/lastedProdPage")
@ApiOperation(value = "新品推荐", notes = "获取新品推荐商品列表") @Operation(summary = "新品推荐" , description = "获取新品推荐商品列表")
@ApiImplicitParams({ @Parameters({
}) })
public ResponseEntity<IPage<ProductDto>> lastedProdPage(PageParam<ProductDto> page) { public ResponseEntity<IPage<ProductDto>> lastedProdPage(PageParam<ProductDto> page) {
IPage<ProductDto> productPage = prodService.pageByPutawayTime(page); IPage<ProductDto> productPage = prodService.pageByPutawayTime(page);
@ -106,9 +106,9 @@ public class ProdController {
} }
@GetMapping("/prodListByTagId") @GetMapping("/prodListByTagId")
@ApiOperation(value = "通过分组标签获取商品列表", notes = "通过分组标签id（tagId）获取商品列表") @Operation(summary = "通过分组标签获取商品列表" , description = "通过分组标签id（tagId）获取商品列表")
@ApiImplicitParams({ @Parameters({
@ApiImplicitParam(name = "tagId", value = "当前页，默认为1", required = true, dataType = "Long"), @Parameter(name = "tagId", description = "当前页，默认为1" , required = true),
}) })
public ResponseEntity<IPage<ProductDto>> prodListByTagId( public ResponseEntity<IPage<ProductDto>> prodListByTagId(
@RequestParam(value = "tagId") Long tagId,PageParam<ProductDto> page) { @RequestParam(value = "tagId") Long tagId,PageParam<ProductDto> page) {
@ -117,15 +117,15 @@ public class ProdController {
} }
@GetMapping("/moreBuyProdList") @GetMapping("/moreBuyProdList")
@ApiOperation(value = "每日疯抢", notes = "获取销量最多的商品列表") @Operation(summary = "每日疯抢" , description = "获取销量最多的商品列表")
@ApiImplicitParams({}) @Parameters({})
public ResponseEntity<IPage<ProductDto>> moreBuyProdList(PageParam<ProductDto> page) { public ResponseEntity<IPage<ProductDto>> moreBuyProdList(PageParam<ProductDto> page) {
IPage<ProductDto> productPage = prodService.moreBuyProdList(page); IPage<ProductDto> productPage = prodService.moreBuyProdList(page);
return ResponseEntity.ok(productPage); return ResponseEntity.ok(productPage);
} }
@GetMapping("/tagProdList") @GetMapping("/tagProdList")
@ApiOperation(value = "首页所有标签商品接口", notes = "获取首页所有标签商品接口") @Operation(summary = "首页所有标签商品接口" , description = "获取首页所有标签商品接口")
public ResponseEntity<List<TagProductDto>> getTagProdList() { public ResponseEntity<List<TagProductDto>> getTagProdList() {
List<TagProductDto> productDtoList = prodService.tagProdList(); List<TagProductDto> productDtoList = prodService.tagProdList();
return ResponseEntity.ok(productDtoList); return ResponseEntity.ok(productDtoList);

8
yami-shop-api/src/main/java/com/yami/shop/api/controller/ProdTagController.java
Unescape View File

@ -14,8 +14,8 @@ import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.yami.shop.bean.app.dto.ProdTagDto; import com.yami.shop.bean.app.dto.ProdTagDto;
import com.yami.shop.bean.model.ProdTag; import com.yami.shop.bean.model.ProdTag;
import com.yami.shop.service.ProdTagService; import com.yami.shop.service.ProdTagService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -27,7 +27,7 @@ import java.util.List;
@RestController @RestController
@RequestMapping("/prod/tag") @RequestMapping("/prod/tag")
@Api(tags = "商品分组标签接口") @Tag(name = "商品分组标签接口")
@AllArgsConstructor @AllArgsConstructor
public class ProdTagController { public class ProdTagController {
@ -39,7 +39,7 @@ public class ProdTagController {
* 商品分组标签列表接口 * 商品分组标签列表接口
*/ */
@GetMapping("/prodTagList") @GetMapping("/prodTagList")
@ApiOperation(value = "商品分组标签列表", notes = "获取所有的商品分组列表") @Operation(summary = "商品分组标签列表" , description = "获取所有的商品分组列表")
public ResponseEntity<List<ProdTagDto>> getProdTagList() { public ResponseEntity<List<ProdTagDto>> getProdTagList() {
List<ProdTag> prodTagList = prodTagService.listProdTag(); List<ProdTag> prodTagList = prodTagService.listProdTag();
List<ProdTagDto> prodTagDtoList = mapperFacade.mapAsList(prodTagList, ProdTagDto.class); List<ProdTagDto> prodTagDtoList = mapperFacade.mapAsList(prodTagList, ProdTagDto.class);

40
yami-shop-api/src/main/java/com/yami/shop/api/controller/SearchController.java
Unescape View File

@ -19,10 +19,10 @@ import com.yami.shop.bean.dto.SearchProdDto;
import com.yami.shop.common.util.PageParam; import com.yami.shop.common.util.PageParam;
import com.yami.shop.service.HotSearchService; import com.yami.shop.service.HotSearchService;
import com.yami.shop.service.ProductService; import com.yami.shop.service.ProductService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiImplicitParams; import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.GetMapping;
@ -34,7 +34,7 @@ import java.util.List;
@RestController @RestController
@RequestMapping("/search") @RequestMapping("/search")
@Api(tags = "搜索接口") @Tag(name = "搜索接口")
@AllArgsConstructor @AllArgsConstructor
public class SearchController { public class SearchController {
@ -43,11 +43,11 @@ public class SearchController {
private final ProductService productService; private final ProductService productService;
@GetMapping("/hotSearchByShopId") @GetMapping("/hotSearchByShopId")
@ApiOperation(value = "查看店铺热搜", notes = "根据店铺id,热搜数量获取热搜") @Operation(summary = "查看店铺热搜" , description = "根据店铺id,热搜数量获取热搜")
@ApiImplicitParams({ @Parameters({
@ApiImplicitParam(name = "shopId", value = "店铺id", required = true, dataType = "Long"), @Parameter(name = "shopId", description = "店铺id" , required = true),
@ApiImplicitParam(name = "number", value = "取数", required = true, dataType = "Integer"), @Parameter(name = "number", description = "取数" , required = true),
@ApiImplicitParam(name = "sort", value = "是否按照顺序(0 否 1是)", required = false, dataType = "Integer"), @Parameter(name = "sort", description = "是否按照顺序(0 否 1是)"),
}) })
public ResponseEntity<List<HotSearchDto>> hotSearchByShopId(Long shopId,Integer number,Integer sort) { public ResponseEntity<List<HotSearchDto>> hotSearchByShopId(Long shopId,Integer number,Integer sort) {
List<HotSearchDto> list = hotSearchService.getHotSearchDtoByshopId(shopId); List<HotSearchDto> list = hotSearchService.getHotSearchDtoByshopId(shopId);
@ -56,10 +56,10 @@ public class SearchController {
} }
@GetMapping("/hotSearch") @GetMapping("/hotSearch")
@ApiOperation(value = "查看全局热搜", notes = "根据店铺id,热搜数量获取热搜") @Operation(summary = "查看全局热搜" , description = "根据店铺id,热搜数量获取热搜")
@ApiImplicitParams({ @Parameters({
@ApiImplicitParam(name = "number", value = "取数", required = true, dataType = "Integer"), @Parameter(name = "number", description = "取数" , required = true),
@ApiImplicitParam(name = "sort", value = "是否按照顺序(0 否 1是)", required = false, dataType = "Integer"), @Parameter(name = "sort", description = "是否按照顺序(0 否 1是)", required = false ),
}) })
public ResponseEntity<List<HotSearchDto>> hotSearch(Integer number,Integer sort) { public ResponseEntity<List<HotSearchDto>> hotSearch(Integer number,Integer sort) {
List<HotSearchDto> list = hotSearchService.getHotSearchDtoByshopId(0L); List<HotSearchDto> list = hotSearchService.getHotSearchDtoByshopId(0L);
@ -77,12 +77,12 @@ public class SearchController {
} }
@GetMapping("/searchProdPage") @GetMapping("/searchProdPage")
@ApiOperation(value = "分页排序搜索商品", notes = "根据商品名搜索") @Operation(summary = "分页排序搜索商品" , description = "根据商品名搜索")
@ApiImplicitParams({ @Parameters({
@ApiImplicitParam(name = "prodName", value = "商品名", required = true, dataType = "String"), @Parameter(name = "prodName", description = "商品名" , required = true),
@ApiImplicitParam(name = "sort", value = "排序(0 默认排序 1销量排序 2价格排序)", required = false, dataType = "Integer"), @Parameter(name = "sort", description = "排序(0 默认排序 1销量排序 2价格排序)"),
@ApiImplicitParam(name = "orderBy", value = "排序(0升序 1降序)", required = false, dataType = "Integer"), @Parameter(name = "orderBy", description = "排序(0升序 1降序)"),
@ApiImplicitParam(name = "shopId", value = "店铺id", required = true, dataType = "Long"), @Parameter(name = "shopId", description = "店铺id" , required = true),
}) })
public ResponseEntity<IPage<SearchProdDto>> searchProdPage(PageParam page, String prodName, Integer sort, Integer orderBy, Long shopId) { public ResponseEntity<IPage<SearchProdDto>> searchProdPage(PageParam page, String prodName, Integer sort, Integer orderBy, Long shopId) {

22
yami-shop-api/src/main/java/com/yami/shop/api/controller/ShopCartController.java
Unescape View File

@ -25,8 +25,8 @@ import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.BasketService; import com.yami.shop.service.BasketService;
import com.yami.shop.service.ProductService; import com.yami.shop.service.ProductService;
import com.yami.shop.service.SkuService; import com.yami.shop.service.SkuService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import org.springframework.context.ApplicationContext; import org.springframework.context.ApplicationContext;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -41,7 +41,7 @@ import java.util.stream.Collectors;
@RestController @RestController
@RequestMapping("/p/shopCart") @RequestMapping("/p/shopCart")
@Api(tags = "购物车接口") @Tag(name = "购物车接口")
@AllArgsConstructor @AllArgsConstructor
public class ShopCartController { public class ShopCartController {
@ -60,7 +60,7 @@ public class ShopCartController {
* @return * @return
*/ */
@PostMapping("/info") @PostMapping("/info")
@ApiOperation(value = "获取用户购物车信息", notes = "获取用户购物车信息，参数为用户选中的活动项数组,以购物车id为key") @Operation(summary = "获取用户购物车信息" , description = "获取用户购物车信息，参数为用户选中的活动项数组,以购物车id为key")
public ResponseEntity<List<ShopCartDto>> info(@RequestBody Map<Long, ShopCartParam> basketIdShopCartParamMap) { public ResponseEntity<List<ShopCartDto>> info(@RequestBody Map<Long, ShopCartParam> basketIdShopCartParamMap) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
@ -76,7 +76,7 @@ public class ShopCartController {
} }
@DeleteMapping("/deleteItem") @DeleteMapping("/deleteItem")
@ApiOperation(value = "删除用户购物车物品", notes = "通过购物车id删除用户购物车物品") @Operation(summary = "删除用户购物车物品" , description = "通过购物车id删除用户购物车物品")
public ResponseEntity<Void> deleteItem(@RequestBody List<Long> basketIds) { public ResponseEntity<Void> deleteItem(@RequestBody List<Long> basketIds) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
basketService.deleteShopCartItemsByBasketIds(userId, basketIds); basketService.deleteShopCartItemsByBasketIds(userId, basketIds);
@ -84,7 +84,7 @@ public class ShopCartController {
} }
@DeleteMapping("/deleteAll") @DeleteMapping("/deleteAll")
@ApiOperation(value = "清空用户购物车所有物品", notes = "清空用户购物车所有物品") @Operation(summary = "清空用户购物车所有物品" , description = "清空用户购物车所有物品")
public ResponseEntity<String> deleteAll() { public ResponseEntity<String> deleteAll() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
basketService.deleteAllShopCartItems(userId); basketService.deleteAllShopCartItems(userId);
@ -92,7 +92,7 @@ public class ShopCartController {
} }
@PostMapping("/changeItem") @PostMapping("/changeItem")
@ApiOperation(value = "添加、修改用户购物车物品", notes = "通过商品id(prodId)、skuId、店铺Id(shopId),添加/修改用户购物车商品，并传入改变的商品个数(count)，" + @Operation(summary = "添加、修改用户购物车物品", description = "通过商品id(prodId)、skuId、店铺Id(shopId),添加/修改用户购物车商品，并传入改变的商品个数(count)，" +
"当count为正值时，增加商品数量，当count为负值时，将减去商品的数量，当最终count值小于0时，会将商品从购物车里面删除") "当count为正值时，增加商品数量，当count为负值时，将减去商品的数量，当最终count值小于0时，会将商品从购物车里面删除")
public ResponseEntity<String> addItem(@Valid @RequestBody ChangeShopCartParam param) { public ResponseEntity<String> addItem(@Valid @RequestBody ChangeShopCartParam param) {
@ -145,7 +145,7 @@ public class ShopCartController {
} }
@GetMapping("/prodCount") @GetMapping("/prodCount")
@ApiOperation(value = "获取购物车商品数量", notes = "获取所有购物车商品数量") @Operation(summary = "获取购物车商品数量" , description = "获取所有购物车商品数量")
public ResponseEntity<Integer> prodCount() { public ResponseEntity<Integer> prodCount() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
List<ShopCartItemDto> shopCartItems = basketService.getShopCartItems(userId); List<ShopCartItemDto> shopCartItems = basketService.getShopCartItems(userId);
@ -157,7 +157,7 @@ public class ShopCartController {
} }
@GetMapping("/expiryProdList") @GetMapping("/expiryProdList")
@ApiOperation(value = "获取购物车失效商品信息", notes = "获取购物车失效商品列表") @Operation(summary = "获取购物车失效商品信息" , description = "获取购物车失效商品列表")
public ResponseEntity<List<ShopCartExpiryItemDto>> expiryProdList() { public ResponseEntity<List<ShopCartExpiryItemDto>> expiryProdList() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
List<ShopCartItemDto> shopCartItems = basketService.getShopCartExpiryItems(userId); List<ShopCartItemDto> shopCartItems = basketService.getShopCartExpiryItems(userId);
@ -183,7 +183,7 @@ public class ShopCartController {
} }
@DeleteMapping("/cleanExpiryProdList") @DeleteMapping("/cleanExpiryProdList")
@ApiOperation(value = "清空用户失效商品", notes = "清空用户失效商品") @Operation(summary = "清空用户失效商品" , description = "清空用户失效商品")
public ResponseEntity<Void> cleanExpiryProdList() { public ResponseEntity<Void> cleanExpiryProdList() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
basketService.cleanExpiryProdList(userId); basketService.cleanExpiryProdList(userId);
@ -191,7 +191,7 @@ public class ShopCartController {
} }
@PostMapping("/totalPay") @PostMapping("/totalPay")
@ApiOperation(value = "获取选中购物项总计、选中的商品数量", notes = "获取选中购物项总计、选中的商品数量,参数为购物车id数组") @Operation(summary = "获取选中购物项总计、选中的商品数量" , description = "获取选中购物项总计、选中的商品数量,参数为购物车id数组")
public ResponseEntity<ShopCartAmountDto> getTotalPay(@RequestBody List<Long> basketIds) { public ResponseEntity<ShopCartAmountDto> getTotalPay(@RequestBody List<Long> basketIds) {
// 拿到购物车的所有item // 拿到购物车的所有item

12
yami-shop-api/src/main/java/com/yami/shop/api/controller/SkuController.java
Unescape View File

@ -14,9 +14,9 @@ import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.yami.shop.bean.app.dto.SkuDto; import com.yami.shop.bean.app.dto.SkuDto;
import com.yami.shop.bean.model.Sku; import com.yami.shop.bean.model.Sku;
import com.yami.shop.service.SkuService; import com.yami.shop.service.SkuService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -28,7 +28,7 @@ import java.util.List;
@RestController @RestController
@RequestMapping("/sku") @RequestMapping("/sku")
@Api(tags = "sku规格接口") @Tag(name = "sku规格接口")
@AllArgsConstructor @AllArgsConstructor
public class SkuController { public class SkuController {
@ -37,8 +37,8 @@ public class SkuController {
private final MapperFacade mapperFacade; private final MapperFacade mapperFacade;
@GetMapping("/getSkuList") @GetMapping("/getSkuList")
@ApiOperation(value = "通过prodId获取商品全部规格列表", notes = "通过prodId获取商品全部规格列表") @Operation(summary = "通过prodId获取商品全部规格列表" , description = "通过prodId获取商品全部规格列表")
@ApiImplicitParam(name = "prodId", value = "商品id", dataType = "Long") @Parameter(name = "prodId", description = "商品id" )
public ResponseEntity<List<SkuDto>> getSkuListByProdId(Long prodId) { public ResponseEntity<List<SkuDto>> getSkuListByProdId(Long prodId) {
List<Sku> skus = skuService.list(new LambdaQueryWrapper<Sku>() List<Sku> skus = skuService.list(new LambdaQueryWrapper<Sku>()
.eq(Sku::getStatus, 1) .eq(Sku::getStatus, 1)

8
yami-shop-api/src/main/java/com/yami/shop/api/controller/SmsController.java
Unescape View File

@ -15,8 +15,8 @@ import com.yami.shop.bean.app.param.SendSmsParam;
import com.yami.shop.bean.enums.SmsType; import com.yami.shop.bean.enums.SmsType;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.SmsLogService; import com.yami.shop.service.SmsLogService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.PostMapping;
@ -26,7 +26,7 @@ import org.springframework.web.bind.annotation.RestController;
@RestController @RestController
@RequestMapping("/p/sms") @RequestMapping("/p/sms")
@Api(tags="发送验证码接口") @Tag(name = "发送验证码接口")
public class SmsController { public class SmsController {
@Autowired @Autowired
@ -35,7 +35,7 @@ public class SmsController {
* 发送验证码接口 * 发送验证码接口
*/ */
@PostMapping("/send") @PostMapping("/send")
@ApiOperation(value="发送验证码", notes="用户的发送验证码") @Operation(summary = "发送验证码" , description = "用户的发送验证码")
public ResponseEntity<Void> audit(@RequestBody SendSmsParam sendSmsParam) { public ResponseEntity<Void> audit(@RequestBody SendSmsParam sendSmsParam) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
smsLogService.sendSms(SmsType.VALID, userId, sendSmsParam.getMobile(),Maps.newHashMap()); smsLogService.sendSms(SmsType.VALID, userId, sendSmsParam.getMobile(),Maps.newHashMap());

20
yami-shop-api/src/main/java/com/yami/shop/api/controller/UserCollectionController.java
Unescape View File

@ -22,9 +22,9 @@ import com.yami.shop.common.util.PageParam;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.ProductService; import com.yami.shop.service.ProductService;
import com.yami.shop.service.UserCollectionService; import com.yami.shop.service.UserCollectionService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiImplicitParam; import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*; import org.springframework.web.bind.annotation.*;
@ -34,7 +34,7 @@ import java.util.Objects;
@RestController @RestController
@RequestMapping("/p/user/collection") @RequestMapping("/p/user/collection")
@Api(tags = "收藏接口") @Tag(name = "收藏接口")
@AllArgsConstructor @AllArgsConstructor
public class UserCollectionController { public class UserCollectionController {
@ -43,13 +43,13 @@ public class UserCollectionController {
private final ProductService productService; private final ProductService productService;
@GetMapping("/page") @GetMapping("/page")
@ApiOperation(value = "分页返回收藏数据", notes = "根据用户id获取") @Operation(summary = "分页返回收藏数据" , description = "根据用户id获取")
public ResponseEntity<IPage<UserCollectionDto>> getUserCollectionDtoPageByUserId(PageParam page) { public ResponseEntity<IPage<UserCollectionDto>> getUserCollectionDtoPageByUserId(PageParam page) {
return ResponseEntity.ok(userCollectionService.getUserCollectionDtoPageByUserId(page, SecurityUtils.getUser().getUserId())); return ResponseEntity.ok(userCollectionService.getUserCollectionDtoPageByUserId(page, SecurityUtils.getUser().getUserId()));
} }
@GetMapping("isCollection") @GetMapping("isCollection")
@ApiOperation(value = "根据商品id获取该商品是否在收藏夹中", notes = "传入收藏商品id") @Operation(summary = "根据商品id获取该商品是否在收藏夹中" , description = "传入收藏商品id")
public ResponseEntity<Boolean> isCollection(Long prodId) { public ResponseEntity<Boolean> isCollection(Long prodId) {
if (productService.count(new LambdaQueryWrapper<Product>() if (productService.count(new LambdaQueryWrapper<Product>()
.eq(Product::getProdId, prodId)) < 1) { .eq(Product::getProdId, prodId)) < 1) {
@ -61,8 +61,8 @@ public class UserCollectionController {
} }
@PostMapping("/addOrCancel") @PostMapping("/addOrCancel")
@ApiOperation(value = "添加/取消收藏", notes = "传入收藏商品id,如果商品未收藏则收藏商品，已收藏则取消收藏") @Operation(summary = "添加/取消收藏" , description = "传入收藏商品id,如果商品未收藏则收藏商品，已收藏则取消收藏")
@ApiImplicitParam(name = "prodId", value = "商品id", required = true, dataType = "Long") @Parameter(name = "prodId", description = "商品id" , required = true)
public ResponseEntity<Void> addOrCancel(@RequestBody Long prodId) { public ResponseEntity<Void> addOrCancel(@RequestBody Long prodId) {
if (Objects.isNull(productService.getProductByProdId(prodId))) { if (Objects.isNull(productService.getProductByProdId(prodId))) {
throw new YamiShopBindException("该商品不存在"); throw new YamiShopBindException("该商品不存在");
@ -88,14 +88,14 @@ public class UserCollectionController {
* 查询用户收藏商品数量 * 查询用户收藏商品数量
*/ */
@GetMapping("count") @GetMapping("count")
@ApiOperation(value = "查询用户收藏商品数量", notes = "查询用户收藏商品数量") @Operation(summary = "查询用户收藏商品数量" , description = "查询用户收藏商品数量")
public int findUserCollectionCount() { public int findUserCollectionCount() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
return userCollectionService.count(new LambdaQueryWrapper<UserCollection>().eq(UserCollection::getUserId, userId)); return userCollectionService.count(new LambdaQueryWrapper<UserCollection>().eq(UserCollection::getUserId, userId));
} }
@GetMapping("/prods") @GetMapping("/prods")
@ApiOperation(value = "获取用户收藏商品列表", notes = "获取用户收藏商品列表") @Operation(summary = "获取用户收藏商品列表" , description = "获取用户收藏商品列表")
public ResponseEntity<IPage<ProductDto>> collectionProds(PageParam page) { public ResponseEntity<IPage<ProductDto>> collectionProds(PageParam page) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
IPage<ProductDto> productDtoIPage = productService.collectionProds(page, userId); IPage<ProductDto> productDtoIPage = productService.collectionProds(page, userId);

10
yami-shop-api/src/main/java/com/yami/shop/api/controller/UserController.java
Unescape View File

@ -16,8 +16,8 @@ import com.yami.shop.bean.app.param.UserInfoParam;
import com.yami.shop.bean.model.User; import com.yami.shop.bean.model.User;
import com.yami.shop.security.api.util.SecurityUtils; import com.yami.shop.security.api.util.SecurityUtils;
import com.yami.shop.service.UserService; import com.yami.shop.service.UserService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -25,7 +25,7 @@ import org.springframework.web.bind.annotation.*;
@RestController @RestController
@RequestMapping("/p/user") @RequestMapping("/p/user")
@Api(tags="用户接口") @Tag(name = "用户接口")
@AllArgsConstructor @AllArgsConstructor
public class UserController { public class UserController {
@ -36,7 +36,7 @@ public class UserController {
* 查看用户接口 * 查看用户接口
*/ */
@GetMapping("/userInfo") @GetMapping("/userInfo")
@ApiOperation(value="查看用户信息", notes="根据用户ID（userId）获取用户信息") @Operation(summary = "查看用户信息" , description = "根据用户ID（userId）获取用户信息")
public ResponseEntity<UserDto> userInfo() { public ResponseEntity<UserDto> userInfo() {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
User user = userService.getById(userId); User user = userService.getById(userId);
@ -45,7 +45,7 @@ public class UserController {
} }
@PutMapping("/setUserInfo") @PutMapping("/setUserInfo")
@ApiOperation(value="设置用户信息", notes="设置用户信息") @Operation(summary = "设置用户信息" , description = "设置用户信息")
public ResponseEntity<Void> setUserInfo(@RequestBody UserInfoParam userInfoParam) { public ResponseEntity<Void> setUserInfo(@RequestBody UserInfoParam userInfoParam) {
String userId = SecurityUtils.getUser().getUserId(); String userId = SecurityUtils.getUser().getUserId();
User user = new User(); User user = new User();

10
yami-shop-api/src/main/java/com/yami/shop/api/controller/UserRegisterController.java
Unescape View File

@ -13,8 +13,8 @@ import com.yami.shop.security.common.manager.PasswordManager;
import com.yami.shop.security.common.manager.TokenStore; import com.yami.shop.security.common.manager.TokenStore;
import com.yami.shop.security.common.vo.TokenInfoVO; import com.yami.shop.security.common.vo.TokenInfoVO;
import com.yami.shop.service.UserService; import com.yami.shop.service.UserService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.security.crypto.password.PasswordEncoder; import org.springframework.security.crypto.password.PasswordEncoder;
@ -30,7 +30,7 @@ import java.util.Date;
*/ */
@RestController @RestController
@RequestMapping("/user") @RequestMapping("/user")
@Api(tags = "用户注册相关接口") @Tag(name = "用户注册相关接口")
@AllArgsConstructor @AllArgsConstructor
public class UserRegisterController { public class UserRegisterController {
@ -43,7 +43,7 @@ public class UserRegisterController {
private final PasswordManager passwordManager; private final PasswordManager passwordManager;
@PostMapping("/register") @PostMapping("/register")
@ApiOperation(value = "注册", notes = "用户注册或绑定手机号接口") @Operation(summary = "注册" , description = "用户注册或绑定手机号接口")
public ResponseEntity<TokenInfoVO> register(@Valid @RequestBody UserRegisterParam userRegisterParam) { public ResponseEntity<TokenInfoVO> register(@Valid @RequestBody UserRegisterParam userRegisterParam) {
if (StrUtil.isBlank(userRegisterParam.getNickName())) { if (StrUtil.isBlank(userRegisterParam.getNickName())) {
userRegisterParam.setNickName(userRegisterParam.getUserName()); userRegisterParam.setNickName(userRegisterParam.getUserName());
@ -76,7 +76,7 @@ public class UserRegisterController {
@PutMapping("/updatePwd") @PutMapping("/updatePwd")
@ApiOperation(value = "修改密码", notes = "修改密码") @Operation(summary = "修改密码" , description = "修改密码")
public ResponseEntity<Void> updatePwd(@Valid @RequestBody UserRegisterParam userPwdUpdateParam) { public ResponseEntity<Void> updatePwd(@Valid @RequestBody UserRegisterParam userPwdUpdateParam) {
User user = userService.getOne(new LambdaQueryWrapper<User>().eq(User::getNickName, userPwdUpdateParam.getNickName())); User user = userService.getOne(new LambdaQueryWrapper<User>().eq(User::getNickName, userPwdUpdateParam.getNickName()));
if (user == null) { if (user == null) {

3
yami-shop-api/src/main/resources/application.yml
Unescape View File

@ -11,9 +11,6 @@ spring:
jackson: jackson:
date-format: yyyy-MM-dd HH:mm:ss date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8 time-zone: GMT+8
mvc:
pathmatch:
matching-strategy: ANT_PATH_MATCHER
# mybaits-plus配置 # mybaits-plus配置
mybatis-plus: mybatis-plus:
# MyBatis Mapper所对应的XML文件位置 # MyBatis Mapper所对应的XML文件位置

26
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/BasketItemDto.java
Unescape View File

@ -13,7 +13,7 @@ package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.annotation.JsonIgnore; import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ -22,10 +22,10 @@ import java.util.List;
@Data @Data
public class BasketItemDto implements Serializable { public class BasketItemDto implements Serializable {
@ApiModelProperty(value = "购物车ID", required = true) @Schema(description = "购物车ID" , required = true)
private Long basketId; private Long basketId;
@ApiModelProperty(value = "店铺ID", required = true) @Schema(description = "店铺ID" , required = true)
private Long shopId; private Long shopId;
/** /**
@ -34,35 +34,35 @@ public class BasketItemDto implements Serializable {
@JsonIgnore @JsonIgnore
private String shopName; private String shopName;
@ApiModelProperty(value = "产品ID", required = true) @Schema(description = "产品ID" , required = true)
private Long prodId; private Long prodId;
@ApiModelProperty(value = "skuID", required = true) @Schema(description = "skuID" , required = true)
private Long skuId; private Long skuId;
@ApiModelProperty(value = "产品个数", required = true) @Schema(description = "产品个数" , required = true)
private Integer prodCount; private Integer prodCount;
@ApiModelProperty(value = "产品名称", required = true) @Schema(description = "产品名称" , required = true)
private String prodName; private String prodName;
@ApiModelProperty(value = "产品主图", required = true) @Schema(description = "产品主图" , required = true)
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
private String pic; private String pic;
@ApiModelProperty(value = "产品现价", required = true) @Schema(description = "产品现价" , required = true)
private Double price; private Double price;
@ApiModelProperty(value = "产品原价", required = true) @Schema(description = "产品原价" , required = true)
private Double oriPrice; private Double oriPrice;
@ApiModelProperty(value = "产品简介", required = true) @Schema(description = "产品简介" , required = true)
private String brief; private String brief;
@ApiModelProperty(value = "产品sku信息", required = true) @Schema(description = "产品sku信息" , required = true)
private String skuName; private String skuName;
@ApiModelProperty("参与满减活动列表") @Schema(description = "参与满减活动列表" )
private List<DiscountDto> discounts; private List<DiscountDto> discounts;
} }

10
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/CategoryDto.java
Unescape View File

@ -12,22 +12,22 @@ package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
public class CategoryDto { public class CategoryDto {
@ApiModelProperty(value = "分类id",required=true) @Schema(description = "分类id" ,required=true)
private Long categoryId; private Long categoryId;
@ApiModelProperty(value = "分类父id",required=true) @Schema(description = "分类父id" ,required=true)
private Long parentId; private Long parentId;
@ApiModelProperty(value = "分类名称",required=true) @Schema(description = "分类名称" ,required=true)
private String categoryName; private String categoryName;
@ApiModelProperty(value = "分类图片",required=true) @Schema(description = "分类图片" ,required=true)
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
private String pic; private String pic;

2
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/CouponOrderDto.java
Unescape View File

@ -11,7 +11,7 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;

10
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/DeliveryDto.java
Unescape View File

@ -12,22 +12,22 @@ package com.yami.shop.bean.app.dto;
import java.util.List; import java.util.List;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
public class DeliveryDto { public class DeliveryDto {
@ApiModelProperty(value = "物流公司名称",required=true) @Schema(description = "物流公司名称" ,required=true)
private String companyName; private String companyName;
@ApiModelProperty(value = "物流公司官网",required=true) @Schema(description = "物流公司官网" ,required=true)
private String companyHomeUrl; private String companyHomeUrl;
@ApiModelProperty(value = "物流订单号",required=true) @Schema(description = "物流订单号" ,required=true)
private String dvyFlowId; private String dvyFlowId;
@ApiModelProperty(value = "查询出的物流信息",required=true) @Schema(description = "查询出的物流信息" ,required=true)
private List<DeliveryInfoDto> data; private List<DeliveryInfoDto> data;
} }

8
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/DeliveryInfoDto.java
Unescape View File

@ -10,21 +10,21 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
public class DeliveryInfoDto { public class DeliveryInfoDto {
@ApiModelProperty(value = "详细信息",required=true) @Schema(description = "详细信息" ,required=true)
private String context; private String context;
private String ftime; private String ftime;
@ApiModelProperty(value = "快递所在区域",required=true) @Schema(description = "快递所在区域" ,required=true)
private String location; private String location;
@ApiModelProperty(value = "物流更新时间",required=true) @Schema(description = "物流更新时间" ,required=true)
private String time; private String time;
} }

15
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/IndexImgDto.java
Unescape View File

@ -12,13 +12,12 @@ package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
@ApiModel("首页图片对象") @Schema(description = "首页图片对象")
@Data @Data
public class IndexImgDto { public class IndexImgDto {
@ -26,31 +25,31 @@ public class IndexImgDto {
* 图片 * 图片
*/ */
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
@ApiModelProperty(value = "图片Url", required = true) @Schema(description = "图片Url" , required = true)
private String imgUrl; private String imgUrl;
/** /**
* 顺序 * 顺序
*/ */
@ApiModelProperty(value = "图片顺序", required = true) @Schema(description = "图片顺序" , required = true)
private Integer seq; private Integer seq;
/** /**
* 上传时间 * 上传时间
*/ */
@ApiModelProperty(value = "上传时间", required = true) @Schema(description = "上传时间" , required = true)
private Date uploadTime; private Date uploadTime;
/** /**
* 类型 * 类型
*/ */
@ApiModelProperty(value = "类型", required = true) @Schema(description = "类型" , required = true)
private int type; private int type;
/** /**
* 关联id * 关联id
*/ */
@ApiModelProperty(value = "关联id", required = true) @Schema(description = "关联id" , required = true)
private Long relation; private Long relation;

13
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/MyOrderDto.java
Unescape View File

@ -12,24 +12,23 @@ package com.yami.shop.bean.app.dto;
import java.util.List; import java.util.List;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel("我的订单") @Schema(description = "我的订单")
public class MyOrderDto { public class MyOrderDto {
@ApiModelProperty(value = "订单项",required=true) @Schema(description = "订单项" ,required=true)
private List<MyOrderItemDto> orderItemDtos; private List<MyOrderItemDto> orderItemDtos;
@ApiModelProperty(value = "订单号",required=true) @Schema(description = "订单号" ,required=true)
private String orderNumber; private String orderNumber;
@ApiModelProperty(value = "总价",required=true) @Schema(description = "总价" ,required=true)
private Double actualTotal; private Double actualTotal;
@ApiModelProperty(value = "订单状态",required=true) @Schema(description = "订单状态" ,required=true)
private Integer status; private Integer status;
} }

15
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/MyOrderItemDto.java
Unescape View File

@ -12,28 +12,27 @@ package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@ApiModel("我的订单-订单项") @Schema(description = "我的订单-订单项")
@Data @Data
public class MyOrderItemDto { public class MyOrderItemDto {
@ApiModelProperty(value = "商品图片", required = true) @Schema(description = "商品图片" , required = true)
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
private String pic; private String pic;
@ApiModelProperty(value = "商品名称", required = true) @Schema(description = "商品名称" , required = true)
private String prodName; private String prodName;
@ApiModelProperty(value = "商品数量", required = true) @Schema(description = "商品数量" , required = true)
private Integer prodCount; private Integer prodCount;
@ApiModelProperty(value = "商品价格", required = true) @Schema(description = "商品价格" , required = true)
private Double price; private Double price;
@ApiModelProperty(value = "skuName", required = true) @Schema(description = "skuName" , required = true)
private String skuName; private String skuName;
} }

15
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/NoticeDto.java
Unescape View File

@ -11,34 +11,33 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.annotation.JsonView; import com.fasterxml.jackson.annotation.JsonView;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
@ApiModel("公告对象") @Schema(description = "公告对象")
@Data @Data
public class NoticeDto { public class NoticeDto {
@JsonView(NoContent.class) @JsonView(NoContent.class)
@ApiModelProperty(value = "公告id") @Schema(description = "公告id" )
private Long id; private Long id;
@JsonView(NoContent.class) @JsonView(NoContent.class)
@ApiModelProperty(value = "店铺id") @Schema(description = "店铺id" )
private Long shopId; private Long shopId;
@JsonView(NoContent.class) @JsonView(NoContent.class)
@ApiModelProperty(value = "标题") @Schema(description = "标题" )
private String title; private String title;
@ApiModelProperty(value = "公告内容") @Schema(description = "公告内容" )
@JsonView(WithContent.class) @JsonView(WithContent.class)
private String content; private String content;
@JsonView(NoContent.class) @JsonView(NoContent.class)
@ApiModelProperty(value = "公告发布时间") @Schema(description = "公告发布时间" )
private Date publishTime; private Date publishTime;
public static interface NoContent{} public static interface NoContent{}

19
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/OrderCountData.java
Unescape View File

@ -10,33 +10,32 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel("我的订单数量") @Schema(description = "我的订单数量")
public class OrderCountData { public class OrderCountData {
@ApiModelProperty(value = "所有订单数量") @Schema(description = "所有订单数量" )
private Integer allCount; private Integer allCount;
@ApiModelProperty(value = "待付款") @Schema(description = "待付款" )
private Integer unPay; private Integer unPay;
@ApiModelProperty(value = "待发货") @Schema(description = "待发货" )
private Integer payed; private Integer payed;
@ApiModelProperty(value = "待收货") @Schema(description = "待收货" )
private Integer consignment; private Integer consignment;
@ApiModelProperty(value = "待评价") @Schema(description = "待评价" )
private Integer confirm; private Integer confirm;
@ApiModelProperty(value = "成功") @Schema(description = "成功" )
private Integer success; private Integer success;
@ApiModelProperty(value = "失败") @Schema(description = "失败" )
private Integer close; private Integer close;

4
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/OrderNumbersDto.java
Unescape View File

@ -10,13 +10,13 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
public class OrderNumbersDto { public class OrderNumbersDto {
@ApiModelProperty(value = "多个订单号拼接的字符串",required=true) @Schema(description = "多个订单号拼接的字符串" ,required=true)
private String orderNumbers; private String orderNumbers;
public OrderNumbersDto(String orderNumbers) { public OrderNumbersDto(String orderNumbers) {

30
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/OrderShopDto.java
Unescape View File

@ -17,7 +17,7 @@ import java.util.List;
import lombok.Data; import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat; import org.springframework.format.annotation.DateTimeFormat;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
/** /**
* 订单下的每个店铺 * 订单下的每个店铺
@ -30,58 +30,58 @@ public class OrderShopDto implements Serializable {
/** /**
* 店铺ID * 店铺ID
**/ **/
@ApiModelProperty(value = "店铺id", required = true) @Schema(description = "店铺id" , required = true)
private Long shopId; private Long shopId;
/** /**
* 店铺名称 * 店铺名称
**/ **/
@ApiModelProperty(value = "店铺名称", required = true) @Schema(description = "店铺名称" , required = true)
private String shopName; private String shopName;
@ApiModelProperty(value = "实际总值", required = true) @Schema(description = "实际总值" , required = true)
private Double actualTotal; private Double actualTotal;
@ApiModelProperty(value = "商品总值", required = true) @Schema(description = "商品总值" , required = true)
private Double total; private Double total;
@ApiModelProperty(value = "商品总数", required = true) @Schema(description = "商品总数" , required = true)
private Integer totalNum; private Integer totalNum;
@ApiModelProperty(value = "地址Dto", required = true) @Schema(description = "地址Dto" , required = true)
private UserAddrDto userAddrDto; private UserAddrDto userAddrDto;
@ApiModelProperty(value = "产品信息", required = true) @Schema(description = "产品信息" , required = true)
private List<OrderItemDto> orderItemDtos; private List<OrderItemDto> orderItemDtos;
@ApiModelProperty(value = "运费", required = true) @Schema(description = "运费" , required = true)
private Double transfee; private Double transfee;
@ApiModelProperty(value = "优惠总额", required = true) @Schema(description = "优惠总额" , required = true)
private Double reduceAmount; private Double reduceAmount;
@ApiModelProperty(value = "促销活动优惠金额", required = true) @Schema(description = "促销活动优惠金额" , required = true)
private Double discountMoney; private Double discountMoney;
@ApiModelProperty(value = "优惠券优惠金额", required = true) @Schema(description = "优惠券优惠金额" , required = true)
private Double couponMoney; private Double couponMoney;
/** /**
* 创建时间 * 创建时间
*/ */
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
@ApiModelProperty(value = "订单创建时间", required = true) @Schema(description = "订单创建时间" , required = true)
private Date createTime; private Date createTime;
/** /**
* 订单备注信息 * 订单备注信息
*/ */
@ApiModelProperty(value = "订单备注信息", required = true) @Schema(description = "订单备注信息" , required = true)
private String remarks; private String remarks;
/** /**
* 订单状态 * 订单状态
*/ */
@ApiModelProperty(value = "订单状态", required = true) @Schema(description = "订单状态" , required = true)
private Integer status; private Integer status;
} }

17
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ProdCommDataDto.java
Unescape View File

@ -10,31 +10,30 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@ApiModel("商品评论数据") @Schema(description = "商品评论数据")
@Data @Data
public class ProdCommDataDto { public class ProdCommDataDto {
@ApiModelProperty(value = "好评率") @Schema(description = "好评率" )
private Double positiveRating; private Double positiveRating;
@ApiModelProperty(value = "评论数量") @Schema(description = "评论数量" )
private Integer number; private Integer number;
@ApiModelProperty(value = "好评数") @Schema(description = "好评数" )
private Integer praiseNumber; private Integer praiseNumber;
@ApiModelProperty(value = "中评数") @Schema(description = "中评数" )
private Integer secondaryNumber; private Integer secondaryNumber;
@ApiModelProperty(value = "差评数") @Schema(description = "差评数" )
private Integer negativeNumber; private Integer negativeNumber;
@ApiModelProperty(value = "有图数") @Schema(description = "有图数" )
private Integer picNumber; private Integer picNumber;
} }

29
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ProdCommDto.java
Unescape View File

@ -14,43 +14,42 @@ import com.fasterxml.jackson.annotation.JsonFormat;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.EmojiJsonSerializer; import com.yami.shop.common.serializer.json.EmojiJsonSerializer;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat; import org.springframework.format.annotation.DateTimeFormat;
import java.util.Date; import java.util.Date;
import java.util.List; import java.util.List;
@ApiModel("评论对象") @Schema(description = "评论对象")
@Data @Data
public class ProdCommDto { public class ProdCommDto {
@ApiModelProperty(value = "id") @Schema(description = "id" )
private Long prodCommId; private Long prodCommId;
/** /**
* 得分，0-5分 * 得分，0-5分
*/ */
@ApiModelProperty(value = "得分，0-5分") @Schema(description = "得分，0-5分" )
private Integer score; private Integer score;
/** /**
* 是否匿名(1:是 0:否) * 是否匿名(1:是 0:否)
*/ */
@ApiModelProperty(value = "是否匿名(1:是 0:否)") @Schema(description = "是否匿名(1:是 0:否)" )
private Integer isAnonymous; private Integer isAnonymous;
/** /**
* 掌柜回复 * 掌柜回复
*/ */
@ApiModelProperty(value = "掌柜回复") @Schema(description = "掌柜回复" )
private String replyContent; private String replyContent;
/** /**
* 记录时间 * 记录时间
*/ */
@ApiModelProperty(value = "记录时间") @Schema(description = "记录时间" )
@DateTimeFormat(pattern = "yyyy-MM-dd") @DateTimeFormat(pattern = "yyyy-MM-dd")
@JsonFormat(pattern = "yyyy-MM-dd") @JsonFormat(pattern = "yyyy-MM-dd")
private Date recTime; private Date recTime;
@ -58,40 +57,40 @@ public class ProdCommDto {
/** /**
* 回复时间 * 回复时间
*/ */
@ApiModelProperty(value = "回复时间") @Schema(description = "回复时间" )
@JsonFormat(pattern = "yyyy-MM-dd") @JsonFormat(pattern = "yyyy-MM-dd")
private Date replyTime; private Date replyTime;
@JsonSerialize(using = EmojiJsonSerializer.class) @JsonSerialize(using = EmojiJsonSerializer.class)
@ApiModelProperty(value = "用户昵称") @Schema(description = "用户昵称" )
private String nickName; private String nickName;
/** /**
* 头像图片路径 * 头像图片路径
*/ */
@ApiModelProperty(value = "头像图片路径") @Schema(description = "头像图片路径" )
private String pic; private String pic;
/** /**
* 是否回复 0:未回复 1:已回复 * 是否回复 0:未回复 1:已回复
*/ */
@ApiModelProperty(value = "商家是否回复 0:未回复 1:已回复") @Schema(description = "商家是否回复 0:未回复 1:已回复" )
private Integer replySts; private Integer replySts;
/** /**
* 评论图片 * 评论图片
*/ */
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
@ApiModelProperty(value = "评论图片") @Schema(description = "评论图片" )
private String pics; private String pics;
/** /**
* 评价等级 * 评价等级
*/ */
@ApiModelProperty(value = "0好评 1中评 2差评") @Schema(description = "0好评 1中评 2差评" )
private Byte evaluate; private Byte evaluate;
@ApiModelProperty(value = "评论内容") @Schema(description = "评论内容" )
private String content; private String content;
} }

10
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ProdTagDto.java
Unescape View File

@ -10,22 +10,22 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
public class ProdTagDto { public class ProdTagDto {
@ApiModelProperty(value = "分组标签id") @Schema(description = "分组标签id" )
private Long id; private Long id;
@ApiModelProperty(value = "分组标签标题") @Schema(description = "分组标签标题" )
private String title; private String title;
@ApiModelProperty(value = "排序（数值越高越靠前）") @Schema(description = "排序（数值越高越靠前）" )
private String seq; private String seq;
@ApiModelProperty(value = "列表样式(0:一列一个,1:一列两个,2:一列三个)") @Schema(description = "列表样式(0:一列一个,1:一列两个,2:一列三个)" )
private String style; private String style;
} }

30
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ProductDto.java
Unescape View File

@ -16,7 +16,7 @@ import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.bean.model.Transport; import com.yami.shop.bean.model.Transport;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
@ -24,78 +24,78 @@ public class ProductDto {
/** /**
* 店铺ID * 店铺ID
*/ */
@ApiModelProperty(value = "店铺ID", required = true) @Schema(description = "店铺ID" , required = true)
private Long shopId; private Long shopId;
/** /**
* 店铺名称 * 店铺名称
*/ */
@ApiModelProperty(value = "店铺名称", required = true) @Schema(description = "店铺名称" , required = true)
private String shopName; private String shopName;
/** /**
* 商品ID * 商品ID
*/ */
@ApiModelProperty(value = "商品ID", required = true) @Schema(description = "商品ID" , required = true)
private Long prodId; private Long prodId;
/** /**
* 商品名称 * 商品名称
*/ */
@ApiModelProperty(value = "商品名称") @Schema(description = "商品名称" )
private String prodName; private String prodName;
/** /**
* 商品价格 * 商品价格
*/ */
@ApiModelProperty(value = "商品价格", required = true) @Schema(description = "商品价格" , required = true)
private Double price; private Double price;
/** /**
* 商品详情 * 商品详情
*/ */
@ApiModelProperty(value = "详细描述") @Schema(description = "详细描述" )
private String content; private String content;
/** /**
* 商品原价 * 商品原价
*/ */
@ApiModelProperty(value = "商品原价", required = true) @Schema(description = "商品原价" , required = true)
private Double oriPrice; private Double oriPrice;
/** /**
* 库存量 * 库存量
*/ */
@ApiModelProperty(value = "库存量", required = true) @Schema(description = "库存量" , required = true)
private Integer totalStocks; private Integer totalStocks;
/** /**
* 简要描述,卖点等 * 简要描述,卖点等
*/ */
@ApiModelProperty(value = "简要描述,卖点等", required = true) @Schema(description = "简要描述,卖点等" , required = true)
private String brief; private String brief;
/** /**
* 商品主图 * 商品主图
*/ */
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
@ApiModelProperty(value = "商品主图", required = true) @Schema(description = "商品主图" , required = true)
private String pic; private String pic;
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
@ApiModelProperty(value = "商品图片列表，以逗号分割", required = true) @Schema(description = "商品图片列表，以逗号分割" , required = true)
private String imgs; private String imgs;
/** /**
* 商品分类 * 商品分类
*/ */
@ApiModelProperty(value = "商品分类id", required = true) @Schema(description = "商品分类id" , required = true)
private Long categoryId; private Long categoryId;
@ApiModelProperty(value = "sku列表") @Schema(description = "sku列表" )
private List<SkuDto> skuList; private List<SkuDto> skuList;
@ApiModelProperty(value = "运费信息", required = true) @Schema(description = "运费信息" , required = true)
private Transport transport; private Transport transport;
public static interface WithNoContent{} public static interface WithNoContent{}

28
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ProductItemDto.java
Unescape View File

@ -13,7 +13,7 @@ package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.annotation.JsonIgnore; import com.fasterxml.jackson.annotation.JsonIgnore;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ -26,43 +26,43 @@ import java.util.List;
@Data @Data
public class ProductItemDto implements Serializable { public class ProductItemDto implements Serializable {
@ApiModelProperty(value = "产品名称",required=true) @Schema(description = "产品名称" ,required=true)
private String prodName; private String prodName;
@ApiModelProperty(value = "产品个数",required=true) @Schema(description = "产品个数" ,required=true)
private Integer prodCount; private Integer prodCount;
@ApiModelProperty(value = "产品图片路径",required=true) @Schema(description = "产品图片路径" ,required=true)
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
private String pic; private String pic;
@ApiModelProperty(value = "产品价格",required=true) @Schema(description = "产品价格" ,required=true)
private Double price; private Double price;
@ApiModelProperty(value = "商品总金额",required=true) @Schema(description = "商品总金额" ,required=true)
private Double productTotalAmount; private Double productTotalAmount;
@ApiModelProperty(value = "产品ID",required=true) @Schema(description = "产品ID" ,required=true)
private Long prodId; private Long prodId;
@ApiModelProperty(value = "skuId",required=true) @Schema(description = "skuId" ,required=true)
private Long skuId; private Long skuId;
@ApiModelProperty(value = "规格名称", required = true) @Schema(description = "规格名称" , required = true)
private String skuName; private String skuName;
@ApiModelProperty(value = "basketId",required=true) @Schema(description = "basketId" ,required=true)
private Long basketId; private Long basketId;
@ApiModelProperty(value = "商品实际金额 = 商品总金额 - 分摊的优惠金额") @Schema(description = "商品实际金额 = 商品总金额 - 分摊的优惠金额" )
private Double actualTotal; private Double actualTotal;
@ApiModelProperty(value = "满减满折优惠id，0不主动参与活动（用户没有主动参与该活动），-1主动不参与活动") @Schema(description = "满减满折优惠id，0不主动参与活动（用户没有主动参与该活动），-1主动不参与活动" )
private Long discountId = 0L; private Long discountId = 0L;
@ApiModelProperty(value = "分摊的优惠金额") @Schema(description = "分摊的优惠金额" )
private Double shareReduce; private Double shareReduce;
@ApiModelProperty("参与满减活动列表") @Schema(description = "参与满减活动列表" )
private List<DiscountDto> discounts = new ArrayList<>(); private List<DiscountDto> discounts = new ArrayList<>();
} }

13
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ShopCartAmountDto.java
Unescape View File

@ -10,23 +10,22 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel("购物车合计") @Schema(description = "购物车合计")
public class ShopCartAmountDto { public class ShopCartAmountDto {
@ApiModelProperty("总额") @Schema(description = "总额" )
private Double totalMoney; private Double totalMoney;
@ApiModelProperty("总计") @Schema(description = "总计" )
private Double finalMoney; private Double finalMoney;
@ApiModelProperty("减额") @Schema(description = "减额" )
private Double subtractMoney; private Double subtractMoney;
@ApiModelProperty("商品数量") @Schema(description = "商品数量" )
private Integer count; private Integer count;
} }

8
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ShopCartDto.java
Unescape View File

@ -10,7 +10,7 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ -19,13 +19,13 @@ import java.util.List;
@Data @Data
public class ShopCartDto implements Serializable { public class ShopCartDto implements Serializable {
@ApiModelProperty(value = "店铺ID", required = true) @Schema(description = "店铺ID" , required = true)
private Long shopId; private Long shopId;
@ApiModelProperty(value = "店铺名称", required = true) @Schema(description = "店铺名称" , required = true)
private String shopName; private String shopName;
@ApiModelProperty(value = "购物车商品", required = true) @Schema(description = "购物车商品" , required = true)
private List<ShopCartItemDiscountDto> shopCartItemDiscounts; private List<ShopCartItemDiscountDto> shopCartItemDiscounts;

11
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ShopCartExpiryItemDto.java
Unescape View File

@ -10,22 +10,21 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.List; import java.util.List;
@Data @Data
@ApiModel("购物车失效商品对象") @Schema(description = "购物车失效商品对象")
public class ShopCartExpiryItemDto { public class ShopCartExpiryItemDto {
@ApiModelProperty(value = "店铺ID", required = true) @Schema(description = "店铺ID" , required = true)
private Long shopId; private Long shopId;
@ApiModelProperty(value = "店铺名称", required = true) @Schema(description = "店铺名称" , required = true)
private String shopName; private String shopName;
@ApiModelProperty(value = "商品项", required = true) @Schema(description = "商品项" , required = true)
private List<ShopCartItemDto> shopCartItemDtoList; private List<ShopCartItemDto> shopCartItemDtoList;
} }

6
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ShopCartItemDiscountDto.java
Unescape View File

@ -10,7 +10,7 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ -20,9 +20,9 @@ import java.util.List;
public class ShopCartItemDiscountDto implements Serializable { public class ShopCartItemDiscountDto implements Serializable {
@ApiModelProperty(value = "已选满减项", required = true) @Schema(description = "已选满减项" , required = true)
private ChooseDiscountItemDto chooseDiscountItemDto; private ChooseDiscountItemDto chooseDiscountItemDto;
@ApiModelProperty(value = "商品列表") @Schema(description = "商品列表" )
private List<ShopCartItemDto> shopCartItems; private List<ShopCartItemDto> shopCartItems;
} }

16
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ShopCartItemDto.java
Unescape View File

@ -12,7 +12,7 @@ package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import lombok.EqualsAndHashCode; import lombok.EqualsAndHashCode;
@ -29,24 +29,24 @@ import java.util.List;
public class ShopCartItemDto extends ProductItemDto implements Serializable { public class ShopCartItemDto extends ProductItemDto implements Serializable {
private static final long serialVersionUID = -8284981156242930909L; private static final long serialVersionUID = -8284981156242930909L;
@ApiModelProperty(value = "购物车ID", required = true) @Schema(description = "购物车ID" , required = true)
private Long basketId; private Long basketId;
@ApiModelProperty(value = "店铺ID", required = true) @Schema(description = "店铺ID" , required = true)
private Long shopId; private Long shopId;
@ApiModelProperty(value = "规格名称", required = true) @Schema(description = "规格名称" , required = true)
private String skuName; private String skuName;
@ApiModelProperty(value = "店铺名称", required = true) @Schema(description = "店铺名称" , required = true)
private String shopName; private String shopName;
@ApiModelProperty(value = "商品原价", required = true) @Schema(description = "商品原价" , required = true)
private Double oriPrice; private Double oriPrice;
@ApiModelProperty(value = "推广员使用的推销卡号") @Schema(description = "推广员使用的推销卡号" )
private String distributionCardNo; private String distributionCardNo;
@ApiModelProperty(value = "加入购物车的时间") @Schema(description = "加入购物车的时间" )
private Date basketDate; private Date basketDate;
} }

28
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ShopCartOrderDto.java
Unescape View File

@ -10,7 +10,7 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ -22,42 +22,42 @@ import java.util.List;
@Data @Data
public class ShopCartOrderDto implements Serializable{ public class ShopCartOrderDto implements Serializable{
@ApiModelProperty(value = "店铺id", required = true) @Schema(description = "店铺id" , required = true)
private Long shopId; private Long shopId;
@ApiModelProperty(value = "店铺名称", required = true) @Schema(description = "店铺名称" , required = true)
private String shopName; private String shopName;
@ApiModelProperty(value = "实际总值", required = true) @Schema(description = "实际总值" , required = true)
private Double actualTotal; private Double actualTotal;
@ApiModelProperty(value = "商品总值", required = true) @Schema(description = "商品总值" , required = true)
private Double total; private Double total;
@ApiModelProperty(value = "商品总数", required = true) @Schema(description = "商品总数" , required = true)
private Integer totalCount; private Integer totalCount;
@ApiModelProperty(value = "运费", required = true) @Schema(description = "运费" , required = true)
private Double transfee; private Double transfee;
@ApiModelProperty(value = "促销活动优惠金额", required = true) @Schema(description = "促销活动优惠金额" , required = true)
private Double discountReduce; private Double discountReduce;
@ApiModelProperty(value = "优惠券优惠金额", required = true) @Schema(description = "优惠券优惠金额" , required = true)
private Double couponReduce; private Double couponReduce;
@ApiModelProperty(value = "店铺优惠金额(促销活动 + 优惠券 + 其他)", required = true) @Schema(description = "店铺优惠金额(促销活动 + 优惠券 + 其他)" , required = true)
private Double shopReduce = 0.0; private Double shopReduce = 0.0;
@ApiModelProperty(value = "订单备注信息", required = true) @Schema(description = "订单备注信息" , required = true)
private String remarks; private String remarks;
@ApiModelProperty(value = "购物车商品", required = true) @Schema(description = "购物车商品" , required = true)
private List<ShopCartItemDiscountDto> shopCartItemDiscounts; private List<ShopCartItemDiscountDto> shopCartItemDiscounts;
@ApiModelProperty(value = "整个店铺可以使用的优惠券列表", required = true) @Schema(description = "整个店铺可以使用的优惠券列表" , required = true)
private List<CouponOrderDto> coupons; private List<CouponOrderDto> coupons;
@ApiModelProperty(value = "订单编号", required = true) @Schema(description = "订单编号" , required = true)
private String orderNumber; private String orderNumber;
} }

16
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/ShopCartOrderMergerDto.java
Unescape View File

@ -10,7 +10,7 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ -23,24 +23,24 @@ import java.util.List;
@Data @Data
public class ShopCartOrderMergerDto implements Serializable{ public class ShopCartOrderMergerDto implements Serializable{
@ApiModelProperty(value = "实际总值", required = true) @Schema(description = "实际总值" , required = true)
private Double actualTotal; private Double actualTotal;
@ApiModelProperty(value = "商品总值", required = true) @Schema(description = "商品总值" , required = true)
private Double total; private Double total;
@ApiModelProperty(value = "商品总数", required = true) @Schema(description = "商品总数" , required = true)
private Integer totalCount; private Integer totalCount;
@ApiModelProperty(value = "订单优惠金额(所有店铺优惠金额相加)", required = true) @Schema(description = "订单优惠金额(所有店铺优惠金额相加)" , required = true)
private Double orderReduce; private Double orderReduce;
@ApiModelProperty(value = "地址Dto", required = true) @Schema(description = "地址Dto" , required = true)
private UserAddrDto userAddr; private UserAddrDto userAddr;
@ApiModelProperty(value = "每个店铺的购物车信息", required = true) @Schema(description = "每个店铺的购物车信息" , required = true)
private List<ShopCartOrderDto> shopCartOrders; private List<ShopCartOrderDto> shopCartOrders;
@ApiModelProperty(value = "整个订单可以使用的优惠券列表", required = true) @Schema(description = "整个订单可以使用的优惠券列表" , required = true)
private List<CouponOrderDto> coupons; private List<CouponOrderDto> coupons;
} }

16
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/SkuDto.java
Unescape View File

@ -12,7 +12,7 @@ package com.yami.shop.bean.app.dto;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ -22,23 +22,23 @@ public class SkuDto implements Serializable {
private static final long serialVersionUID = 6457261945829470666L; private static final long serialVersionUID = 6457261945829470666L;
@ApiModelProperty(value = "skuId", required = true) @Schema(description = "skuId" , required = true)
private Long skuId; private Long skuId;
@ApiModelProperty(value = "价格", required = true) @Schema(description = "价格" , required = true)
private Double price; private Double price;
@ApiModelProperty(value = "原价") @Schema(description = "原价" )
private Double oriPrice; private Double oriPrice;
@ApiModelProperty(value = "库存(-1表示无穷)", required = true) @Schema(description = "库存(-1表示无穷)" , required = true)
private Integer stocks; private Integer stocks;
@ApiModelProperty(value = "sku名称", required = true) @Schema(description = "sku名称" , required = true)
private String skuName; private String skuName;
@ApiModelProperty(value = "图片") @Schema(description = "图片" )
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
private String pic; private String pic;
@ApiModelProperty(value = "销售属性组合字符串,格式是p1:v1;p2:v2", required = true) @Schema(description = "销售属性组合字符串,格式是p1:v1;p2:v2" , required = true)
private String properties; private String properties;
} }

10
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/TagProductDto.java
Unescape View File

@ -11,7 +11,7 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import com.yami.shop.bean.model.ProdTag; import com.yami.shop.bean.model.ProdTag;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.util.List; import java.util.List;
@ -19,16 +19,16 @@ import java.util.List;
@Data @Data
public class TagProductDto { public class TagProductDto {
@ApiModelProperty(value = "分组标签id") @Schema(description = "分组标签id" )
private Long id; private Long id;
@ApiModelProperty(value = "分组标签标题") @Schema(description = "分组标签标题" )
private String title; private String title;
@ApiModelProperty(value = "排序（数值越高越靠前）") @Schema(description = "排序（数值越高越靠前）" )
private String seq; private String seq;
@ApiModelProperty(value = "列表样式(0:一列一个,1:一列两个,2:一列三个)") @Schema(description = "列表样式(0:一列一个,1:一列两个,2:一列三个)" )
private String style; private String style;
private List<ProductDto> productDtoList; private List<ProductDto> productDtoList;

24
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/UserAddrDto.java
Unescape View File

@ -10,52 +10,52 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@Data @Data
public class UserAddrDto implements Serializable { public class UserAddrDto implements Serializable {
@ApiModelProperty(value = "地址id", required = true) @Schema(description = "地址id" , required = true)
private Long addrId; private Long addrId;
@ApiModelProperty(value = "收货人", required = true) @Schema(description = "收货人" , required = true)
private String receiver; private String receiver;
@ApiModelProperty(value = "省", required = true) @Schema(description = "省" , required = true)
private String province; private String province;
@ApiModelProperty(value = "城市", required = true) @Schema(description = "城市" , required = true)
private String city; private String city;
@ApiModelProperty(value = "区", required = true) @Schema(description = "区" , required = true)
private String area; private String area;
@ApiModelProperty(value = "地址", required = true) @Schema(description = "地址" , required = true)
private String addr; private String addr;
@ApiModelProperty(value = "手机", required = true) @Schema(description = "手机" , required = true)
private String mobile; private String mobile;
@ApiModelProperty(value = "是否默认地址（1:是 0：否） ", required = true) @Schema(description = "是否默认地址（1:是 0：否） " , required = true)
private Integer commonAddr; private Integer commonAddr;
/** /**
* 省ID * 省ID
*/ */
@ApiModelProperty(value = "省ID", required = true) @Schema(description = "省ID" , required = true)
private Long provinceId; private Long provinceId;
/** /**
* 城市ID * 城市ID
*/ */
@ApiModelProperty(value = "城市ID", required = true) @Schema(description = "城市ID" , required = true)
private Long cityId; private Long cityId;
/** /**
* 区域ID * 区域ID
*/ */
@ApiModelProperty(value = "区域ID", required = true) @Schema(description = "区域ID" , required = true)
private Long areaId; private Long areaId;
} }

11
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/UserCollectionDto.java
Unescape View File

@ -10,23 +10,22 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.util.Date; import java.util.Date;
@ApiModel("收藏对象") @Schema(description = "收藏对象")
@Data @Data
public class UserCollectionDto { public class UserCollectionDto {
@ApiModelProperty(value = "收藏id") @Schema(description = "收藏id" )
private Long id; private Long id;
@ApiModelProperty(value = "商品名称") @Schema(description = "商品名称" )
private String prodName; private String prodName;
@ApiModelProperty(value = "收藏时间") @Schema(description = "收藏时间" )
private Date createTime; private Date createTime;
} }

8
yami-shop-bean/src/main/java/com/yami/shop/bean/app/dto/UserDto.java
Unescape View File

@ -10,14 +10,14 @@
package com.yami.shop.bean.app.dto; package com.yami.shop.bean.app.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
public class UserDto { public class UserDto {
@ApiModelProperty(value = "用户状态：0禁用 1正常",required=true) @Schema(description = "用户状态：0禁用 1正常" ,required=true)
private Integer status; private Integer status;
@ApiModelProperty(value = "token",required=true) @Schema(description = "token" ,required=true)
private String token; private String token;
public Integer getStatus() { public Integer getStatus() {
@ -33,4 +33,4 @@ public class UserDto {
this.token = token; this.token = token;
} }
} }

27
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/AddrParam.java
Unescape View File

@ -12,52 +12,51 @@ package com.yami.shop.bean.app.param;
import javax.validation.constraints.NotNull; import javax.validation.constraints.NotNull;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
@ApiModel(value= "地址参数") @Schema(description = "地址参数")
public class AddrParam { public class AddrParam {
@ApiModelProperty(value = "地址ID",required=true) @Schema(description = "地址ID" ,required=true)
private Long addrId; private Long addrId;
@NotNull(message = "收货人不能为空") @NotNull(message = "收货人不能为空")
@ApiModelProperty(value = "收货人",required=true) @Schema(description = "收货人" ,required=true)
private String receiver; private String receiver;
@NotNull(message = "地址不能为空") @NotNull(message = "地址不能为空")
@ApiModelProperty(value = "地址",required=true) @Schema(description = "地址" ,required=true)
private String addr; private String addr;
@ApiModelProperty(value = "邮编",required=false) @Schema(description = "邮编" ,required=false)
private String postCode; private String postCode;
@NotNull(message = "手机不能为空") @NotNull(message = "手机不能为空")
@ApiModelProperty(value = "手机",required=true) @Schema(description = "手机" ,required=true)
private String mobile; private String mobile;
@NotNull(message = "省ID不能为空") @NotNull(message = "省ID不能为空")
@ApiModelProperty(value = "省ID",required=true) @Schema(description = "省ID" ,required=true)
private Long provinceId; private Long provinceId;
@NotNull(message = "城市ID不能为空") @NotNull(message = "城市ID不能为空")
@ApiModelProperty(value = "城市ID",required=true) @Schema(description = "城市ID" ,required=true)
private Long cityId; private Long cityId;
@NotNull(message = "区ID不能为空") @NotNull(message = "区ID不能为空")
@ApiModelProperty(value = "区ID",required=true) @Schema(description = "区ID" ,required=true)
private Long areaId; private Long areaId;
@NotNull(message = "省不能为空") @NotNull(message = "省不能为空")
@ApiModelProperty(value = "省",required=true) @Schema(description = "省" ,required=true)
private String province; private String province;
@NotNull(message = "城市不能为空") @NotNull(message = "城市不能为空")
@ApiModelProperty(value = "城市",required=true) @Schema(description = "城市" ,required=true)
private String city; private String city;
@NotNull(message = "区不能为空") @NotNull(message = "区不能为空")
@ApiModelProperty(value = "区",required=true) @Schema(description = "区" ,required=true)
private String area; private String area;

14
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/ChangeShopCartParam.java
Unescape View File

@ -12,7 +12,7 @@ package com.yami.shop.bean.app.param;
import javax.validation.constraints.NotNull; import javax.validation.constraints.NotNull;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
/** /**
@ -21,25 +21,25 @@ import lombok.Data;
@Data @Data
public class ChangeShopCartParam { public class ChangeShopCartParam {
@ApiModelProperty(value = "购物车ID", required = true) @Schema(description = "购物车ID" , required = true)
private Long basketId; private Long basketId;
@NotNull(message = "商品ID不能为空") @NotNull(message = "商品ID不能为空")
@ApiModelProperty(value = "商品ID", required = true) @Schema(description = "商品ID" , required = true)
private Long prodId; private Long prodId;
@NotNull(message = "skuId不能为空") @NotNull(message = "skuId不能为空")
@ApiModelProperty(value = "skuId", required = true) @Schema(description = "skuId" , required = true)
private Long skuId; private Long skuId;
@NotNull(message = "店铺ID不能为空") @NotNull(message = "店铺ID不能为空")
@ApiModelProperty(value = "店铺ID", required = true) @Schema(description = "店铺ID" , required = true)
private Long shopId; private Long shopId;
@NotNull(message = "商品个数不能为空") @NotNull(message = "商品个数不能为空")
@ApiModelProperty(value = "商品个数", required = true) @Schema(description = "商品个数" , required = true)
private Integer count; private Integer count;
@ApiModelProperty(value = "分销推广人卡号") @Schema(description = "分销推广人卡号" )
private String distributionCardNo; private String distributionCardNo;
} }

11
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/LoginParam.java
Unescape View File

@ -10,17 +10,16 @@
package com.yami.shop.bean.app.param; package com.yami.shop.bean.app.param;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
@ApiModel(value= "登陆参数") @Schema(description = "登陆参数")
public class LoginParam { public class LoginParam {
@ApiModelProperty(value = "小程序登陆时返回的code(使用code登陆必填)",required=true) @Schema(description = "小程序登陆时返回的code(使用code登陆必填)" ,required=true)
private String code; private String code;
@ApiModelProperty(value = "登陆时的用户名(账号密码登陆必填)",required=true) @Schema(description = "登陆时的用户名(账号密码登陆必填)" ,required=true)
private String mobile; private String mobile;
@ApiModelProperty(value = "登陆时的密码(账号密码登陆必填)",required=true) @Schema(description = "登陆时的密码(账号密码登陆必填)" ,required=true)
private String password; private String password;
public String getCode() { public String getCode() {

15
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/OrderItemParam.java
Unescape View File

@ -13,31 +13,30 @@ package com.yami.shop.bean.app.param;
import javax.validation.constraints.Min; import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull; import javax.validation.constraints.NotNull;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel(value= "购物车物品参数") @Schema(description = "购物车物品参数")
public class OrderItemParam { public class OrderItemParam {
@NotNull(message = "产品ID不能为空") @NotNull(message = "产品ID不能为空")
@ApiModelProperty(value = "产品ID",required=true) @Schema(description = "产品ID" ,required=true)
private Long prodId; private Long prodId;
@NotNull(message = "skuId不能为空") @NotNull(message = "skuId不能为空")
@ApiModelProperty(value = "skuId",required=true) @Schema(description = "skuId" ,required=true)
private Long skuId; private Long skuId;
@NotNull(message = "产品数量不能为空") @NotNull(message = "产品数量不能为空")
@Min(value = 1,message = "产品数量不能为空") @Min(value = 1,message = "产品数量不能为空")
@ApiModelProperty(value = "产品数量",required=true) @Schema(description = "产品数量" ,required=true)
private Integer prodCount; private Integer prodCount;
@NotNull(message = "店铺id不能为空") @NotNull(message = "店铺id不能为空")
@ApiModelProperty(value = "店铺id",required=true) @Schema(description = "店铺id" ,required=true)
private Long shopId; private Long shopId;
@ApiModelProperty(value = "推广员使用的推销卡号") @Schema(description = "推广员使用的推销卡号" )
private String distributionCardNo; private String distributionCardNo;
} }

19
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/OrderParam.java
Unescape View File

@ -16,34 +16,33 @@ import javax.validation.constraints.NotEmpty;
import javax.validation.constraints.NotNull; import javax.validation.constraints.NotNull;
import com.yami.shop.bean.enums.OrderEntry; import com.yami.shop.bean.enums.OrderEntry;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel(value= "订单参数") @Schema(description = "订单参数")
public class OrderParam { public class OrderParam {
@ApiModelProperty(value = "购物车id 数组") @Schema(description = "购物车id 数组" )
private List<Long> basketIds; private List<Long> basketIds;
@ApiModelProperty(value = "立即购买时提交的商品项") @Schema(description = "立即购买时提交的商品项" )
private OrderItemParam orderItem; private OrderItemParam orderItem;
@ApiModelProperty(value = "地址ID，0为默认地址",required=true) @Schema(description = "地址ID，0为默认地址" ,required=true)
@NotNull(message = "地址不能为空") @NotNull(message = "地址不能为空")
private Long addrId; private Long addrId;
@ApiModelProperty(value = "用户是否改变了优惠券的选择，如果用户改变了优惠券的选择，则完全根据传入参数进行优惠券的选择") @Schema(description = "用户是否改变了优惠券的选择，如果用户改变了优惠券的选择，则完全根据传入参数进行优惠券的选择" )
private Integer userChangeCoupon; private Integer userChangeCoupon;
@ApiModelProperty(value = "优惠券id数组") @Schema(description = "优惠券id数组" )
private List<Long> couponIds; private List<Long> couponIds;
// @ApiModelProperty(value = "每次订单提交时的uuid") // @Schema(description = "每次订单提交时的uuid" )
// private String uuid; // private String uuid;
// @ApiModelProperty(value = "订单入口 SHOP_CART购物车，BUY_NOW立即购买") // @Schema(description = "订单入口 SHOP_CART购物车，BUY_NOW立即购买" )
// private OrderEntry orderEntry; // private OrderEntry orderEntry;

8
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/OrderRefundExpressParam.java
Unescape View File

@ -1,6 +1,6 @@
package com.yami.shop.bean.app.param; package com.yami.shop.bean.app.param;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotEmpty;
@ -8,15 +8,15 @@ import javax.validation.constraints.NotEmpty;
@Data @Data
public class OrderRefundExpressParam { public class OrderRefundExpressParam {
@ApiModelProperty(value = "退款编号名称", required = true) @Schema(description = "退款编号名称" , required = true)
@NotEmpty(message = "退款编号不能为空") @NotEmpty(message = "退款编号不能为空")
private String refundSn; private String refundSn;
@ApiModelProperty(value = "物流公司名称", required = true) @Schema(description = "物流公司名称" , required = true)
@NotEmpty(message = "物流公司名称不能为空") @NotEmpty(message = "物流公司名称不能为空")
private String expressName; private String expressName;
@ApiModelProperty(value = "物流单号", required = true) @Schema(description = "物流单号" , required = true)
@NotEmpty(message = "物流单号不能为空") @NotEmpty(message = "物流单号不能为空")
private String expressNo; private String expressNo;

16
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/OrderRefundParam.java
Unescape View File

@ -1,6 +1,6 @@
package com.yami.shop.bean.app.param; package com.yami.shop.bean.app.param;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotEmpty;
@ -9,30 +9,30 @@ import javax.validation.constraints.NotNull;
@Data @Data
public class OrderRefundParam { public class OrderRefundParam {
@ApiModelProperty(value = "订单编号", required = true) @Schema(description = "订单编号" , required = true)
@NotEmpty(message = "订单编号不能为空") @NotEmpty(message = "订单编号不能为空")
private String orderNumber; private String orderNumber;
@ApiModelProperty(value = "申请类型(1:仅退款 2退款退货)", required = true) @Schema(description = "申请类型(1:仅退款 2退款退货)" , required = true)
@NotNull(message = "申请类型不能为空") @NotNull(message = "申请类型不能为空")
private Integer applyType; private Integer applyType;
// @ApiModelProperty(value = "订单金额", required = true) // @Schema(description = "订单金额" , required = true)
// @NotNull(message = "订单金额不能为空") // @NotNull(message = "订单金额不能为空")
// private Double orderAmount; // private Double orderAmount;
@ApiModelProperty(value = "订单项id(全部退款是0)", required = true) @Schema(description = "订单项id(全部退款是0)" , required = true)
@NotNull(message = "订单项id不能为空") @NotNull(message = "订单项id不能为空")
private Long orderItemId; private Long orderItemId;
// @ApiModelProperty(value = "退款金额", required = true) // @Schema(description = "退款金额" , required = true)
// @NotNull(message = "退款金额不能为空") // @NotNull(message = "退款金额不能为空")
// private BigDecimal refundAmount; // private BigDecimal refundAmount;
@ApiModelProperty(value = "凭证图片列表", required = true) @Schema(description = "凭证图片列表" , required = true)
private String photoFiles; private String photoFiles;
@ApiModelProperty(value = "申请原因", required = true) @Schema(description = "申请原因" , required = true)
@NotEmpty(message = "订单编号不能为空") @NotEmpty(message = "订单编号不能为空")
private String buyerMsg; private String buyerMsg;

6
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/OrderShopParam.java
Unescape View File

@ -10,18 +10,18 @@
package com.yami.shop.bean.app.param; package com.yami.shop.bean.app.param;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
public class OrderShopParam { public class OrderShopParam {
/** 店铺ID **/ /** 店铺ID **/
@ApiModelProperty(value = "店铺id",required=true) @Schema(description = "店铺id" ,required=true)
private Long shopId; private Long shopId;
/** /**
* 订单备注信息 * 订单备注信息
*/ */
@ApiModelProperty(value = "订单备注信息",required=true) @Schema(description = "订单备注信息" ,required=true)
private String remarks; private String remarks;
public Long getShopId() { public Long getShopId() {

9
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/PayParam.java
Unescape View File

@ -13,24 +13,23 @@ package com.yami.shop.bean.app.param;
import javax.validation.constraints.NotBlank; import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull; import javax.validation.constraints.NotNull;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
@ApiModel(value= "支付参数") @Schema(description = "支付参数")
public class PayParam { public class PayParam {
/** /**
* 订单号 * 订单号
*/ */
@NotBlank(message="订单号不能为空") @NotBlank(message="订单号不能为空")
@ApiModelProperty(value = "订单号",required=true) @Schema(description = "订单号" ,required=true)
private String orderNumbers; private String orderNumbers;
/** /**
* 支付方式 * 支付方式
*/ */
@NotNull(message="支付方式不能为空") @NotNull(message="支付方式不能为空")
@ApiModelProperty(value = "支付方式 (1:微信支付 2:支付宝)",required=true) @Schema(description = "支付方式 (1:微信支付 2:支付宝)" ,required=true)
private Integer payType; private Integer payType;
public Integer getPayType() { public Integer getPayType() {

19
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/ProdCommParam.java
Unescape View File

@ -12,48 +12,47 @@ package com.yami.shop.bean.app.param;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import javax.validation.constraints.NotNull; import javax.validation.constraints.NotNull;
import java.util.List; import java.util.List;
@Data @Data
@ApiModel(value= "添加评论信息") @Schema(description = "添加评论信息")
public class ProdCommParam { public class ProdCommParam {
/** /**
* 商品ID * 商品ID
*/ */
@ApiModelProperty(value = "商品id") @Schema(description = "商品id" )
private Long prodId; private Long prodId;
/** /**
* 订单项ID * 订单项ID
*/ */
@ApiModelProperty(value = "订单项ID") @Schema(description = "订单项ID" )
private Long orderItemId; private Long orderItemId;
/** /**
* 评价，0-5分 * 评价，0-5分
*/ */
@ApiModelProperty(value = "评价，0-5分",required=true) @Schema(description = "评价，0-5分" ,required=true)
@NotNull(message = "评价不能为空") @NotNull(message = "评价不能为空")
private Integer score; private Integer score;
@ApiModelProperty(value = "评论内容",required=true) @Schema(description = "评论内容" ,required=true)
private String content; private String content;
@ApiModelProperty(value = "评论图片, 用逗号分隔") @Schema(description = "评论图片, 用逗号分隔" )
private String pics; private String pics;
/** /**
* 是否匿名(1:是 0:否) * 是否匿名(1:是 0:否)
*/ */
@ApiModelProperty(value = "是否匿名(1:是 0:否) 默认为否") @Schema(description = "是否匿名(1:是 0:否) 默认为否" )
private Integer isAnonymous; private Integer isAnonymous;
@ApiModelProperty(value = "* 评价(0好评 1中评 2差评)") @Schema(description = "* 评价(0好评 1中评 2差评)" )
private Integer evaluate; private Integer evaluate;
} }

7
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/SendSmsParam.java
Unescape View File

@ -12,13 +12,12 @@ package com.yami.shop.bean.app.param;
import javax.validation.constraints.Pattern; import javax.validation.constraints.Pattern;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
@ApiModel(value= "发送验证码参数") @Schema(description = "发送验证码参数")
public class SendSmsParam { public class SendSmsParam {
@ApiModelProperty(value = "手机号") @Schema(description = "手机号" )
@Pattern(regexp="1[0-9]{10}",message = "请输入正确的手机号") @Pattern(regexp="1[0-9]{10}",message = "请输入正确的手机号")
private String mobile; private String mobile;

9
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/ShopCartParam.java
Unescape View File

@ -10,17 +10,16 @@
package com.yami.shop.bean.app.param; package com.yami.shop.bean.app.param;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@ApiModel(value= "购物车参数") @Schema(description = "购物车参数")
@Data @Data
public class ShopCartParam { public class ShopCartParam {
@ApiModelProperty(value = "购物项id") @Schema(description = "购物项id" )
private Long basketId; private Long basketId;
@ApiModelProperty(value = "活动id,传0则不参与该活动") @Schema(description = "活动id,传0则不参与该活动" )
private Long discountId; private Long discountId;
} }

7
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/SubmitOrderParam.java
Unescape View File

@ -12,13 +12,12 @@ package com.yami.shop.bean.app.param;
import java.util.List; import java.util.List;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel(value= "提交订单参数") @Schema(description = "提交订单参数")
public class SubmitOrderParam { public class SubmitOrderParam {
@ApiModelProperty(value = "每个店铺提交的订单信息",required=true) @Schema(description = "每个店铺提交的订单信息" ,required=true)
private List<OrderShopParam> orderShopParam; private List<OrderShopParam> orderShopParam;
} }

9
yami-shop-bean/src/main/java/com/yami/shop/bean/app/param/UserInfoParam.java
Unescape View File

@ -10,18 +10,17 @@
package com.yami.shop.bean.app.param; package com.yami.shop.bean.app.param;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel(value= "设置用户信息") @Schema(description = "设置用户信息")
public class UserInfoParam { public class UserInfoParam {
@ApiModelProperty(value = "用户昵称") @Schema(description = "用户昵称" )
private String nickName; private String nickName;
@ApiModelProperty(value = "用户头像") @Schema(description = "用户头像" )
private String avatarUrl; private String avatarUrl;
} }

11
yami-shop-bean/src/main/java/com/yami/shop/bean/dto/HotSearchDto.java
Unescape View File

@ -11,23 +11,22 @@
package com.yami.shop.bean.dto; package com.yami.shop.bean.dto;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import java.io.Serializable; import java.io.Serializable;
@ApiModel("热搜数据") @Schema(description = "热搜数据")
@Data @Data
public class HotSearchDto implements Serializable { public class HotSearchDto implements Serializable {
@ApiModelProperty("热搜id") @Schema(description = "热搜id" )
private Long hotSearchId; private Long hotSearchId;
@ApiModelProperty("标题") @Schema(description = "标题" )
private String title; private String title;
@ApiModelProperty("内容") @Schema(description = "内容" )
private String content; private String content;
} }

19
yami-shop-bean/src/main/java/com/yami/shop/bean/dto/SearchProdDto.java
Unescape View File

@ -12,35 +12,34 @@ package com.yami.shop.bean.dto;
import com.fasterxml.jackson.databind.annotation.JsonSerialize; import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yami.shop.common.serializer.json.ImgJsonSerializer; import com.yami.shop.common.serializer.json.ImgJsonSerializer;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
@Data @Data
@ApiModel("搜索商品数据") @Schema(description = "搜索商品数据")
public class SearchProdDto { public class SearchProdDto {
@ApiModelProperty(value = "商品id") @Schema(description = "商品id" )
private Long prodId; private Long prodId;
@ApiModelProperty(value = "商品照片") @Schema(description = "商品照片" )
@JsonSerialize(using = ImgJsonSerializer.class) @JsonSerialize(using = ImgJsonSerializer.class)
private String pic; private String pic;
@ApiModelProperty(value = "商品名字") @Schema(description = "商品名字" )
private String prodName; private String prodName;
@ApiModelProperty(value = "商品价格") @Schema(description = "商品价格" )
private Double price; private Double price;
@ApiModelProperty(value = "商品评论数量") @Schema(description = "商品评论数量" )
private Integer prodCommNumber; private Integer prodCommNumber;
@ApiModelProperty(value = "好评率") @Schema(description = "好评率" )
private Double positiveRating; private Double positiveRating;
@ApiModelProperty(value = "好评数量") @Schema(description = "好评数量" )
private Integer praiseNumber; private Integer praiseNumber;
} }

10
yami-shop-bean/src/main/java/com/yami/shop/bean/model/Area.java
Unescape View File

@ -15,7 +15,7 @@ import java.util.List;
import com.baomidou.mybatisplus.annotation.*; import com.baomidou.mybatisplus.annotation.*;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
@ -23,16 +23,16 @@ import lombok.Data;
public class Area implements Serializable { public class Area implements Serializable {
private static final long serialVersionUID = -6013320537436191451L; private static final long serialVersionUID = -6013320537436191451L;
@TableId @TableId
@ApiModelProperty(value = "地区id",required=true) @Schema(description = "地区id" ,required=true)
private Long areaId; private Long areaId;
@ApiModelProperty(value = "地区名称",required=true) @Schema(description = "地区名称" ,required=true)
private String areaName; private String areaName;
@ApiModelProperty(value = "地区上级id",required=true) @Schema(description = "地区上级id" ,required=true)
private Long parentId; private Long parentId;
@ApiModelProperty(value = "地区层级",required=true) @Schema(description = "地区层级" ,required=true)
private Integer level; private Integer level;
@TableField(exist=false) @TableField(exist=false)

16
yami-shop-bean/src/main/java/com/yami/shop/bean/model/Transfee.java
Unescape View File

@ -15,7 +15,7 @@ import java.util.List;
import com.baomidou.mybatisplus.annotation.*; import com.baomidou.mybatisplus.annotation.*;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
@ -26,46 +26,46 @@ public class Transfee implements Serializable {
* 运费项id * 运费项id
*/ */
@TableId @TableId
@ApiModelProperty(value = "运费项id",required=true) @Schema(description = "运费项id" ,required=true)
private Long transfeeId; private Long transfeeId;
/** /**
* 运费模板id * 运费模板id
*/ */
@ApiModelProperty(value = "运费模板id",required=true) @Schema(description = "运费模板id" ,required=true)
private Long transportId; private Long transportId;
/** /**
* 续件数量 * 续件数量
*/ */
@ApiModelProperty(value = "续件数量",required=true) @Schema(description = "续件数量" ,required=true)
private Double continuousPiece; private Double continuousPiece;
/** /**
* 首件数量 * 首件数量
*/ */
@ApiModelProperty(value = "首件数量",required=true) @Schema(description = "首件数量" ,required=true)
private Double firstPiece; private Double firstPiece;
/** /**
* 续件费用 * 续件费用
*/ */
@ApiModelProperty(value = "续件费用",required=true) @Schema(description = "续件费用" ,required=true)
private Double continuousFee; private Double continuousFee;
/** /**
* 首件费用 * 首件费用
*/ */
@ApiModelProperty(value = "首件费用",required=true) @Schema(description = "首件费用" ,required=true)
private Double firstFee; private Double firstFee;
@TableField(exist=false) @TableField(exist=false)
@ApiModelProperty(value = "指定条件运费城市项",required=true) @Schema(description = "指定条件运费城市项" ,required=true)
private List<Area> cityList; private List<Area> cityList;
} }

14
yami-shop-bean/src/main/java/com/yami/shop/bean/model/TransfeeFree.java
Unescape View File

@ -16,7 +16,7 @@ import java.util.List;
import com.baomidou.mybatisplus.annotation.TableField; import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName; import com.baomidou.mybatisplus.annotation.TableName;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
@Data @Data
@ -27,39 +27,39 @@ public class TransfeeFree implements Serializable {
* 指定条件包邮项id * 指定条件包邮项id
*/ */
@TableId @TableId
@ApiModelProperty(value = "指定条件包邮项id",required=true) @Schema(description = "指定条件包邮项id" ,required=true)
private Long transfeeFreeId; private Long transfeeFreeId;
/** /**
* 运费模板id * 运费模板id
*/ */
@ApiModelProperty(value = "运费模板id",required=true) @Schema(description = "运费模板id" ,required=true)
private Long transportId; private Long transportId;
/** /**
* 包邮方式 （0 满x件/重量/体积包邮 1满金额包邮 2满x件/重量/体积且满金额包邮） * 包邮方式 （0 满x件/重量/体积包邮 1满金额包邮 2满x件/重量/体积且满金额包邮）
*/ */
@ApiModelProperty(value = "包邮方式 （0 满x件/重量/体积包邮 1满金额包邮 2满x件/重量/体积且满金额包邮）",required=true) @Schema(description = "包邮方式 （0 满x件/重量/体积包邮 1满金额包邮 2满x件/重量/体积且满金额包邮）" ,required=true)
private Integer freeType; private Integer freeType;
/** /**
* 需满金额 * 需满金额
*/ */
@ApiModelProperty(value = "需满金额",required=true) @Schema(description = "需满金额" ,required=true)
private Double amount; private Double amount;
/** /**
* 包邮x件/重量/体积 * 包邮x件/重量/体积
*/ */
@ApiModelProperty(value = "包邮x件/重量/体积",required=true) @Schema(description = "包邮x件/重量/体积" ,required=true)
private Double piece; private Double piece;
/** /**
* 指定条件包邮城市项 * 指定条件包邮城市项
*/ */
@TableField(exist=false) @TableField(exist=false)
@ApiModelProperty(value = "指定条件包邮城市项",required=true) @Schema(description = "指定条件包邮城市项" ,required=true)
private List<Area> freeCityList; private List<Area> freeCityList;
} }

20
yami-shop-bean/src/main/java/com/yami/shop/bean/model/Transport.java
Unescape View File

@ -21,7 +21,7 @@ import org.springframework.format.annotation.DateTimeFormat;
import com.fasterxml.jackson.annotation.JsonFormat; import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
@Data @Data
@TableName("tz_transport") @TableName("tz_transport")
@ -31,14 +31,14 @@ public class Transport implements Serializable {
* 运费模板id * 运费模板id
*/ */
@TableId @TableId
@ApiModelProperty(value = "运费模板id",required=true) @Schema(description = "运费模板id" ,required=true)
private Long transportId; private Long transportId;
/** /**
* 运费模板名称 * 运费模板名称
*/ */
@ApiModelProperty(value = "运费模板名称",required=true) @Schema(description = "运费模板名称" ,required=true)
private String transName; private String transName;
/** /**
@ -46,48 +46,48 @@ public class Transport implements Serializable {
*/ */
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
@ApiModelProperty(value = "创建时间",required=true) @Schema(description = "创建时间" ,required=true)
private Date createTime; private Date createTime;
/** /**
* 店铺id * 店铺id
*/ */
@ApiModelProperty(value = "店铺id",required=true) @Schema(description = "店铺id" ,required=true)
private Long shopId; private Long shopId;
/** /**
* 参考 TransportChargeType * 参考 TransportChargeType
* 收费方式（0 按件数,1 按重量 2 按体积） * 收费方式（0 按件数,1 按重量 2 按体积）
*/ */
@ApiModelProperty(value = "收费方式（0 按件数,1 按重量 2 按体积）",required=true) @Schema(description = "收费方式（0 按件数,1 按重量 2 按体积）" ,required=true)
private Integer chargeType; private Integer chargeType;
/** /**
* 是否包邮 0:不包邮 1:包邮 * 是否包邮 0:不包邮 1:包邮
*/ */
@ApiModelProperty(value = "是否包邮 0:不包邮 1:包邮",required=true) @Schema(description = "是否包邮 0:不包邮 1:包邮" ,required=true)
private Integer isFreeFee; private Integer isFreeFee;
/** /**
* 是否含有包邮条件 * 是否含有包邮条件
*/ */
@ApiModelProperty(value = "是否含有包邮条件",required=true) @Schema(description = "是否含有包邮条件" ,required=true)
private Integer hasFreeCondition; private Integer hasFreeCondition;
/** /**
* 指定条件包邮项 * 指定条件包邮项
*/ */
@TableField(exist=false) @TableField(exist=false)
@ApiModelProperty(value = "指定条件包邮项",required=true) @Schema(description = "指定条件包邮项" ,required=true)
private List<TransfeeFree> transfeeFrees; private List<TransfeeFree> transfeeFrees;
/** /**
* 运费项 * 运费项
*/ */
@TableField(exist=false) @TableField(exist=false)
@ApiModelProperty(value = "运费项",required=true) @Schema(description = "运费项" ,required=true)
private List<Transfee> transfees; private List<Transfee> transfees;
} }

8
yami-shop-bean/src/main/java/com/yami/shop/bean/param/DeliveryOrderParam.java
Unescape View File

@ -12,20 +12,20 @@ package com.yami.shop.bean.param;
import javax.validation.constraints.NotBlank; import javax.validation.constraints.NotBlank;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
public class DeliveryOrderParam { public class DeliveryOrderParam {
@NotBlank(message="订单号不能为空") @NotBlank(message="订单号不能为空")
@ApiModelProperty(value = "订单号",required=true) @Schema(description = "订单号" ,required=true)
private String orderNumber; private String orderNumber;
@NotBlank(message="快递公司id不能为空") @NotBlank(message="快递公司id不能为空")
@ApiModelProperty(value = "快递公司",required=true) @Schema(description = "快递公司" ,required=true)
private Long dvyId; private Long dvyId;
@NotBlank(message="物流单号不能为空") @NotBlank(message="物流单号不能为空")
@ApiModelProperty(value = "物流单号",required=true) @Schema(description = "物流单号" ,required=true)
private String dvyFlowId; private String dvyFlowId;

23
yami-shop-bean/src/main/java/com/yami/shop/bean/param/UserRegisterParam.java
Unescape View File

@ -10,41 +10,40 @@
package com.yami.shop.bean.param; package com.yami.shop.bean.param;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
/** /**
* @author lh * @author lh
*/ */
@Data @Data
@ApiModel(value= "设置用户信息") @Schema(description = "设置用户信息")
public class UserRegisterParam { public class UserRegisterParam {
@ApiModelProperty(value = "密码") @Schema(description = "密码" )
private String passWord; private String passWord;
@ApiModelProperty(value = "邮箱") @Schema(description = "邮箱" )
private String userMail; private String userMail;
@ApiModelProperty(value = "昵称") @Schema(description = "昵称" )
private String nickName; private String nickName;
@ApiModelProperty(value = "用户名") @Schema(description = "用户名" )
private String userName; private String userName;
@ApiModelProperty(value = "手机号") @Schema(description = "手机号" )
private String mobile; private String mobile;
@ApiModelProperty(value = "头像") @Schema(description = "头像" )
private String img; private String img;
@ApiModelProperty(value = "校验登陆注册验证码成功的标识") @Schema(description = "校验登陆注册验证码成功的标识" )
private String checkRegisterSmsFlag; private String checkRegisterSmsFlag;
@ApiModelProperty(value = "当账户未绑定时，临时的uid") @Schema(description = "当账户未绑定时，临时的uid" )
private String tempUid; private String tempUid;
@ApiModelProperty(value = "用户id") @Schema(description = "用户id" )
private Long userId; private Long userId;
} }

102
yami-shop-common/src/main/java/com/yami/shop/common/config/Swagger2Config.java
Unescape View File

@ -1,17 +1,29 @@
package com.yami.shop.common.config; package com.yami.shop.common.config;
import org.springframework.beans.BeansException; import cn.hutool.core.util.StrUtil;
import org.springframework.beans.factory.config.BeanPostProcessor; import com.fasterxml.jackson.annotation.JsonIgnore;
import com.yami.shop.common.util.PageParam;
import io.swagger.v3.oas.annotations.Hidden;
import org.apache.commons.lang3.reflect.FieldUtils;
import org.springdoc.api.annotations.ParameterObject;
import org.springdoc.core.DelegatingMethodParameter;
import org.springdoc.core.GenericParameterService;
import org.springdoc.core.PropertyResolverUtils;
import org.springdoc.core.SpringDocUtils;
import org.springdoc.core.customizers.DelegatingMethodParameterCustomizer;
import org.springdoc.core.providers.ObjectMapperProvider;
import org.springdoc.core.providers.WebConversionServiceProvider;
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Configuration;
import org.springframework.util.ReflectionUtils; import org.springframework.core.MethodParameter;
import org.springframework.web.servlet.mvc.method.RequestMappingInfoHandlerMapping;
import springfox.documentation.spring.web.plugins.WebFluxRequestHandlerProvider;
import springfox.documentation.spring.web.plugins.WebMvcRequestHandlerProvider;
import java.lang.annotation.Annotation;
import java.lang.reflect.Field; import java.lang.reflect.Field;
import java.util.Arrays;
import java.util.List; import java.util.List;
import java.util.Optional;
import java.util.stream.Collectors; import java.util.stream.Collectors;
import java.util.stream.Stream;
/** /**
* @author FrozenWatermelon * @author FrozenWatermelon
@ -20,36 +32,68 @@ import java.util.stream.Collectors;
@Configuration @Configuration
public class Swagger2Config { public class Swagger2Config {
static {
SpringDocUtils.getConfig().addAnnotationsToIgnore(JsonIgnore.class);
}
@Bean @Bean
public static BeanPostProcessor springfoxHandlerProviderBeanPostProcessor() { public GenericParameterService parameterBuilder(PropertyResolverUtils propertyResolverUtils, Optional<WebConversionServiceProvider> optionalWebConversionServiceProvider, ObjectMapperProvider objectMapperProvider) {
return new BeanPostProcessor() { return new GenericParameterService(propertyResolverUtils, delegatingMethodParameterCustomizer(),
optionalWebConversionServiceProvider,objectMapperProvider);
}
@Override // 解决@ParameterObject和@Hidden, JsonIgnore同时使用不生效的问题
public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException { private Optional<DelegatingMethodParameterCustomizer> delegatingMethodParameterCustomizer() { // NOSONAR
if (bean instanceof WebMvcRequestHandlerProvider || bean instanceof WebFluxRequestHandlerProvider) { return Optional.of((originalMethodParam, methodParam) -> {
customizeSpringfoxHandlerMappings(getHandlerMappings(bean)); // 这个方法类拥有的注解
} Annotation[] annotations = originalMethodParam.getParameterType().getAnnotations();
return bean; boolean typeContainParameterObject = false;
if (annotations.length > 0) {
List<? extends Class<? extends Annotation>> annotationTypes = Arrays.stream(annotations).map(Annotation::annotationType).collect(Collectors.toList());
typeContainParameterObject = annotationTypes.contains(ParameterObject.class);
} }
private <T extends RequestMappingInfoHandlerMapping> void customizeSpringfoxHandlerMappings(List<T> mappings) {
List<T> copy = mappings.stream()
.filter(mapping -> mapping.getPatternParser() == null)
.collect(Collectors.toList());
mappings.clear();
mappings.addAll(copy);
}
@SuppressWarnings("unchecked") if (typeContainParameterObject
private List<RequestMappingInfoHandlerMapping> getHandlerMappings(Object bean) { || (originalMethodParam.hasParameterAnnotations() && originalMethodParam.hasParameterAnnotation(ParameterObject.class))) {
try { try {
Field field = ReflectionUtils.findField(bean.getClass(), "handlerMappings"); if (isParameterIgnore(originalMethodParam, methodParam)) {
field.setAccessible(true); Field field = FieldUtils.getDeclaredField(DelegatingMethodParameter.class, "additionalParameterAnnotations", true);
return (List<RequestMappingInfoHandlerMapping>) field.get(bean); try {
} catch (IllegalArgumentException | IllegalAccessException e) { field.set(methodParam, new Annotation[] {new Hidden() { // NOSONAR
throw new IllegalStateException(e); @Override
public Class<? extends Annotation> annotationType() {
return Hidden.class;
}}
});
} catch (IllegalArgumentException|IllegalAccessException e) {
e.printStackTrace();
}
}
} catch (NoSuchFieldException | SecurityException e) {
e.printStackTrace();
} }
} }
}; });
}
private boolean isParameterIgnore(MethodParameter originalMethodParam, MethodParameter methodParam) throws NoSuchFieldException, SecurityException {
String parameterName = StrUtil.isBlank(methodParam.getParameterName())? "":methodParam.getParameterName();
String fieldName = parameterName.indexOf('.') == -1 ? parameterName : parameterName.substring(0, parameterName.indexOf('.'));
// 解决mybatis-plus返回的查询参数污染的问题
if (originalMethodParam.getParameterType().isAssignableFrom(PageParam.class)) {
if ("searchCount".equals(fieldName)) {
return true;
}
}
Field declaredField;
try {
declaredField = originalMethodParam.getParameterType().getDeclaredField(fieldName);
} catch (NoSuchFieldException e) {
e.printStackTrace();
declaredField = originalMethodParam.getParameterType().getSuperclass().getDeclaredField(fieldName);
}
return Stream.of(declaredField.getAnnotations())
.filter(annot -> Arrays.asList(Hidden.class, JsonIgnore.class).contains(annot.annotationType())).count() > 0;
} }
} }

33
yami-shop-common/src/main/java/com/yami/shop/common/serializer/springfox/SpringFoxJsonSerializerConfig.java
Unescape View File

@ -1,33 +0,0 @@
/*
* Copyright (c) 2018-2999 广州市蓝海创新科技有限公司 All rights reserved.
*
* https://www.mall4j.com/
*
* 未经允许，不可做商业用途！
*
* 版权所有，侵权必究！
*/
package com.yami.shop.common.serializer.springfox;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Primary;
import springfox.documentation.spring.web.json.JacksonModuleRegistrar;
import springfox.documentation.spring.web.json.JsonSerializer;
import java.util.List;
/**
* @author LGH
*/
@Configuration
public class SpringFoxJsonSerializerConfig {
@Bean
@Primary
public JsonSerializer yamiSpringfoxJsonSerializer(List<JacksonModuleRegistrar> moduleRegistrars) {
return new SpringfoxJsonSerializer(moduleRegistrars);
}
}

53
yami-shop-common/src/main/java/com/yami/shop/common/serializer/springfox/SpringfoxJsonSerializer.java
Unescape View File

@ -1,53 +0,0 @@
/*
* Copyright (c) 2018-2999 广州市蓝海创新科技有限公司 All rights reserved.
*
* https://www.mall4j.com/
*
* 未经允许，不可做商业用途！
*
* 版权所有，侵权必究！
*/
package com.yami.shop.common.serializer.springfox;
import io.swagger.models.Operation;
import io.swagger.models.Swagger;
import io.swagger.models.parameters.Parameter;
import springfox.documentation.spring.web.json.JacksonModuleRegistrar;
import springfox.documentation.spring.web.json.Json;
import springfox.documentation.spring.web.json.JsonSerializer;
import java.util.List;
/**
* 自定义Swagger 的序列化，去除分页参数中的records值
* @author LGH
*/
public class SpringfoxJsonSerializer extends JsonSerializer {
public SpringfoxJsonSerializer(List<JacksonModuleRegistrar> modules) {
super(modules);
}
@Override
public Json toJson(Object toSerialize) {
if (!(toSerialize instanceof Swagger)) {
return super.toJson(toSerialize);
}
Swagger swagger = (Swagger)toSerialize;
swagger.getPaths().forEach((key, path) ->{
Operation get = path.getGet();
if (get != null) {
List<Parameter> parameters = get.getParameters();
if (parameters != null) {
parameters.removeIf(parameter -> parameter.getName().startsWith("records[0]."));
}
}
});
return super.toJson(swagger);
// return super.toJson(toSerialize);
}
}

73
yami-shop-common/src/main/java/com/yami/shop/common/util/PageParam.java
Unescape View File

@ -11,42 +11,56 @@
package com.yami.shop.common.util; package com.yami.shop.common.util;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import io.swagger.annotations.ApiParam; import com.fasterxml.jackson.annotation.JsonIgnore;
import io.swagger.v3.oas.annotations.Hidden;
import io.swagger.v3.oas.annotations.media.Schema;
import org.springdoc.api.annotations.ParameterObject;
import java.util.Collections;
import java.util.List; import java.util.List;
@Schema
@ParameterObject
public class PageParam<T> extends Page<T> { public class PageParam<T> extends Page<T> {
/**
* 查询数据列表
*/
@ApiParam(hidden = true)
private List<T> records;
/**
* 总数
*/
@ApiParam(hidden = true)
private long total = 0;
/** /**
* 每页显示条数，默认 10 * 每页显示条数，默认 10
*/ */
@ApiParam(value = "每页大小，默认10",required = false, defaultValue = "10") @Schema(description = "每页大小，默认10")
private long size = 10; private long size = 10;
/** /**
* 当前页 * 当前页
*/ */
@ApiParam(value = "当前页，默认1",required = false,defaultValue = "1") @Schema(description = "当前页，默认1")
private long current = 1; private long current = 1;
/**
* 查询数据列表
*/
@Hidden
private List<T> records;
/**
* 总数
*/
@Hidden
private long total = 0;
/** /**
* 是否进行 count 查询 * 是否进行 count 查询
*/ */
@ApiParam(hidden = true) @JsonIgnore
private boolean isSearchCount = true; private boolean isSearchCount = true;
@JsonIgnore
private String countId;
@JsonIgnore
private Long maxLimit;
@JsonIgnore
private boolean optimizeCountSql;
@Override @Override
@ApiParam(hidden = true)
public List<T> getRecords() { public List<T> getRecords() {
return this.records; return this.records;
} }
@ -68,7 +82,7 @@ public class PageParam<T> extends Page<T> {
return this; return this;
} }
@ApiParam(hidden = true) @JsonIgnore
public boolean getSearchCount() { public boolean getSearchCount() {
if (total < 0) { if (total < 0) {
return false; return false;
@ -77,7 +91,6 @@ public class PageParam<T> extends Page<T> {
} }
@Override @Override
@ApiParam(hidden = true)
public boolean isSearchCount() { public boolean isSearchCount() {
if (total < 0) { if (total < 0) {
return false; return false;
@ -98,7 +111,11 @@ public class PageParam<T> extends Page<T> {
@Override @Override
public Page<T> setSize(long size) { public Page<T> setSize(long size) {
this.size = size; if (size > 100) {
this.size = 100;
} else {
this.size = size;
}
return this; return this;
} }
@ -112,4 +129,24 @@ public class PageParam<T> extends Page<T> {
this.current = current; this.current = current;
return this; return this;
} }
/** @deprecated */
@Deprecated
public String getCountId() {
return this.countId;
}
/** @deprecated */
@Deprecated
public Long getMaxLimit() {
return this.maxLimit;
}
/** @deprecated */
@Deprecated
public boolean isOptimizeCountSql() {
return this.optimizeCountSql;
}
} }

2
yami-shop-security/yami-shop-security-admin/src/main/java/com/yami/shop/security/admin/adapter/ResourceServerAdapter.java
Unescape View File

@ -15,7 +15,7 @@ public class ResourceServerAdapter extends DefaultAuthConfigAdapter {
public static final List<String> EXCLUDE_PATH = Arrays.asList( public static final List<String> EXCLUDE_PATH = Arrays.asList(
"/webjars/**", "/webjars/**",
"/swagger/**", "/swagger/**",
"/v2/api-docs", "/v3/api-docs/**",
"/doc.html", "/doc.html",
"/swagger-ui.html", "/swagger-ui.html",
"/swagger-resources/**", "/swagger-resources/**",

4
yami-shop-security/yami-shop-security-admin/src/main/java/com/yami/shop/security/admin/dto/CaptchaAuthenticationDTO.java
Unescape View File

@ -1,7 +1,7 @@
package com.yami.shop.security.admin.dto; package com.yami.shop.security.admin.dto;
import com.yami.shop.security.common.dto.AuthenticationDTO; import com.yami.shop.security.common.dto.AuthenticationDTO;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
/** /**
@ -12,6 +12,6 @@ import lombok.Data;
@Data @Data
public class CaptchaAuthenticationDTO extends AuthenticationDTO { public class CaptchaAuthenticationDTO extends AuthenticationDTO {
@ApiModelProperty(value = "验证码", required = true) @Schema(description = "验证码" , required = true)
private String captchaVerification; private String captchaVerification;
} }

8
yami-shop-security/yami-shop-security-api/src/main/java/com/yami/shop/security/api/controller/LoginController.java
Unescape View File

@ -12,8 +12,8 @@ import com.yami.shop.security.common.manager.PasswordCheckManager;
import com.yami.shop.security.common.manager.PasswordManager; import com.yami.shop.security.common.manager.PasswordManager;
import com.yami.shop.security.common.manager.TokenStore; import com.yami.shop.security.common.manager.TokenStore;
import com.yami.shop.security.common.vo.TokenInfoVO; import com.yami.shop.security.common.vo.TokenInfoVO;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.PostMapping;
@ -27,7 +27,7 @@ import javax.validation.Valid;
* @date 2022/3/28 15:20 * @date 2022/3/28 15:20
*/ */
@RestController @RestController
@Api(tags = "登录") @Tag(name = "登录")
public class LoginController { public class LoginController {
@Autowired @Autowired
private TokenStore tokenStore; private TokenStore tokenStore;
@ -42,7 +42,7 @@ public class LoginController {
private PasswordManager passwordManager; private PasswordManager passwordManager;
@PostMapping("/login") @PostMapping("/login")
@ApiOperation(value = "账号密码(用于前端登录)", notes = "通过账号/手机号/用户名密码登录，还要携带用户的类型，也就是用户所在的系统") @Operation(summary = "账号密码(用于前端登录)" , description = "通过账号/手机号/用户名密码登录，还要携带用户的类型，也就是用户所在的系统")
public ResponseEntity<TokenInfoVO> login( public ResponseEntity<TokenInfoVO> login(
@Valid @RequestBody AuthenticationDTO authenticationDTO) { @Valid @RequestBody AuthenticationDTO authenticationDTO) {
String mobileOrUserName = authenticationDTO.getUserName(); String mobileOrUserName = authenticationDTO.getUserName();

4
yami-shop-security/yami-shop-security-common/src/main/java/com/yami/shop/security/common/controller/CaptchaController.java
Unescape View File

@ -13,7 +13,7 @@ import com.anji.captcha.model.common.RepCodeEnum;
import com.anji.captcha.model.common.ResponseModel; import com.anji.captcha.model.common.ResponseModel;
import com.anji.captcha.model.vo.CaptchaVO; import com.anji.captcha.model.vo.CaptchaVO;
import com.anji.captcha.service.CaptchaService; import com.anji.captcha.service.CaptchaService;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestBody;
@ -26,7 +26,7 @@ import org.springframework.web.bind.annotation.RestController;
*/ */
@RestController @RestController
@RequestMapping("/captcha") @RequestMapping("/captcha")
@Api(tags = "验证码") @Tag(name = "验证码")
public class CaptchaController { public class CaptchaController {
private final CaptchaService captchaService; private final CaptchaService captchaService;

8
yami-shop-security/yami-shop-security-common/src/main/java/com/yami/shop/security/common/controller/LogoutController.java
Unescape View File

@ -11,8 +11,8 @@ package com.yami.shop.security.common.controller;
import cn.hutool.core.util.StrUtil; import cn.hutool.core.util.StrUtil;
import com.yami.shop.security.common.manager.TokenStore; import com.yami.shop.security.common.manager.TokenStore;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.PostMapping;
@ -25,14 +25,14 @@ import javax.servlet.http.HttpServletRequest;
* @date 2022/3/25 17:33 * @date 2022/3/25 17:33
*/ */
@RestController @RestController
@Api(tags = "注销") @Tag(name = "注销")
public class LogoutController { public class LogoutController {
@Autowired @Autowired
private TokenStore tokenStore; private TokenStore tokenStore;
@PostMapping("/logOut") @PostMapping("/logOut")
@ApiOperation(value = "退出登陆", notes = "点击退出登陆，清除token，清除菜单缓存") @Operation(summary = "退出登陆" , description = "点击退出登陆，清除token，清除菜单缓存")
public ResponseEntity<Void> logOut(HttpServletRequest request) { public ResponseEntity<Void> logOut(HttpServletRequest request) {
String accessToken = request.getHeader("Authorization"); String accessToken = request.getHeader("Authorization");
if (StrUtil.isBlank(accessToken)) { if (StrUtil.isBlank(accessToken)) {

4
yami-shop-security/yami-shop-security-common/src/main/java/com/yami/shop/security/common/controller/TokenController.java
Unescape View File

@ -13,7 +13,7 @@ import com.yami.shop.security.common.bo.TokenInfoBO;
import com.yami.shop.security.common.dto.RefreshTokenDTO; import com.yami.shop.security.common.dto.RefreshTokenDTO;
import com.yami.shop.security.common.manager.TokenStore; import com.yami.shop.security.common.manager.TokenStore;
import com.yami.shop.security.common.vo.TokenInfoVO; import com.yami.shop.security.common.vo.TokenInfoVO;
import io.swagger.annotations.Api; import io.swagger.v3.oas.annotations.tags.Tag;
import ma.glasnost.orika.MapperFacade; import ma.glasnost.orika.MapperFacade;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
@ -28,7 +28,7 @@ import javax.validation.Valid;
* @date 2022/3/25 17:33 * @date 2022/3/25 17:33
*/ */
@RestController @RestController
@Api(tags = "token") @Tag(name = "token")
public class TokenController { public class TokenController {
@Autowired @Autowired

6
yami-shop-security/yami-shop-security-common/src/main/java/com/yami/shop/security/common/dto/AuthenticationDTO.java
Unescape View File

@ -9,7 +9,7 @@
*/ */
package com.yami.shop.security.common.dto; package com.yami.shop.security.common.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
import javax.validation.constraints.NotBlank; import javax.validation.constraints.NotBlank;
@ -27,14 +27,14 @@ public class AuthenticationDTO {
* 用户名 * 用户名
*/ */
@NotBlank(message = "userName不能为空") @NotBlank(message = "userName不能为空")
@ApiModelProperty(value = "用户名/邮箱/手机号", required = true) @Schema(description = "用户名/邮箱/手机号" , required = true)
protected String userName; protected String userName;
/** /**
* 密码 * 密码
*/ */
@NotBlank(message = "passWord不能为空") @NotBlank(message = "passWord不能为空")
@ApiModelProperty(value = "一般用作密码", required = true) @Schema(description = "一般用作密码" , required = true)
protected String passWord; protected String passWord;
} }

4
yami-shop-security/yami-shop-security-common/src/main/java/com/yami/shop/security/common/dto/RefreshTokenDTO.java
Unescape View File

@ -9,7 +9,7 @@
*/ */
package com.yami.shop.security.common.dto; package com.yami.shop.security.common.dto;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import javax.validation.constraints.NotBlank; import javax.validation.constraints.NotBlank;
@ -25,7 +25,7 @@ public class RefreshTokenDTO {
* refreshToken * refreshToken
*/ */
@NotBlank(message = "refreshToken不能为空") @NotBlank(message = "refreshToken不能为空")
@ApiModelProperty(value = "refreshToken", required = true) @Schema(description = "refreshToken" , required = true)
private String refreshToken; private String refreshToken;
public String getRefreshToken() { public String getRefreshToken() {

8
yami-shop-security/yami-shop-security-common/src/main/java/com/yami/shop/security/common/vo/TokenInfoVO.java
Unescape View File

@ -9,7 +9,7 @@
*/ */
package com.yami.shop.security.common.vo; package com.yami.shop.security.common.vo;
import io.swagger.annotations.ApiModelProperty; import io.swagger.v3.oas.annotations.media.Schema;
import lombok.Data; import lombok.Data;
/** /**
@ -21,12 +21,12 @@ import lombok.Data;
@Data @Data
public class TokenInfoVO { public class TokenInfoVO {
@ApiModelProperty("accessToken") @Schema(description = "accessToken" )
private String accessToken; private String accessToken;
@ApiModelProperty("refreshToken") @Schema(description = "refreshToken" )
private String refreshToken; private String refreshToken;
@ApiModelProperty("在多少秒后过期") @Schema(description = "在多少秒后过期" )
private Integer expiresIn; private Integer expiresIn;
} }

6
yami-shop-sys/src/main/java/com/yami/shop/sys/controller/SysMenuController.java
Unescape View File

@ -19,7 +19,7 @@ import com.yami.shop.sys.constant.Constant;
import com.yami.shop.sys.constant.MenuType; import com.yami.shop.sys.constant.MenuType;
import com.yami.shop.sys.model.SysMenu; import com.yami.shop.sys.model.SysMenu;
import com.yami.shop.sys.service.SysMenuService; import com.yami.shop.sys.service.SysMenuService;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import lombok.AllArgsConstructor; import lombok.AllArgsConstructor;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.security.access.prepost.PreAuthorize; import org.springframework.security.access.prepost.PreAuthorize;
@ -43,7 +43,7 @@ public class SysMenuController{
@GetMapping("/nav") @GetMapping("/nav")
@ApiOperation(value="获取用户所拥有的菜单和权限", notes="通过登陆用户的userId获取用户所拥有的菜单和权限") @Operation(summary = "获取用户所拥有的菜单和权限" , description = "通过登陆用户的userId获取用户所拥有的菜单和权限")
public ResponseEntity<Map<Object, Object>> nav(){ public ResponseEntity<Map<Object, Object>> nav(){
List<SysMenu> menuList = sysMenuService.listMenuByUserId(SecurityUtils.getSysUser().getUserId()); List<SysMenu> menuList = sysMenuService.listMenuByUserId(SecurityUtils.getSysUser().getUserId());
@ -64,7 +64,7 @@ public class SysMenuController{
* 所有菜单列表(用于新建、修改角色时 获取菜单的信息) * 所有菜单列表(用于新建、修改角色时 获取菜单的信息)
*/ */
@GetMapping("/list") @GetMapping("/list")
@ApiOperation(value="获取用户所拥有的菜单(不包括按钮)", notes="通过登陆用户的userId获取用户所拥有的菜单和权限") @Operation(summary = "获取用户所拥有的菜单(不包括按钮)" , description = "通过登陆用户的userId获取用户所拥有的菜单和权限")
public ResponseEntity<List<SysMenu>> list(){ public ResponseEntity<List<SysMenu>> list(){
List<SysMenu> sysMenuList= sysMenuService.listSimpleMenuNoButton(); List<SysMenu> sysMenuList= sysMenuService.listSimpleMenuNoButton();
return ResponseEntity.ok(sysMenuList); return ResponseEntity.ok(sysMenuList);

4
yami-shop-sys/src/main/java/com/yami/shop/sys/controller/SysUserController.java
Unescape View File

@ -27,7 +27,7 @@ import com.yami.shop.sys.dto.UpdatePasswordDto;
import com.yami.shop.sys.model.SysUser; import com.yami.shop.sys.model.SysUser;
import com.yami.shop.sys.service.SysRoleService; import com.yami.shop.sys.service.SysRoleService;
import com.yami.shop.sys.service.SysUserService; import com.yami.shop.sys.service.SysUserService;
import io.swagger.annotations.ApiOperation; import io.swagger.v3.oas.annotations.Operation;
import org.springframework.beans.factory.annotation.Autowired; import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.security.access.prepost.PreAuthorize; import org.springframework.security.access.prepost.PreAuthorize;
@ -81,7 +81,7 @@ public class SysUserController {
*/ */
@SysLog("修改密码") @SysLog("修改密码")
@PostMapping("/password") @PostMapping("/password")
@ApiOperation(value="修改密码", notes="修改当前登陆用户的密码") @Operation(summary = "修改密码" , description = "修改当前登陆用户的密码")
public ResponseEntity<String> password(@RequestBody @Valid UpdatePasswordDto param){ public ResponseEntity<String> password(@RequestBody @Valid UpdatePasswordDto param){
Long userId = SecurityUtils.getSysUser().getUserId(); Long userId = SecurityUtils.getSysUser().getUserId();

9
yami-shop-sys/src/main/java/com/yami/shop/sys/dto/UpdatePasswordDto.java
Unescape View File

@ -10,24 +10,23 @@
package com.yami.shop.sys.dto; package com.yami.shop.sys.dto;
import io.swagger.annotations.ApiModel; import io.swagger.v3.oas.annotations.media.Schema;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data; import lombok.Data;
import javax.validation.constraints.NotBlank; import javax.validation.constraints.NotBlank;
import javax.validation.constraints.Size; import javax.validation.constraints.Size;
@Data @Data
@ApiModel(value= "更新密码参数") @Schema(description = "更新密码参数")
public class UpdatePasswordDto { public class UpdatePasswordDto {
@NotBlank(message="旧密码不能为空") @NotBlank(message="旧密码不能为空")
@Size(max = 50) @Size(max = 50)
@ApiModelProperty(value = "旧密码",required=true) @Schema(description = "旧密码" ,required=true)
private String password; private String password;
@NotBlank(message="新密码不能为空") @NotBlank(message="新密码不能为空")
@Size(max = 50) @Size(max = 50)
@ApiModelProperty(value = "新密码",required=true) @Schema(description = "新密码" ,required=true)
private String newPassword; private String newPassword;
} }

Write Preview
Loading…
Cancel
Save