如何在spring-boot-starter-data-rest中实现Swagger文档的snake_case?

fgw7neuy  于 2023-02-19  发布在  Spring
关注(0)|答案(3)|浏览(405)

我正在使用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。

2ledvvac

2ledvvac1#

我找到了解决方案,问题出在对象Map器上:

@Configuration
    public class ObjectMapperAutoConfiguration implements WebMvcConfigurer {

        @Override
        public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
            ObjectMapper objectMapper = null;
            for (HttpMessageConverter converter : converters) {
                if (converter instanceof MappingJackson2HttpMessageConverter ) {
                    MappingJackson2HttpMessageConverter jacksonConverter =
                            ((MappingJackson2HttpMessageConverter) converter);

                    if (objectMapper == null) {
                        objectMapper = jacksonConverter.getObjectMapper();
                    } else {
                        jacksonConverter.setObjectMapper(objectMapper);
                    }
                }
            }
        }
    }
cwtwac6a

cwtwac6a2#

我还有一个Sping Boot + Swagger项目也遇到了同样的问题,但使用的是Spring的io.swagger包,而不是Springfox库,并且使用Gradle插件com.benjaminsproule.swagger来生成文档。因此,为了解决这个问题,我添加了ModelConverters.getInstance().addConverter(new ModelResolver(objectMapper))这一行(这是一个黑客攻击,我没有使用官方API,但它起作用了):

package com.company.api;

import com.fasterxml.jackson.databind.ObjectMapper;
import io.swagger.converter.ModelConverters;
import io.swagger.jackson.ModelResolver;
import io.swagger.jaxrs.config.BeanConfig;
import io.swagger.jaxrs.listing.*;
import org.glassfish.jersey.server.ResourceConfig;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import javax.annotation.PostConstruct;

@Component
public class SwaggerConfig extends ResourceConfig {

  @Autowired ObjectMapper objectMapper;

  @PostConstruct public void configureSwagger() {
    // Available at localhost:port/swagger.json
    this.register(ApiListingResource.class);
    this.register(SwaggerSerializers.class);

    BeanConfig config = new BeanConfig();
    config.setConfigId("api-springboot-jersey-swagger");
    config.setTitle("Company API");
    config.setResourcePackage("com.company.api");
    config.setPrettyPrint(true);
    config.setScan(true);
    // With this hack we inject into Swagger the same object mapper
    // used by Spring (spring.jackson.property-naming-strategy)
    ModelConverters.getInstance().addConverter(new ModelResolver(objectMapper));
  }
}
ajsxfq5m

ajsxfq5m3#

模型上的注解帮助了我。@JsonNaming(PropertyNamingStrategy.SnakeCaseStrategy.class)
https://www.baeldung.com/jackson-deserialize-snake-to-camel-case

相关问题