我正在使用swagger编写spring-boot-starter-data-rest项目的文档。在application.properties文件中,我配置了:spring.jackson.property-naming-strategy=SNAKE_CASE
命名策略,但不幸的是,我在swagger文档中得到了camelCase。但是,如果我将项目从spring-boot-starter-data-rest更改为spring-boot-starter-web,同样的配置也会起作用。下面是我在spring boot 2.1.1.RELEASE中使用的依赖项。
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.1.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.example</groupId>
<artifactId>demo1</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>demo1</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>2.9.2</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-rest</artifactId>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
application.properties
spring.jackson.property-naming-strategy=SNAKE_CASE
package com.example.demo1;软件包下载
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class Demo1Application {
public static void main(String[] args) {
SpringApplication.run(Demo1Application.class, args);
}
}
Swagger 配置
package com.example.demo1;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.PropertyNamingStrategy;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import
org.springframework.data.web.config.SpringDataJacksonConfiguration;
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;
import java.util.ArrayList;
@Configuration
@EnableSwagger2
@Import({SpringDataJacksonConfiguration.class})
public class SwaggerConfig {
public static ApiInfo metaData(String info) {
return new ApiInfo(info,
"Th",
"1.0", "httn.html",
new Contact("Thd", "", "thoom"), "decense",
"https", new ArrayList());
}
@Bean
public Docket cashFlowApi() {
return new Docket(DocumentationType.SWAGGER_2).groupName("-caching").select()
.apis(RequestHandlerSelectors.basePackage("com.example.demo1"))
.paths(PathSelectors.any())
.build()
.apiInfo(SwaggerConfig.metaData("BOcPI"));
}
}
存储控制器
package com.example.demo1;
import java.util.Arrays;
import java.util.List;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import io.swagger.annotations.ApiResponse;
import io.swagger.annotations.ApiResponses;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
@CrossOrigin
public class StoreController {
@GetMapping(value = "/v1/storeMap")
@ApiOperation(value = "Returns the list of stores", notes = "Returns the list of stores with pagination.")
@ApiResponses(value = {@ApiResponse(code = 200, message = "Successfully retrieved the stores list"),
@ApiResponse(code = 204, message = "No content"), @ApiResponse(code = 206, message = "Partial Content"),
@ApiResponse(code = 401, message = "You are not authorized to view the resource"),
@ApiResponse(code = 403, message = "Accessing the resource you were trying to reach is forbidden"),
@ApiResponse(code = 404, message = "The resource you were trying to reach is not found"),
@ApiResponse(code = 500, message = "A technical error happened")})
public ResponseEntity<Store> getStore(
@RequestParam(name = "country_code", required = false) @ApiParam(value = "the code)") String countryCode
) {
return ResponseEntity.ok(new Store(1,"ZZ"));
}
}
现在有了这个配置,在API POST方法中预期的是snake_case,而在文档中,swagger显示的是camelCase。我无法选择从snake_case更改为camelCase,也无法选择将spring-boot-starter-data-rest更改为spring-boot-starter-web。
3条答案
按热度按时间2ledvvac1#
我找到了解决方案,问题出在对象Map器上:
cwtwac6a2#
我还有一个Sping Boot + Swagger项目也遇到了同样的问题,但使用的是Spring的io.swagger包,而不是Springfox库,并且使用Gradle插件com.benjaminsproule.swagger来生成文档。因此,为了解决这个问题,我添加了
ModelConverters.getInstance().addConverter(new ModelResolver(objectMapper))
这一行(这是一个黑客攻击,我没有使用官方API,但它起作用了):ajsxfq5m3#
模型上的注解帮助了我。@JsonNaming(PropertyNamingStrategy.SnakeCaseStrategy.class)
https://www.baeldung.com/jackson-deserialize-snake-to-camel-case