Swagger是一套用于设计、描述和记录RESTful API的工具集。

在本教程中，我们将探讨如何在Java中解析OpenAPI文档文件并提取其各种组件。

2. Swagger是什么？

Swagger本质上是一套开源的规则、规范和工具集，用于开发和描述REST API。然而，随着新标准和规范的演变，这些规范现在被重命名为OpenAPI规范（OAS）。

OpenAPI规范标准化了如何创建API设计文档。 它创建了一个我们可以轻松开发和使用API的RESTful接口。API规范有效地映射了与之相关的所有资源和操作。

Lombok是一个Java库，有助于减少像getter、setter等样板代码。OpenAPI提供了一个属性来自动生成带有Lombok注解的模型。

在本教程中，我们将探讨如何使用OpenAPI代码生成器生成带有Lombok注解的模型。

2. 项目设置

首先，让我们启动一个Spring Boot项目，并添加Spring Boot Starter Web和Lombok依赖项：

```````<dependency>```````
    ````````<groupId>````````org.springframework.boot````````</groupId>````````
    ````````<artifactId>````````spring-boot-starter-web````````</artifactId>````````
    ````````<version>````````3.1.2````````</version>````````
```````</dependency>```````
```````<dependency>```````
    ````````<groupId>````````org.projectlombok````````</groupId>````````
    ````````<artifactId>````````lombok````````</artifactId>````````
    ````````<version>````````1.18.30````````</version>````````
    `<scope>`provided`</scope>`
```````</dependency>```````

OpenAPI规范，以前称为Swagger规范，有助于以标准化、机器可读的方式描述API。

在本教程中，我们将学习如何使用OpenAPI规范定义不同类型的数组。 我们将在整篇文章中使用OpenAPI v3的特性。

首先，让我们定义我们将在文章中使用的例子。我们假设我们要定义一个数组，包含以下两个对象，分别代表一只狗和一只狮子：

#狗
type: object
properties:
  barks:
    type: boolean
  likesSticks:
    type: boolean
#狮子
type: object
properties:
  roars:
    type: boolean
  likesMeat:
    type: boolean

如何为Spring Boot应用中的OpenAPI配置JWT认证

如果你正在处理Spring Security（尤其是OAuth）实现，一定要看看《Learn Spring Security》课程：

> > LEARN SPRING SECURITY

1. 概述

OpenAPI 是一种语言无关且平台独立的规范，它标准化了REST API。OpenAPI 使用户能够轻松理解API而无需深入代码。Swagger-UI 基于这个OpenAPI规范生成一个用户界面，帮助可视化和测试REST API。