不用Swagger，那我用啥？

摘要 - SpringDoc 文档生成工具

松哥在探索和分享技术知识的过程中，介绍了Spring Boot和Vue3技术栈，并推荐了SpringDoc作为一个与Spring Boot兼容性更佳的API文档生成工具。本文将详细介绍SpringDoc的使用方法及其与其他技术的结合。

1. OpenAPI 和 SpringDoc

OpenAPI是API文档的业界标准，其有两个主要实现：SpringFox（Swagger）和SpringDoc。SpringDoc兼容OpenAPI 3，支持Spring Boot全版本，并能与Swagger UI结合，提供OAuth 2支持等功能。

2. 引入 SpringDoc

SpringDoc用于生成和渲染接口文档JSON。用户可添加依赖来生成接口JSON文档，或使用Swagger UI渲染文档。可通过Spring Boot的配置文件自定义接口文档和UI的访问路径。

3. 结合 Spring Security

若项目中使用Spring Security，可通过引入特定依赖自动处理接口中的@AuthenticationPrincipal注解参数，免除手动传递的需求。

4. 结合 Spring Data Rest

Spring Data Rest能够方便地构建RESTful应用，SpringDoc提供支持以自动生成相关接口文档。用户可以通过添加依赖，并进行简单配置，即可获得REST风格接口的自动生成和文档产出。

5. 结合 Actuator

Spring Boot的Actuator可以生成项目运行数据端点。通过简单配置，SpringDoc可以将这些端点纳入文档中，或者将API文档整合到Actuator中。

6. 切换到 Swagger

对于已经使用Swagger的项目，SpringDoc提供了简单的迁移方案。它允许开发者通过替换注解和配置来实现从Swagger到SpringDoc的切换。

松哥强调，通过TienChin项目视频，使用Spring Boot+Vue3技术栈，可以涉足更多有趣的技术，并鼓励开发者加入项目的实践，以实现超90%的完成率。