为什么 swagger 注解会生成带有默认路径前缀的 api-docs

我使用下面的 Maven 插件将 swagger 与我的应用程序集成https://github.com/martypitt/swagger-springmvc https://github.com/martypitt/swagger-springmvc

我在 spring servlet xml 中配置了以下内容

<mvc:annotation-driven/> <!-- Required so swagger-springmvc can access spring's RequestMappingHandlerMapping  -->
<bean class="com.mangofactory.swagger.configuration.SpringSwaggerConfig" />

<mvc:default-servlet-handler/>

 <bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <property name="locations" >
            <list>

                <value>/WEB-INF/swagger.properties</value>
            </list>
        </property>
    </bean>

我的招摇属性如下所示

文档.services.basePath=http://payrollservice.com/customservice http://payrollservice.com/customservice文档.服务.版本=1.0

我生成的 api-docs.json 如下所示，我不确定为什么它没有基本路径以及为什么它有前缀“/default”

{
apiVersion: "1.0",
swaggerVersion: "1.2",
apis: [
{
path: "/default/custom-controller",
description: "backupset API"
}
],
info: {
title: "default Title",
description: "Api Description",
termsOfServiceUrl: "Api terms of service",
contact: "Contact Email",
license: "Licence Type",
licenseUrl: "License URL"
}
}

这个“default”是“swagger group”的默认名称

https://github.com/martypitt/swagger-springmvc#swagger-group https://github.com/martypitt/swagger-springmvc#swagger-group

swagger 组是该库引入的一个概念，它只是应用程序中 Swagger 资源列表的唯一标识符。引入这一概念的原因是为了支持需要多个资源列表的应用程序。

您通常只有一个组，它被命名为“default”。如果要更改它，您应该在组名称中设置SwaggerSpringMvc插件 https://github.com/martypitt/swagger-springmvc/blob/master/swagger-springmvc/src/main/java/com/mangofactory/swagger/plugin/SwaggerSpringMvcPlugin.java由您的 swagger 配置创建。像这样的事情：

@Configuration
@EnableSwagger
public class MySwaggerConfig {
    private SpringSwaggerConfig springSwaggerConfig;

    @Autowired
    public void setSpringSwaggerConfig(SpringSwaggerConfig springSwaggerConfig) {
      this.springSwaggerConfig = springSwaggerConfig;
    }


    @Bean
    public SwaggerSpringMvcPlugin customImplementation() {
      return new SwaggerSpringMvcPlugin(this.springSwaggerConfig)
            .swaggerGroup("my-group");
    }
...
}

之后，您应该在 Swagger 中生成如下 API JSON URL：

...
apis: [
{
    path: "/my-group/custom-controller",
    description: "backupset API"
}
....