你还在使用swagger?试试这个吧

easyyapi插件使用
1. 安装插件

打开idea的Settings–>Plugins,查找easyyapi插件安装。
在这里插入图片描述

2. 配置插件

安装成功后,再次打开Settings–>OtherSettings,配置yapi服务地址以及项目token.
tokens: 项目名=token
在这里插入图片描述

token从项目设置里获取
在这里插入图片描述

3. 编写javadoc

配置完成后,可参考官方demo,编写javadoc。
官方说明地址:https://easyyapi.com/documents/java_doc_demo.html
该插件目前仅支持springweb原生注解,获取控制器的请求方式,自定义注解不支持
在这里插入图片描述

4. 上传接口javadoc

编写完成后,选中要上传的Controller,下拉idea code选项,选择ExportYapi
在这里插入图片描述

也可选择单个接口上传,右键
在这里插入图片描述

执行结果:
在这里插入图片描述

5. 登录YApi,查看项目接口

在这里插入图片描述
在这里插入图片描述

Swagger是一种流行的API开发工具,它可以帮助开发者设计、构建、记录和使用RESTful Web服务。在Spring Boot项目中集成Swagger可以通过以下步骤进行: 1. 添加Swagger依赖项:在项目的`pom.xml`(Maven项目)或`build.gradle`(Gradle项目)文件中添加Swagger相关的依赖项。对于Maven项目,通常添加的是`springfox-swagger2`和`springfox-swagger-ui`依赖。 2. 配置Swagger:创建一个配置类,使用`@Configuration`注解来标识这是一个配置类,然后使用`@EnableSwagger2`注解来启用Swagger。还可以自定义一些Swagger的配置,比如API信息、分组等。 3. 使用Swagger注解:在你的Controller中,使用Swagger提供的注解如`@ApiOperation`、`@ApiResponses`、`@ApiParam`等来增加对API的描述,包括接口的描述、请求参数、响应信息等。 4. 访问Swagger UI:完成以上步骤后,启动Spring Boot应用,然后在浏览器中访问`http://localhost:8080/swagger-ui.html`(假设你的应用运行在8080端口),你可以看到一个交互式的API文档界面。 下面是一个简单的示例代码: ```java @Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.any()) .paths(PathSelectors.any()) .build(); } } @RestController @RequestMapping("/api") @Api(value = "数据查询API", description = "提供数据查询相关的REST API") public class DataController { @ApiOperation(value = "获取数据", notes = "根据ID获取数据详情") @GetMapping("/data/{id}") public ResponseEntity<Data> getDataById(@ApiParam(value = "数据ID", required = true) @PathVariable("id") Long id) { // 这里添加获取数据的逻辑 return ResponseEntity.ok(new Data()); } } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值