openapi3

yifu-upms/yifu-upms-biz/src/main/resources/application.yml

@@ -63,6 +63,17 @@ spring:
   #mvc:
   #  pathmatch:
   #    matching-strategy: ANT_PATH_MATCHER
+#swagger 文档 https://springdoc.org/
+### OpenAPI3 注解
+#  OpenAPI 3	                            注解位置
+#  @Tag(name = “接口类描述”)	                Controller 类上
+#  @Operation(summary =“接口方法描述”)	    Controller 方法上
+#  @Parameters	                            Controller 方法上
+#  @Parameter(description=“参数描述”)	    Controller 方法上 @Parameters 里
+#  @Parameter(description=“参数描述”)	    Controller 方法的参数上
+#  @Parameter(hidden = true) 或 @Hidden	--
+#  @Schema	                                DTO类上
+#  @Schema	                                DTO属性上
 
 springdoc:
   api-docs: