Java 为什么swagger注释会生成带有默认路径前缀的api文档

我使用下面的maven插件将swagger与我的应用程序集成

我在SpringServletXML中配置了以下内容

<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>

此“默认”是“招摇过市组”的默认名称

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

通常只有一个组，名为“默认”。如果要更改它，应该在由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");
    }
...
}

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

之后，您应该在您的Swagger生成的API JSON URL中包含如下内容：

@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");
    }
...
}

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