Swagger 与 OpenAPI

概览：@OpenAPIDefinition #

标注在任意类上（通常是 @SpringBootApplication 类），用于提供应用程序 API 的概览。

• info = info/Info.class
  • contact = info/Contact.class
  • license = info/License.class
• ExternalDocumentation.class
• servers/Server.class
  • servers/Servers.class
  • servers/ServerVariable.class
• tags/Tag.class
  • tags/Tags.class
• security/SecurityRequirement.class
  • security/SecurityRequirements.class

@Operation： #

tags: @Tag externalDocs: @ExternalDocumentation parameters: @Parameter responses: @ApiResponse requestBody: @RequestBody security: @SecurityRequirement servers: @Server extensions: @Extension hidden: @Hidden

其他 #

Hidden.class OpenAPI31.class

StringToClassMapItem.class Webhook.class Webhooks.class

callbacks/Callback.class callbacks/Callbacks.class

enums/Explode.class enums/ParameterIn.class enums/ParameterStyle.class enums/SecuritySchemeIn.class enums/SecuritySchemeType.class

extensions/Extension.class extensions/ExtensionProperty.class extensions/Extensions.class

headers/Header.class

links/Link.class links/LinkParameter.class media/ArraySchema.class media/Content.class media/DependentRequired.class media/DependentRequiredMap.class media/DependentSchema.class media/DependentSchemas.class media/DiscriminatorMapping.class media/Encoding.class media/ExampleObject.class media/PatternProperties.class media/PatternProperty.class media/Schema.class media/Schema.class media/Schema.class media/Schema.class media/Schema.class media/SchemaProperties.class media/SchemaProperty.class

parameters/ValidatedParameter.class responses/ApiResponse.class responses/ApiResponses.class security/OAuthFlow.class security/OAuthFlows.class security/OAuthScope.class

security/SecurityScheme.class security/SecuritySchemes.class