release 2.2.9

CHANGELOG.md

@@ -1,4 +1,12 @@
 ## smart-doc版本
+#### 版本号：2.2.9
+- 更新日期: 2021-10-31
+- 更新内容：
+  1. 修复生成openapi文件上传错误问题。
+  2. 修复文件上传接口推送到torna参数被放置到query参数列表的问题。
+  3. 修改List<T>类型参数推送到torna错误的问题
+  4. 优化outPath配置，只使用torna推送时可以不再要求配置outPath项。
+
 #### 版本号：2.2.8
 - 更新日期: 2021-10-07
 - 更新内容：

pom.xml

@@ -5,7 +5,7 @@
     <modelVersion>4.0.0</modelVersion>
     <artifactId>smart-doc</artifactId>
     <packaging>jar</packaging>
-    <version>2.2.8</version>
+    <version>2.2.9</version>
 
     <name>smart-doc</name>
     <url>https://github.com/smart-doc-group/smart-doc.git</url>
@@ -45,7 +45,7 @@
         <dependency>
             <groupId>com.ibeetl</groupId>
             <artifactId>beetl</artifactId>
-            <version>3.6.1.RELEASE</version>
+            <version>3.8.0.RELEASE</version>
         </dependency>
         <dependency>
             <groupId>com.thoughtworks.qdox</groupId>

src/main/java/com/power/doc/builder/OpenApiBuilder.java

@@ -51,7 +51,7 @@ public class OpenApiBuilder {
 
     public static void buildOpenApi(ApiConfig config) {
         DocBuilderTemplate builderTemplate = new DocBuilderTemplate();
-        builderTemplate.checkAndInit(config,false);
+        builderTemplate.checkAndInit(config, false);
         JavaProjectBuilder javaProjectBuilder = new JavaProjectBuilder();
         ProjectDocConfigBuilder configBuilder = new ProjectDocConfigBuilder(config, javaProjectBuilder);
         openApiCreate(config, configBuilder);
@@ -65,7 +65,7 @@ public class OpenApiBuilder {
      */
     public static void buildOpenApi(ApiConfig config, JavaProjectBuilder projectBuilder) {
         DocBuilderTemplate builderTemplate = new DocBuilderTemplate();
-        builderTemplate.checkAndInit(config,false);
+        builderTemplate.checkAndInit(config, false);
         ProjectDocConfigBuilder configBuilder = new ProjectDocConfigBuilder(config, projectBuilder);
         openApiCreate(config, configBuilder);
     }
@@ -250,7 +250,7 @@ public class OpenApiBuilder {
 
                     detail.put("example", DocUtil.handleJsonStr(apiParam.getValue()));
                     if ("file".equals(apiParam.getType())) {
-                    detail.remove("example");
+                        detail.remove("example");
                         if (apiParam.isHasItems()) {
                             detail.put("type", "array");
                             Map<String, Object> items = new HashMap<>();
@@ -438,9 +438,9 @@ public class OpenApiBuilder {
     }
 
     /**
-     * 构建返回信息
+     * build response
      *
-     * @param apiMethodDoc 方法参数
+     * @param apiMethodDoc ApiMethodDoc
      * @return
      */
     private static Map<String, Object> buildResponses(ApiMethodDoc apiMethodDoc) {
@@ -450,9 +450,9 @@ public class OpenApiBuilder {
     }
 
     /**
-     * 构建返回信息实体
+     * response body
      *
-     * @param apiMethodDoc 方法参数
+     * @param apiMethodDoc ApiMethodDoc
      * @return
      */
     private static Map<String, Object> buildResponsesBody(ApiMethodDoc apiMethodDoc) {
@@ -463,9 +463,9 @@ public class OpenApiBuilder {
     }
 
     /**
-     * 构建component
+     * component schema
      *
-     * @param apiDocs 请求列表
+     * @param apiDocs List of ApiDoc
      * @return
      */
     private static Map<String, Object> buildComponentsSchema(List<ApiDoc> apiDocs) {
@@ -498,9 +498,9 @@ public class OpenApiBuilder {
     }
 
     /**
-     * component schema properties 信息
+     * component schema properties
      *
-     * @param apiParam 参数列表
+     * @param apiParam list of ApiParam
      * @return
      */
     private static Map<String, Object> buildProperties(List<ApiParam> apiParam) {
@@ -536,9 +536,9 @@ public class OpenApiBuilder {
     }
 
     /**
-     * component schema properties 实体信息构建
+     * component schema properties data
      *
-     * @param apiParam 参数基本信息
+     * @param apiParam ApiParam
      * @return
      */
     private static Map<String, Object> buildPropertiesData(ApiParam apiParam) {