Swagger2 快速定义API接口文档

springfox.documentation.swagger.v2.path=/xzh

/**

• Swagger2配置

• @author 向振华

• @date 2018/11/21 11:02

*/

@Configuration

@EnableSwagger2

@Profile({“dev”, “test”})//在何环境显示

public class Swagger2 {

@Bean

public Docket createRestApi() {

return new Docket(DocumentationType.SWAGGER_2)

.enable(true)

.apiInfo(apiInfo())

.select()

.apis(RequestHandlerSelectors.basePackage(“com.xzh.controller”))

.paths(PathSelectors.any())

.build();

}

/**

• 构建 api文档的详细信息函数

• @return

*/

private ApiInfo apiInfo() {

return new ApiInfoBuilder()

.title(“标题API”)

.contact(new Contact(“向振华”, “网站url”, “邮箱地址”))

.version(“1.0.0”)

.build();

}

}

请求参数定义

/**

• 请求参数

• @author 向振华

• @date 2018/11/21 11:13

*/

@Data

public class Model {

@ApiModelProperty(value = “名称”)

private String name;

@ApiModelProperty(value = “客户地区”)

private String area;

}

Controller层

/**

• @author 向振华

• @date 2018/11/21 11:04

*/

@Api(tags = “A服务名称”)

@RequestMapping(“xzh”)

@Controller

public class AController {

@ApiOperation(value = “方法名1”, notes = “备注1”)

@ApiImplicitParam(name = “parm”, value = “解释”, paramType = “query”, required = true)

@PostMapping(“/test1”)

@ResponseBody

public String test1(Long parm) {//单个参数

return null;

}

@ApiOperation(value = “方法名2”)

@ApiImplicitParams({

@ApiImplicitParam(name = “parm”, value = “XXid数组”, paramType = “query”, required = true),

@ApiImplicitParam(name = “arg”, value = “ZZid数组”, paramType = “query”, required = true)

})

@PostMapping(“/test2”)

@ResponseBody

public String test2(Long[] parm, Long[] arg) {//多个参数

return null;

}

@ApiOperation(value = “方法名3”)

@GetMapping(“/test3”)

@ResponseBody

public String test3(Model model) {//实体类，注解写在实体类内

return null;

}

}

启动服务器，访问http://localhost:8001/swagger-ui.html#/

进入页面

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

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

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）

总结

就写到这了，也算是给这段时间的面试做一个总结，查漏补缺，祝自己好运吧，也希望正在求职或者打算跳槽的 程序员看到这个文章能有一点点帮助或收获，我就心满意足了。多思考，多问为什么。希望小伙伴们早点收到满意的offer! 越努力越幸运！

金九银十已经过了，就目前国内的面试模式来讲，在面试前积极的准备面试，复习整个 Java 知识体系将变得非常重要，可以很负责任的说一句，复习准备的是否充分，将直接影响你入职的成功率。但很多小伙伴却苦于没有合适的资料来回顾整个 Java 知识体系，或者有的小伙伴可能都不知道该从哪里开始复习。我偶然得到一份整理的资料，不论是从整个 Java 知识体系，还是从面试的角度来看，都是一份含技术量很高的资料。

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！
知道该从哪里开始复习。我偶然得到一份整理的资料，不论是从整个 Java 知识体系，还是从面试的角度来看，都是一份含技术量很高的资料。**

[外链图片转存中…(img-6DXx1LK1-1713343854825)]

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！