2024年最全JApiDocs与Swagger对比_japidocs和swagger(3)，妈妈再也不用担心我的面试

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上Go语言开发知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新

如果你需要这些资料，可以戳这里获取

目录

序言

Swagger

JApiDocs

总结

---

序言

做过Java web开发的小伙伴都用过Swagger，开发过程中的一个小工具，虽然用起来也不麻烦，但是今天看到一篇文章说新的工具能够替代Swagger，那么自己就来实践对比一下到底新工具JApiDocs真的有那么香吗？

Swagger

官方网站：https://swagger.io/

Swagger 是一款RESTFUL接口的、基于YAML、JSON语言的文档在线自动生成、代码自动生成的工具。

这里使用的是2.9.2版本。依赖如下，

<!-- swagger -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>

做过开发的小伙伴应该特别熟了，通过@ApiModel+@ApiModelProProperty给对象进行属性注入，在访问控制层通过@Api+@ApiOperation对接口参数进行注入，如果想对swagger的界面做一些配置可以加上下面的代码，

package com.hust.zhang.web.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.validation.MessageCodesResolver;
import org.springframework.validation.Validator;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.HandlerMethodReturnValueHandler;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.config.annotation.*;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
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;
import java.util.List;

@Configuration
@EnableSwagger2
public class SwaggerConfig {

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

    private ApiInfo apiInfo() {
        // springfox.documentation.service.Contact
        Contact contact = new Contact("zhang", "https://blog.youkuaiyun.com/zkkzpp258", "345921046.com");
        return new ApiInfoBuilder()
                .title("test by mr zhang")
                .description("测试swagger")
                .contact(contact)
                .version("1.0.0")
                .build();


![img](https://img-blog.csdnimg.cn/img_convert/9617882d427173b5ca102e896bba7e70.png)
![img](https://img-blog.csdnimg.cn/img_convert/b3cb911546146ec3993e7091c1a93021.png)
![img](https://img-blog.csdnimg.cn/img_convert/d6e0afa5705be63359b25bc80504b24f.png)

**既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上Go语言开发知识点，真正体系化！**

**由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新**

**[如果你需要这些资料，可以戳这里获取](https://bbs.youkuaiyun.com/topics/618658159)**

于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频，并且后续会持续更新**

**[如果你需要这些资料，可以戳这里获取](https://bbs.youkuaiyun.com/topics/618658159)**