From 1e1459e4135455fdaf7a8e02970853928dfaf966 Mon Sep 17 00:00:00 2001 From: linwumingshi Date: Fri, 29 Aug 2025 10:13:01 +0800 Subject: [PATCH] build: upgrade smart-doc to 3.1.1 - Update smart-doc version to 3.1.1 in various pom.xml files - Modify ParamsBuildHelper to use ProjectBuilder in field name translation - Update SopDocBuildTemplate to use new skipMethod signature - Remove isEntryPoint method from SopDocBuildTemplate --- .../payment-service-java17/pom.xml | 2 +- .../example-payment/payment-service/pom.xml | 2 +- .../example-product/product-service/pom.xml | 2 +- sop-example/example-rest/pom.xml | 2 +- sop-support/sop-service-support/pom.xml | 2 +- .../sop/support/doc/SopDocBuildTemplate.java | 19 +++---------------- .../support/doc/helper/ParamsBuildHelper.java | 2 +- 7 files changed, 9 insertions(+), 22 deletions(-) diff --git a/sop-example/example-payment-java17/payment-service-java17/pom.xml b/sop-example/example-payment-java17/payment-service-java17/pom.xml index e30551cd..b0a59cdf 100755 --- a/sop-example/example-payment-java17/payment-service-java17/pom.xml +++ b/sop-example/example-payment-java17/payment-service-java17/pom.xml @@ -103,7 +103,7 @@ com.ly.smart-doc smart-doc-maven-plugin - 3.0.9 + 3.1.1 ./src/main/resources/smart-doc.json diff --git a/sop-example/example-payment/payment-service/pom.xml b/sop-example/example-payment/payment-service/pom.xml index 91706055..20e60289 100755 --- a/sop-example/example-payment/payment-service/pom.xml +++ b/sop-example/example-payment/payment-service/pom.xml @@ -107,7 +107,7 @@ com.ly.smart-doc smart-doc-maven-plugin - 3.0.9 + 3.1.1 ./src/main/resources/smart-doc.json diff --git a/sop-example/example-product/product-service/pom.xml b/sop-example/example-product/product-service/pom.xml index ca1774ac..7ecb33e8 100755 --- a/sop-example/example-product/product-service/pom.xml +++ b/sop-example/example-product/product-service/pom.xml @@ -109,7 +109,7 @@ com.ly.smart-doc smart-doc-maven-plugin - 3.0.9 + 3.1.1 ./src/main/resources/smart-doc.json diff --git a/sop-example/example-rest/pom.xml b/sop-example/example-rest/pom.xml index 4397e12f..3c78002f 100644 --- a/sop-example/example-rest/pom.xml +++ b/sop-example/example-rest/pom.xml @@ -95,7 +95,7 @@ com.ly.smart-doc smart-doc-maven-plugin - 3.0.9 + 3.1.1 ./src/main/resources/smart-doc.json diff --git a/sop-support/sop-service-support/pom.xml b/sop-support/sop-service-support/pom.xml index 878df406..c02d8353 100755 --- a/sop-support/sop-service-support/pom.xml +++ b/sop-support/sop-service-support/pom.xml @@ -31,7 +31,7 @@ com.ly.smart-doc smart-doc - 3.0.9 + 3.1.1 provided diff --git a/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/SopDocBuildTemplate.java b/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/SopDocBuildTemplate.java index 573fb1e8..e5e3b28a 100644 --- a/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/SopDocBuildTemplate.java +++ b/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/SopDocBuildTemplate.java @@ -216,21 +216,8 @@ public class SopDocBuildTemplate extends RpcDocBuildTemplate { } @Override - public boolean isEntryPoint(JavaClass javaClass, FrameworkAnnotations frameworkAnnotations) { - // 必须是接口 - if (!javaClass.isInterface()) { - return false; - } - List methods = javaClass.getMethods(); - if (methods == null || methods.isEmpty()) { - return false; - } - for (JavaMethod method : methods) { - if (getOpenAnnotationInfo(method).isPresent()) { - return true; - } - } - return false; + public boolean skipMethod(JavaClass cls, JavaMethod method, ApiConfig apiConfig, + ProjectDocConfigBuilder projectBuilder) { + return !this.getOpenAnnotationInfo(method).isPresent(); } - } diff --git a/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/helper/ParamsBuildHelper.java b/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/helper/ParamsBuildHelper.java index 67d0a09d..a9f59b04 100644 --- a/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/helper/ParamsBuildHelper.java +++ b/sop-support/sop-service-support/src/main/java/com/gitee/sop/support/doc/helper/ParamsBuildHelper.java @@ -220,7 +220,7 @@ public class ParamsBuildHelper extends BaseHelper { // ignore if (Objects.nonNull(cls)) { List clsAnnotation = cls.getAnnotations(); - fieldNameConvert = PropertyNameHelper.translate(clsAnnotation); + fieldNameConvert = PropertyNameHelper.translate(projectBuilder, clsAnnotation); } String[] globGicName = DocClassUtil.getSimpleGicName(className); -- Gitee