查看电脑上NET Framework最高版本

1、使用CMD工具

1、进入路径:

cd %WINDIR%\Microsoft.NET\Framework\v4.0.30319

2、查看版本

MSBuild /version

2、效果

结果

### 如何使用 Swagger 3 构建 API 文档 #### 配置 Spring Boot 应用程序以集成 Swagger 3 为了使应用程序能够通过 Swagger UI 展现其 RESTful Web Services 的接口文档,在项目中引入必要的依赖项是第一步。对于 Maven 用户来说,这通常意味着向 `pom.xml` 文件添加如下所示的相关依赖: ```xml <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-boot-starter</artifactId> <version>3.0.0</version> </dependency> ``` 此操作确保了应用具备创建 OpenAPI (即以前版本中的 Swagger) 规范所需的功能。 #### 创建并配置 Swagger Bean 接着定义一个配置类来设置 Swagger 特定属性,比如基本信息、联系人详情以及许可证条款等。下面是一段 Java 代码片段展示如何实现这一点: ```java @Configuration @EnableOpenApi public class SwaggerConfig { @Bean public Docket api() { return new Docket(DocumentationType.OAS_30) .select() .apis(RequestHandlerSelectors.any()) .paths(PathSelectors.any()) .build(); } } ``` 上述代码设置了 Docket 实例以便于后续生成 OAS 3.0 格式的 API 描述文件[^1]。 #### 添加控制器级别的注解 为了让特定 HTTP 请求映射到相应的业务逻辑处理函数上,并让这些端点被自动记录至最终产生的 API 文档里,则需在 Controller 类及其内部的方法之上加上适当数量的 Swagger 注释标签。例如: ```java @Api(value = "/api", tags = "测试API接口") @RestController @RequestMapping("/api") public class ScoreController { @Autowired private ScoreService service; @ApiOperation(value = "获取得分列表", notes = "详细描述") @GetMapping("/getScore") public ResponseEntity<List<Score>> getScore( @RequestParam("uid") @ApiParam(name="uid", value="用户ID") String uid){ List<Score> scorelist = service.selScoreList(uid); return ResponseEntity.ok().body(scorelist); } } ``` 这里展示了怎样运用 `@Api`, `@ApiOperation`, 和 `@ApiParam` 来提供关于路径参数和返回值类型的额外元数据信息给 Swagger 工具链去解析[^3]。 #### 访问自动生成的 API 文档界面 一旦完成了以上步骤并且重启服务器之后,就可以通过浏览器访问 `/swagger-ui/index.html?url=/v3/api-docs#` 路径下的页面查看由系统自动生成出来的交互式 API 参考手册了。该站点不仅列出了所有公开的服务端点连同它们接受的数据格式说明,还允许开发者直接在线尝试调用各个服务而不必离开当前窗口[^2]。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值