前后端分离ssm配置swagger接口文档

之前配置过 springboot，相比 ssm 要简单很多，现在记录一下 ssm 的配置

在 pom.xml 中加入依赖

<!--swagger 本身不支持 spring mvc 的，springfox 把 swagger 包装了一下，让他可以支持 springmvc-->
    <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger2</artifactId>
      <version>2.6.1</version>
    </dependency>
    <dependency>
      <groupId>io.springfox</groupId>
      <artifactId>springfox-swagger-ui</artifactId>
      <version>2.6.1</version>
    </dependency>

添加配置类 SwaggerConfig.java

@WebAppConfiguration
@EnableSwagger2
@EnableWebMvc
@ComponentScan(basePackages = "com.maxcore.controller")
public class SwaggerConfig {


    @Bean
    public Docket customDocket() {
        //
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {Contact contact = new Contact("娜", "https://www.baidu.me", "baidu_666@icloud.com");
        return new ApiInfo("仿简书前台 API 接口",// 大标题 title
                "Swagger 测试 demo",// 小标题
                "0.0.1",// 版本
                "www.baidu.com",//termsOfServiceUrl
                contact,// 作者
                "Blog",// 链接显示文字
                "https://www.baidu.me"// 网站链接
        );
    }


}

在 dispatcher-servlet.xml(springmvc 的配置文件) 中加入如下配置

    <bean class="com.maxcore.config.SwaggerConfig" />

    <mvc:resources mapping="swagger-ui.html" location="classpath:/META-INF/resources/" />
    <mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/" />

要在 controller 层添加注解

最后启动项目，访问 swagger 接口文档的路径一定要对，不然一直报 404，你以为你没配置对，其实是你路径不对，笔者在这里表示有很痛的领悟

笔者的本地的访问路径是 http://localhost/jianShuSSM_w…

一般都是
http://ip 地址: 端口 (默认 80，不显示)/ 项目名 /swagger-ui.html

终

github

个人网站