spring:
  application:
    name: springdoc-openapi
server:
  port: 8080
# ===== SpringDoc配置 =====#
springdoc:
  swagger-ui:
    # 自定义的文档界面访问路径。默认访问路径是/swagger-ui.html
    path: /springdoc/docs.html
    # 字符串类型，一共三个值来控制操作和标记的默认展开设置。它可以是“list”（仅展开标记）、“full”（展开标记和操作）或“none”（不展开任何内容）。
    docExpansion: none
    # 布尔值。控制“试用”请求的请求持续时间（毫秒）的显示。
    displayRequestDuration: true
    # 布尔值。控制供应商扩展（x-）字段和操作、参数和架构值的显示。
    showExtensions: true
    # 布尔值。控制参数的扩展名（pattern、maxLength、minLength、maximum、minminimum）字段和值的显示。
    showCommonExtensions: true
    # 布尔值。禁用swagger用户界面默认petstore url。（从v1.4.1开始提供）。
    disable-swagger-default-url: true
  api-docs:
    # enabled the /v3/api-docs endpoint
    enabled: true
    # 自定义的文档api元数据访问路径。默认访问路径是/v3/api-docs
    path: /springdoc/api-docs
    # 布尔值。在@Schema（名称name、标题title和说明description，三个属性）上启用属性解析程序。
    resolve-schema-properties: true
  # 布尔值。实现OpenApi规范的打印。
  writer-with-default-pretty-printer: true
# ===== swagger配置 =====#
swagger:
  application-name: ${spring.application.name}
  application-version: 1.0
  application-description: springdoc openapi整合Demo
  try-host: http://localhost:${server.port}
                    swagger是我们开发过程中非常常用的一个api 文档维护组织吗，为了前后端更好的交互，swagger早已经成为了大家的首选api 文档框架。但随着spring的发展与强大，spring也出了自己的api框架，但实用惯了swagger的用户，在切换过来后发现就不太会用了，其实springdoc本身已经集成并兼容了swagger,但对应的注解有所变化。下面我们就来看看swagger的注解在springdoc中的对应关系。springdoc的maven依赖   <dependency>   
springdoc-openapi Java库有助于使用Spring Boot项目自动生成API文档。 springdoc-openapi的工作原理是在运行时检查应用程序以基于Spring配置，类结构和各种注释来推断API语义。
 该库会自动以JSON / YAML和HTML格式的页面生成文档。 可以使用swagger-api注释对生成的文档进行补充。
 该库支持：
 OpenAPI 3
 Spring启动（v1和v2）
 JSR-303，专门用于@ NotNull，@ Min，@ Max和@Size。
 Swagger-ui
 Oauth 2
 以下视频介绍了库：
 这是一个基于社区的项目，不是由Spring Framework Contributors（Pivotal）维护的
用于springdoc-openapi与spring-boot和swagger-ui集成的库
自动将swagger-ui部署到Spring Boot 2.x应用程序
使用官方的 ，将以HTML格式提供文档。
 然后，应该在可以找到Swagger UI页面，OpenAPI描述将在json格式的
				
Sprinboot2.4整合Swagger3（springdoc-openapi-ui）一、创建Springboot项目，引入pom依赖二、配置类请求头携带token三、配置文件四、接口定义五、实现类六、实体类定义七、运行项目查看效果
参考文档：https://github.com/swagger-api/swagger-core/wiki/Swagger-2.X—Annotations
一、创建Springboot项目，引入pom依赖
        <dependency>
4.找一个海外手机号码收取验证码，完成验证即可。
注意，大陆手机号码没办法通过注册，所以必须找到一个可用的海外手机收取验证码。
5.登录 https://sms-activate.org/cn 网站，注册并登录账号
这个网站可以通过充值购买国外虚拟电话号码，实现收验证码的功能。
......
				
spring常见注解方法，小编主要结合老师的讲解，和自己的理解方式作为解析，方便后期的记忆。
创建一个学生的实体类
    private String student_id;// 学生id
	private String name;// 学生名字
	// 引用老师对象 每个学生都有一个对应的辅导员
	private Teacher teacher;
	省略get、set、toString方法，自己去生成。
创建一个老师的实体类
    private String teacher_id;// 教师编号
				
传统的SpringBoot使用Swagger时配置及其繁琐，随着SpringBoot的不断更新，SpringDoc整合了Swagger，并且提供了非常简洁的整合方式
1、添加SpringDoc的依赖：
        <!--添加springDoc依赖-->
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>s.
				
1.xml文件中的spring注解约束
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/
				
Springfox-swagger-ui-2.6.0是一个非常知名的API文档生成工具，在众多开发者中使用广泛。它可以根据Java代码中添加的Swagger注解自动生成API文档，并提供一个易于使用和漂亮的Web界面，使API文档的浏览和测试变得相当简单。
如果您想使用Springfox-swagger-ui-2.6.0，可以从官方网站下载。通常情况下，您可以在网站的下载页面中找到所有版本的Springfox-swagger-ui，包括旧版本和最新版本。如果您是Maven用户，还可以将其添加到项目的pom.xml文件中，通过Maven中央仓库自动下载。
在下载完Springfox-swagger-ui-2.6.0后，您需要将其添加到项目中。这通常涉及到在项目的classpath中包含下载的jar文件。除此之外，您还需要在Spring的配置文件中添加相应的配置信息，以确保Springfox-swagger-ui-2.6.0能够正确地运行。例如，您可以设置Swagger的基本信息、API的版本、API的Title等。
总的来说，Springfox-swagger-ui-2.6.0是一个非常强大的API文档生成工具，可以大大提高API的开发效率和可用性。通过使用Springfox-swagger-ui-2.6.0，开发者可以快速创建和维护高质量的API文档，并将其集成到现有的项目中。