diff --git a/src/main/java/com/power/doc/template/IRestDocTemplate.java b/src/main/java/com/power/doc/template/IRestDocTemplate.java index d44c72f1d..2be679239 100644 --- a/src/main/java/com/power/doc/template/IRestDocTemplate.java +++ b/src/main/java/com/power/doc/template/IRestDocTemplate.java @@ -376,7 +376,11 @@ default List buildEntryPointMethod( methodOrder++; apiMethodDoc.setOrder(methodOrder); apiMethodDoc.setName(method.getName()); - apiMethodDoc.setDesc(method.getComment()); + String common = method.getComment(); + if (StringUtil.isEmpty(common)) { + common = JavaClassUtil.getSameSignatureMethodCommonFromInterface(cls, method); + } + apiMethodDoc.setDesc(common); apiMethodDoc.setAuthor(docJavaMethod.getAuthor()); apiMethodDoc.setDetail(docJavaMethod.getDetail()); String methodUid = DocUtil.generateId(clazName + method.getName() + methodOrder); diff --git a/src/main/java/com/power/doc/utils/JavaClassUtil.java b/src/main/java/com/power/doc/utils/JavaClassUtil.java index bf379566b..a50664208 100644 --- a/src/main/java/com/power/doc/utils/JavaClassUtil.java +++ b/src/main/java/com/power/doc/utils/JavaClassUtil.java @@ -270,6 +270,30 @@ private static List getFields(JavaClass cls1, int counter, Map methodsBySignature = cls.getMethodsBySignature(method.getName(), method.getParameterTypes(), true, method.isVarArgs()); + + for (JavaMethod sameSignatureMethod : methodsBySignature) { + if (sameSignatureMethod == method + || sameSignatureMethod.getDeclaringClass() == null + || !sameSignatureMethod.getDeclaringClass().isInterface()) { + continue; + } + if (sameSignatureMethod.getComment() != null){ + return sameSignatureMethod.getComment(); + } + } + return null; + } + + /** * get enum value *