javadoc导出成word文档

javadoc导出成word文档,第1张

javadoc导出成word文档

刚刚上次弄完了一个坑爹的任务,这次我领导又给我一个让人脑瓜子疼的任务了。


基本上客户他在验收我们系统的时候,都会要求我们编写相关的文档,这次也不例外。


只是这次的客户要求我们给出接口文档。


不仅是要整个controller的rest接口文档,还要给出service层的接口,连工具类都要有。


这不是在为难我胖虎么。


想我辛辛苦苦给全部controller方法都加上了swagger注解,想我辛辛苦苦把整个项目全部方法都加上了完美的javadoc注释,想我关键代码都留了逻辑注释,

为什么还要我给你弄个word文档。


抱怨归抱怨,该干的活还是要干的,谁让这该死的钱真香。


但是要怎么弄呢?这是个很严重的问题,毕竟我的项目方法没一千都有一百,总不能一个个给他Ctrl C + Ctrl V吧,那我的弄到何年何月。


swagger的我可以找工具导出成word文档,可是service层的呢?我的工具类呢?

有没有现成的工具呢?问下度娘,~~~~~~~~~成功摸鱼半天,毫无收获

那能不能像上次那样用正则自己搞呢?试一哈 ~~~~~~~~~~~~~ 成功摸鱼半天,失败了,有些代码的文档注释太坑爹了,方法内用文档注释,搞事情吧,怎么还有部分前面的*号都没了。


idea不是可以导出javadoc文档么?能不能导出word呢?试一哈 ~~~~~~~~~~~~成功摸鱼半天,毫无办法,不过我找到了一个神奇的方法 com.sun.tools.javadoc.Main.execute(initAgrs); 有没有觉得很眼熟,没错,这就是jdk自己的javadoc工具。


先让我们来膜拜下前辈的文章:

https://blog.csdn.net/10km/article/details/78252586

原理其实很简单,javadoc 这个jdk的 tools.jar 中的包的类已经帮我们解析好了java文件,我们需要做的仅仅是重写一个Doclet,然后在它里面处理下javadoc给我弄好的RootDoc就行,剩下就只剩 *** 作RootDoc它了。


先看下javadoc这个包先

其中我们将直接用到com.sun.tools.javadoc.Main这个类

那我们需要做啥呢?最简单的就3步。


1、调用com.sun.tools.javadoc.Main.execute()这个方法,传入参数

 2、写一个自己的Doclet类。


 3、拿到数据后,自己解析class类型、方法名、类名、方法注释、类注释、字段注释、参数注释............然后爱生成HTML、爱生成Word、爱生成Excel,随你们喜欢。


大概怎么用说完了,展示下我的生成后的效果吧,我没调样式,毕竟用poi *** 作word真的是难受

上代码:

项目结构:(一定要有tools.jar,他在你们jdk的lib目录里,另外POI *** 作word的相关包要导齐全,不然各种坑)

pom.xml主要就是为了引入POI的包

<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion> <groupId>com.hongcheng</groupId>
<artifactId>javadoc_generator</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>jar</packaging> <name>javadoc_generator</name>
<url>http://maven.apache.org</url> <properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<java.version>1.8</java.version>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
</properties> <dependencies> <dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>4.0.0</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-scratchpad</artifactId>
<version>4.0.0</version>
</dependency> </dependencies>
</project>
ClassComment.java用来保存类数据的实体
package com.hongcheng.javadoc_generator.entity;

import java.util.List;

/**
* java类的相关信息
*/
public class ClassComment {
/** 类的全类名 */
private String className;
/** 类的简单类名 */
private String simpleClassName;
/** 类注释 */
private String classComment;
/** 字段相关信息 */
private List<FieldComment> fields;
/** 方法相关信息 */
private List<MethodComment> methods; public String getClassName() {
return className;
}
public String getSimpleClassName() {
return simpleClassName;
}
public String getClassComment() {
return classComment;
}
public List<FieldComment> getFields() {
return fields;
}
public List<MethodComment> getMethods() {
return methods;
}
public void setClassName(String className) {
this.className = className;
}
public void setSimpleClassName(String simpleClassName) {
this.simpleClassName = simpleClassName;
}
public void setClassComment(String classComment) {
this.classComment = classComment;
}
public void setFields(List<FieldComment> fields) {
this.fields = fields;
}
public void setMethods(List<MethodComment> methods) {
this.methods = methods;
}
@Override
public String toString() {
return "{className: " + className + ", simpleClassName: " + simpleClassName + ", classComment: " + classComment
+ ", fields: " + fields + ", methods: " + methods + "}";
} }
FieldComment.java用来保存字段和参数的实体
package com.hongcheng.javadoc_generator.entity;

/**
* java类中字段的相关信息
*/
public class FieldComment {
/** 字段类型 */
private String clasz;
/** 类的简单类名 */
private String simpleClassName;
/** 字段注释 */
private String fieldComment;
/** 字段名 */
private String fieldName;
/** 默认值,必须是final修饰的基本数据类型及其包装类 */
private Object defaultValue; public String getSimpleClassName() {
return simpleClassName;
}
public void setSimpleClassName(String simpleClassName) {
this.simpleClassName = simpleClassName;
}
public String getClasz() {
return clasz;
}
public String getFieldComment() {
return fieldComment;
}
public String getFieldName() {
return fieldName;
}
public Object getDefaultValue() {
return defaultValue;
}
public void setClasz(String clasz) {
this.clasz = clasz;
}
public void setFieldComment(String fieldComment) {
this.fieldComment = fieldComment;
}
public void setFieldName(String fieldName) {
this.fieldName = fieldName;
}
public void setDefaultValue(Object defaultValue) {
this.defaultValue = defaultValue;
}
@Override
public String toString() {
return "{clasz: " + clasz + ", simpleClassName: " + simpleClassName + ", fieldComment: " + fieldComment
+ ", fieldName: " + fieldName + ", defaultValue: " + defaultValue + "}";
} }
MethodComment.java用来保存方法数据的实体
package com.hongcheng.javadoc_generator.entity;

import java.util.List;

/**
* java类中方法的相关信息
*/
public class MethodComment {
/** 方法注释 */
private String methodComment;
/** 方法名 */
private String methodName;
/** 参数 */
private List<FieldComment> params;
/** 返回值 */
private FieldComment returnEntity; public String getMethodComment() {
return methodComment;
}
public String getMethodName() {
return methodName;
}
public List<FieldComment> getParams() {
return params;
}
public FieldComment getReturnEntity() {
return returnEntity;
}
public void setMethodComment(String methodComment) {
this.methodComment = methodComment;
}
public void setMethodName(String methodName) {
this.methodName = methodName;
}
public void setParams(List<FieldComment> params) {
this.params = params;
}
public void setReturnEntity(FieldComment returnEntity) {
this.returnEntity = returnEntity;
}
@Override
public String toString() {
return "{methodComment: " + methodComment + ", methodName: " + methodName + ", params: " + params
+ ", returnEntity: " + returnEntity + "}";
} }
MyDoclet.java很关键的类
package com.hongcheng.javadoc_generator;

import com.sun.javadoc.Doclet;
import com.sun.javadoc.RootDoc; /**
* 用来获取javadoc解析完成后生成的语法树根节点
* */
public class MyDoclet extends Doclet {
/**
* 静态对象,用于接收javadoc解析完成后生成的语法树根节点<br>
* 在后面我们会用他来获取我们需要的数据
* */
private static RootDoc root; /**
* 在javadoc解析完java文件后,生成语法树,然后就会调用这个方法去让Doclet生成doc文档
* */
public static boolean start(RootDoc rootDoc) {
MyDoclet.root = rootDoc;
return true;
} /**
* 获取语法树的根节点
* */
public static RootDoc getRoot() {
return root;
} }
Modifier.java用来处理下哪些方法和字段才是我们需要的
package com.hongcheng.javadoc_generator;

/**
* 可见性修饰符
* */
public enum Modifier{
PUBLIC,PROTECTED,PRIVATE;
}
RootClassParser.java用来解析RootDoc,转成我们自己的那三个实体类
package com.hongcheng.javadoc_generator;

import java.util.LinkedList;
import java.util.List; import com.hongcheng.javadoc_generator.entity.ClassComment;
import com.hongcheng.javadoc_generator.entity.FieldComment;
import com.hongcheng.javadoc_generator.entity.MethodComment;
import com.sun.javadoc.ClassDoc;
import com.sun.javadoc.FieldDoc;
import com.sun.javadoc.MethodDoc;
import com.sun.javadoc.ParamTag;
import com.sun.javadoc.Parameter;
import com.sun.javadoc.RootDoc;
import com.sun.javadoc.Tag;
/**
* RootClass对象的解析器,用于根据RootClass构建我们自己的ClassComment
* */
public class RootClassParser { /** 需要处理的类字段可见性,默认公有 */
private Modifier fieldModifier = Modifier.PUBLIC;
/** 需要处理的类方法可见性,默认公有 */
private Modifier methodModifier = Modifier.PUBLIC; public RootClassParser(Modifier fieldModifier,Modifier methodModifier) {
this.fieldModifier = fieldModifier;
this.methodModifier = methodModifier;
} /**
* 解析
* */
public List<ClassComment> parse(RootDoc root) {
if(root == null) {
return new LinkedList<ClassComment>();
}
List<ClassComment> classComments = new LinkedList<ClassComment>();
ClassDoc[] classes = root.classes();
for (ClassDoc clasz:classes) {
ClassComment classComment = new ClassComment();
classComment.setClassName(clasz.qualifiedTypeName());
classComment.setSimpleClassName(clasz.simpleTypeName());
classComment.setClassComment(clasz.commentText());
classComment.setFields( this.parseFields(clasz.fields()));
classComment.setMethods( this.parseMethods(clasz.methods()));
classComments.add(classComment);
}
return classComments;
} /**
* 解析字段
* */
private List<FieldComment> parseFields(FieldDoc[] fields){
if(fields == null || fields.length <= 0) {
return new LinkedList<FieldComment>();
}
List<FieldComment> fieldList = new LinkedList<FieldComment>();
for (FieldDoc field : fields) {
if(!this.checkModifier(field)) {
continue;
}
FieldComment fieldComment = new FieldComment();
fieldList.add(fieldComment);
fieldComment.setClasz(field.type().qualifiedTypeName());
fieldComment.setSimpleClassName(field.type().simpleTypeName());
fieldComment.setFieldComment(field.commentText());
fieldComment.setFieldName(field.name());
fieldComment.setDefaultValue(field.constantValue());
}
return fieldList;
} /**
* 检查字段修饰语,也就是public、protected、private
* @return 如果该字段的访问权限修饰语满足我们需要的级别,那就返回true
* */
private boolean checkModifier(FieldDoc field) {
if(this.getFieldModifier().toString().equalsIgnoreCase(field.modifiers())) {
return true;
}
return false;
} /**
* 检查方法修饰语,也就是public、protected、private
* @return 如果该方法的访问权限修饰语满足我们需要的级别,那就返回true
* */
private boolean checkModifier(MethodDoc method) {
if(this.getMethodModifier().toString().equalsIgnoreCase(method.modifiers())) {
return true;
}
return false;
} /**
* 解析方法
* */
private List<MethodComment> parseMethods(MethodDoc[] methods){
if(methods == null || methods.length <= 0) {
return new LinkedList<MethodComment>();
}
List<MethodComment> methodsList = new LinkedList<MethodComment>();
for (MethodDoc method : methods) {
if(!this.checkModifier(method)) {
continue;
}
MethodComment methodComment = new MethodComment();
methodsList.add(methodComment);
methodComment.setMethodComment(method.commentText());
methodComment.setMethodName(method.name());
methodComment.setReturnEntity(this.parseMethodReturn(method));
methodComment.setParams(this.parseMethodParam(method));
}
return methodsList;
} /***
* 解析方法的返回值
* */
private FieldComment parseMethodReturn(MethodDoc method){
// 返回值
FieldComment returnEntity = new FieldComment();
returnEntity.setClasz(method.returnType().qualifiedTypeName());
returnEntity.setSimpleClassName(method.returnType().simpleTypeName());
for(Tag tag:method.tags()) {
if(tag.name().equals("@return")) {
returnEntity.setFieldComment(tag.text());
break;
}
}
return returnEntity;
} /***
* 解析方法的参数
* */
private List<FieldComment> parseMethodParam(MethodDoc method){
// 参数
List<FieldComment> params = new LinkedList<FieldComment>();
for(Parameter parameter:method.parameters()) {
FieldComment param = new FieldComment();
param.setClasz(parameter.type().qualifiedTypeName());
param.setSimpleClassName(parameter.type().simpleTypeName());
param.setFieldName(parameter.name());
for(ParamTag paramTag :method.paramTags()) {
if(paramTag.parameterName().equals(param.getFieldName())) {
param.setFieldComment(paramTag.parameterComment());;
break;
}
}
params.add(param);
}
return params;
} public Modifier getFieldModifier() {
return fieldModifier;
} public Modifier getMethodModifier() {
return methodModifier;
} public void setFieldModifier(Modifier fieldModifier) {
this.fieldModifier = fieldModifier;
} public void setMethodModifier(Modifier methodModifier) {
this.methodModifier = methodModifier;
} }
WordExport.java用来生成word文档的
package com.hongcheng.javadoc_generator;

import java.io.FileOutputStream;
import java.util.List; import org.apache.poi.xwpf.usermodel.TableWidthType;
import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
import org.apache.poi.xwpf.usermodel.XWPFTable;
import org.apache.poi.xwpf.usermodel.XWPFTableCell;
import org.apache.poi.xwpf.usermodel.XWPFTableRow;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STMerge; import com.hongcheng.javadoc_generator.entity.ClassComment;
import com.hongcheng.javadoc_generator.entity.FieldComment;
import com.hongcheng.javadoc_generator.entity.MethodComment; public class WordExport { public void export(List<ClassComment> result,String path) throws Exception {
XWPFDocument xwpfDocument = this.newWord(); for(ClassComment classComment: result) {
this.newParagraph(xwpfDocument, "类名:" + classComment.getClassName());
this.newParagraph(xwpfDocument, "说明:" + classComment.getClassComment());
// 字段
if(classComment.getFields() != null && !classComment.getFields().isEmpty()) {
XWPFTable table = this.newTable(xwpfDocument, classComment.getFields().size() + 3, 5);
this.mergeCell(table.getRow(0), 0, 4, "类名:" + classComment.getClassName());
this.mergeCell(table.getRow(1), 0, 4, "属性:");
this.setTableRowText(table.getRow(2), 0, 4, "序号","参数类型","参数名","常量值","说明");
this.setCellWidth(table.getRow(2), 0, 4, "10%","22.5%","22.5%","22.5%","22.5%"); for(int i = 0,j = 3;i < classComment.getFields().size();i++,j++ ) {
FieldComment field = classComment.getFields().get(i);
this.setTableRowText(table.getRow(j), 0, 4, String.valueOf(i + 1)
,field.getSimpleClassName()
,field.getFieldName()
,field.getDefaultValue() == null?"":field.getDefaultValue().toString()
,field.getFieldComment());
}
this.newBlankLine(xwpfDocument);
this.newBlankLine(xwpfDocument);
}
// 方法
if(classComment.getMethods() != null && !classComment.getMethods().isEmpty()) {
for(MethodComment method: classComment.getMethods()) {
XWPFTable table = this.newTable(xwpfDocument, 3, 4);
this.mergeCell(table.getRow(0), 0, 3, "类名:" + classComment.getClassName());
this.mergeCell(table.getRow(1), 0, 3, "方法名:" + method.getMethodName());
this.mergeCell(table.getRow(2), 0, 3, "方法说明:" + method.getMethodComment());
// 参数
if(method.getParams() == null || method.getParams().isEmpty()) {
this.mergeCell(table.createRow(), 0, 3, "参数:无" );
}else {
this.mergeCell(table.createRow(), 0, 3, "参数:" );
this.setTableRowText(table.createRow(), 0, 3, "序号","参数类型","参数名","说明");
this.setCellWidth(table.getRow(table.getRows().size()-1), 0, 3, "10%","25%","25%","40%");
for(int i = 0;i < method.getParams().size(); i++) {
FieldComment field = method.getParams().get(i);
this.setTableRowText(table.createRow(), 0, 3, String.valueOf(i + 1)
,field.getSimpleClassName()
,field.getFieldName()
,field.getFieldComment());
}
}
// 返回值
this.mergeCell(table.createRow(), 0, 3, "返回值:" + method.getReturnEntity().getSimpleClassName() + " " + method.getMethodComment());
this.newBlankLine(xwpfDocument);
this.newBlankLine(xwpfDocument);
}
}
this.newBlankLine(xwpfDocument);
this.newBlankLine(xwpfDocument);
this.newBlankLine(xwpfDocument);
this.newBlankLine(xwpfDocument); }
this.writeFile(xwpfDocument, path);
} /**
* 设置单元格宽度
* @param row
* @param startCell 起始单元格下标,row的单元格下标从0开始
* @param endCell 结束单元格下标
* @param percentages 各个单元格的百分百大小,例如"25.5%"
* */
private void setCellWidth(XWPFTableRow row,int startCell,int endCell,String ...percentages) {
if(percentages == null || percentages.length <= 0) {
throw new IllegalArgumentException("percentages不能为空");
}
if((endCell - startCell + 1) > percentages.length) {
throw new IllegalArgumentException("percentages的元素不够");
}
int i = 0;
for(XWPFTableCell cell: row.getTableCells()) {
cell.setWidth(String.valueOf(percentages[i++]));
cell.setWidthType(TableWidthType.PCT);
}
} /**
* 设置单元格宽度
* @param row
* @param startCell 起始单元格下标,row的单元格下标从0开始
* @param endCell 结束单元格下标
* @param sizes 各个单元格的宽度大小
* */
@SuppressWarnings("unused")
private void setCellWidth(XWPFTableRow row,int startCell,int endCell,int ...sizes) {
if(sizes == null || sizes.length <= 0) {
throw new IllegalArgumentException("sizes不能为空");
}
if((endCell - startCell + 1) > sizes.length) {
throw new IllegalArgumentException("sizes的元素不够");
}
int i = 0;
for(XWPFTableCell cell: row.getTableCells()) {
cell.setWidth(String.valueOf(sizes[i++]));
cell.setWidthType(TableWidthType.DXA);
}
} /**
* 跨行合并单元格
* @param table
* @param startRow 起始行下标,table的行下标从0开始
* @param endRow 结束行下标
* @param startCell 行内起始单元格下标,row的单元格下标从0开始
* @param endCell 行内结束单元格下标
* @param text 合并后的单元格文本
* */
@SuppressWarnings("unused")
private void mergeRow(XWPFTable table,int startRow,int endRow,int startCell,int endCell,String text) {
List<XWPFTableRow> rows = table.getRows();
for (int j = startRow; j <= endRow; j++) {
List<XWPFTableCell> tableCells = rows.get(j).getTableCells();
// 对每个单元格进行 *** 作
for (int i = startCell; i <= endCell; i++) {
//对单元格进行合并的时候,要标志单元格是否为起点,或者是否为继续合并
if (i == startCell )
tableCells.get(i).getCTTc().addNewTcPr().addNewHMerge().setVal(STMerge.RESTART);
else
tableCells.get(i).getCTTc().addNewTcPr().addNewHMerge().setVal(STMerge.CONTINUE);//继续合并
}
}
for (int j = startRow; j <= endRow; j++) {
List<XWPFTableCell> tableCells = rows.get(j).getTableCells();
// 对每个单元格进行 *** 作
//对单元格进行合并的时候,要标志单元格是否为起点,或者是否为继续合并
if (j == startRow )
tableCells.get(startCell).getCTTc().addNewTcPr().addNewVMerge().setVal(STMerge.RESTART);
else
tableCells.get(startCell).getCTTc().addNewTcPr().addNewVMerge().setVal(STMerge.CONTINUE);//继续合并
}
rows.get(startRow).getCell(startCell).setText(text);//为第1行1到4合并之后的单元格设置内容
} /**
* 合并表格单元格,针对行内的单元格进行合并
* @param row
* @param startCell 起始单元格下标,row的单元格下标从0开始
* @param endCell 结束单元格下标
* @param text 合并后的单元格文本
* */
private void mergeCell(XWPFTableRow row,int startCell,int endCell,String text) {
List<XWPFTableCell> tableCells = row.getTableCells();
// 对每个单元格进行 *** 作
for (int i = startCell; i <= endCell; i++) {
//对单元格进行合并的时候,要标志单元格是否为起点,或者是否为继续合并
if (i == startCell)
tableCells.get(i).getCTTc().addNewTcPr().addNewHMerge().setVal(STMerge.RESTART);
else
tableCells.get(i).getCTTc().addNewTcPr().addNewHMerge().setVal(STMerge.CONTINUE);//继续合并
}
tableCells.get(startCell).setText(text);//为第1行1到4合并之后的单元格设置内容
} /**
* 给表格一行赋值,实际设置值是包括首尾单元格的,例如startCell=0,endCell=2,实际会设置0、1、2这三个单元格
* @param row
* @param startCell 起始单元格下标,row的单元格下标从0开始
* @param endCell 结束单元格下标
* @param texts 单元格的内容,依次赋值
* */
private void setTableRowText(XWPFTableRow row,int startCell,int endCell,String ...texts) {
if(texts == null || texts.length <= 0) {
throw new IllegalArgumentException("texts不能为空");
}
if((endCell - startCell + 1) > texts.length) {
throw new IllegalArgumentException("texts的元素不够");
}
List<XWPFTableCell> tableCells = row.getTableCells();
// 对每个单元格进行 *** 作
for (int i = startCell,j = 0; i <= endCell; i++,j++) {
tableCells.get(i).setText(texts[j]);
}
} /**
* 创建一个table
* @param xwpfDocument
* @param rowNum 行数
* @param colNum 列数
* */
private XWPFTable newTable(XWPFDocument xwpfDocument,int rowNum,int colNum) {
XWPFTable createTable = xwpfDocument.createTable(rowNum, colNum);
createTable.setWidth("100%");
createTable.setWidthType(TableWidthType.PCT);
return createTable;
} /**
* 创建一个文本行
* */
private XWPFParagraph newParagraph(XWPFDocument xwpfDocument,String text) {
XWPFParagraph createParagraph = xwpfDocument.createParagraph();
createParagraph.createRun().setText(text);
return createParagraph;
} /**
* 创建一个空行
* */
private XWPFParagraph newBlankLine(XWPFDocument xwpfDocument) {
return this.newParagraph(xwpfDocument, "");
} /**
* 创建一个word文档
* */
private XWPFDocument newWord() {
XWPFDocument xwpfDocument = new XWPFDocument();
return xwpfDocument;
} /**
* 写文件
* */
private void writeFile(XWPFDocument xwpfDocument,String path) throws Exception {
xwpfDocument.write(new FileOutputStream("C:\\Users\\HongCheng\\Desktop\\1.docx"));
xwpfDocument.close();
}
}
JavaDocReader.java用来验证参数以及调用javadoc.Main类的
package com.hongcheng.javadoc_generator;

import java.util.Collection;
import java.util.LinkedList;
import java.util.List;
import java.util.Map; import com.hongcheng.javadoc_generator.entity.ClassComment;
import com.sun.javadoc.RootDoc;
/**
* java文件doc读取器
* */
public class JavaDocReader { /** 用于接收javadoc解析完成后生成的语法树根节点 */
private MyDoclet doclet = new MyDoclet();
/** 类路径,系统会在类路径下去找一些相关的类文件 */
private List<String> classpath ;
/** java源文件地址。


可以是java源文件的绝对地址,也可以是包名。


只能填写一个, */
private String sourcepath;
/** 是否递归处理子包,只有在sourcepath为包名时才起作用,subpackages不为空是才是true。


默认false */
private boolean isSubpackages = false;
/** 要递归的子包 */
private String subpackages ;
/** 需要处理的类字段可见性,默认公有 */
private Modifier fieldModifier = Modifier.PUBLIC;
/** 需要处理的类方法可见性,默认公有 */
private Modifier methodModifier = Modifier.PUBLIC;
/** jdk的tools.jar的地址 */
private String jdkToolsJarPath = JavaDocReader.class.getResource("/").getPath() + "/tools.jar"; /**
* 构造函数
* @param javaPackage 目标jar包,非空必填
* @param subpackages 需要递归处理的子包,可以为空
* @param classPath 相关的jar包的地址,绝对地址,javaPackage必须要能在这些路径中找到,非空必填
* */
public JavaDocReader(String javaPackage,String subpackages,List<String> classPath) {
this.init(javaPackage, subpackages, classPath, Modifier.PUBLIC, Modifier.PUBLIC);
} /**
* 构造函数
* @param javaPackage 目标jar包,非空必填
* @param subpackages 需要递归处理的子包,可以为空
* @param classPath 相关的jar包的地址,绝对地址,javaPackage必须要能在这些路径中找到,非空必填
* @param fieldModifier 需要处理的类字段可见性,非空
* @param methodModifier 需要处理的类方法可见性,非空
* */
public JavaDocReader(String javaPackage,String subpackages,List<String> classPath
,Modifier fieldModifier,Modifier methodModifier) {
this.init(javaPackage, subpackages, classPath, fieldModifier, methodModifier);
} /**
* 构造函数
* @param javaFilePath java文件地址,非空必填,绝对路径
* @param classpath 源文件中引用的相关类的jar包地址,可选
* */
public JavaDocReader(String javaFilePath,List<String> classpath ) {
this.init(javaFilePath, null, classpath, Modifier.PUBLIC, Modifier.PUBLIC);
} /**
* 构造函数
* @param javaFilePath java文件地址,非空必填,绝对路径
* @param classpath 源文件中引用的相关类的jar包地址,可选
* @param fieldModifier 需要处理的类字段可见性,非空
* @param methodModifier 需要处理的类方法可见性,非空
* */
public JavaDocReader(String javaFilePath,List<String> classpath
,Modifier fieldModifier,Modifier methodModifier) {
this.init(javaFilePath, null, classpath, fieldModifier, methodModifier);
} /**
* 构造函数
* @param sourcepath .java源文件地址,非空。


可以是java源文件的绝对地址,也可以是包名。


<br>
* 如果是java源文件的绝对地址,只能填写一个地址,不能填写多个地址。


<br>
* 如果是包名,该包必须能在classpath下找到,只能填写一个包名<br><br>
* @param classpath 类路径,系统会在类路径下去找一些相关的类文件,可以为空
* @param subpackages 是否递归处理子包,只有在sourcepath为包名时才起作用,可以为空
* @param fieldModifier 需要处理的类字段可见性,非空
* @param methodModifier 需要处理的类方法可见性,非空
* */
private void init(String sourcepath,String subpackages,List<String> classpath
,Modifier fieldModifier,Modifier methodModifier) { this.checkNotEmpty(sourcepath, "目标java文件不能为空");
classpath = this.checkNotEmpty(classpath)?new LinkedList<String>(classpath):new LinkedList<String>();
classpath.add(this.getJdkToolsJarPath()); this.classpath = classpath;
this.sourcepath = sourcepath;
this.subpackages = subpackages;
this.fieldModifier = fieldModifier == null?this.fieldModifier:fieldModifier;
this.methodModifier = methodModifier == null?this.methodModifier:methodModifier;
this.isSubpackages = this.checkNotEmpty(subpackages);
} /**
* 初始化参数
* @return String [] javadoc需要的参数数组
* */
private String [] initAgrs() { List<String> args = new LinkedList<String>();
args.add("-encoding");
args.add("utf-8"); args.add("-doclet");
args.add(MyDoclet.class.getName()); args.add("-docletpath");
args.add(MyDoclet.class.getResource("/").getPath()); if(this.isSubpackages()) {
args.add("-subpackages");
args.add(this.getSubpackages());
} StringBuilder sb = new StringBuilder();
for(String classpath: this.getClasspath()) {
sb.append(classpath).append(";");
}
if(sb.length() > 0) {
sb.deleteCharAt(sb.length() - 1);
}
args.add("-classpath");
args.add(sb.toString()); if(this.fieldModifier == Modifier.PRIVATE || this.methodModifier == Modifier.PRIVATE) {
args.add("-private");
}else if(this.fieldModifier == Modifier.PROTECTED || this.methodModifier == Modifier.PROTECTED) {
args.add("-protected");
}else {
args.add("-public");
} args.add(this.sourcepath); return args.toArray(new String[args.size()]);
} /**
* 执行javadoc,解析源文件
* */
private void executeJavadoc() {
String[] initAgrs = this.initAgrs();
com.sun.tools.javadoc.Main.execute(initAgrs);
} /**
* 获取类注释信息
* @return List<ClassComment>
* */
public List<ClassComment> execute(){
this.executeJavadoc();
RootDoc root = MyDoclet.getRoot();
if(root == null) {
return new LinkedList<ClassComment>();
}
RootClassParser parser = new RootClassParser(this.getFieldModifier(),this.getMethodModifier());
List<ClassComment> parseResult = parser.parse(root);
return parseResult;
} public String getJdkToolsJarPath() {
return jdkToolsJarPath;
} public void setJdkToolsJarPath(String jdkToolsJarPath) {
this.jdkToolsJarPath = jdkToolsJarPath;
} public String getSubpackages() {
return subpackages;
} public void setSubpackages(String subpackages) {
this.subpackages = subpackages;
} public MyDoclet getDoclet() {
return doclet;
} public List<String> getClasspath() {
return classpath;
} public String getSourcepath() {
return sourcepath;
} public boolean isSubpackages() {
return isSubpackages;
} public Modifier getFieldModifier() {
return fieldModifier;
} public Modifier getMethodModifier() {
return methodModifier;
} public void setDoclet(MyDoclet doclet) {
this.doclet = doclet;
} public void setClasspath(List<String> classpath) {
this.classpath = classpath;
} public void setSourcepath(String sourcepath) {
this.sourcepath = sourcepath;
} public void setSubpackages(boolean isSubpackages) {
this.isSubpackages = isSubpackages;
} public void setFieldModifier(Modifier fieldModifier) {
this.fieldModifier = fieldModifier;
} public void setMethodModifier(Modifier methodModifier) {
this.methodModifier = methodModifier;
} @SuppressWarnings("rawtypes")
private void checkNotEmpty(Object arg,String exceptionMsg) {
if(exceptionMsg == null) {
exceptionMsg = "参数不能为空。


";
}
if(arg == null) {
throw new NullPointerException(exceptionMsg);
}
if(arg instanceof String) {
String argStr = (String)arg;
if(argStr.isEmpty()) {
throw new IllegalArgumentException(exceptionMsg);
}
}else if(arg instanceof Collection) {
Collection collection = (Collection)arg;
if(collection.isEmpty()) {
throw new IllegalArgumentException(exceptionMsg);
}
}else if(arg instanceof Map) {
Map map = (Map)arg;
if(map.isEmpty()) {
throw new IllegalArgumentException(exceptionMsg);
}
}
} @SuppressWarnings("rawtypes")
private boolean checkNotEmpty(Object arg) {
if(arg == null) {
return false;
}
if(arg instanceof String) {
String argStr = (String)arg;
if(argStr.isEmpty()) {
return false;
}
}else if(arg instanceof Collection) {
Collection collection = (Collection)arg;
if(collection.isEmpty()) {
return false;
}
}else if(arg instanceof Map) {
Map map = (Map)arg;
if(map.isEmpty()) {
return false;
}
}
return true;
} }

Test.java没啥屁用的测试类,就是来看效果的
package com.hongcheng.javadoc_generator;

import java.util.Collections;
import java.util.List; import com.hongcheng.javadoc_generator.entity.ClassComment; public class Test {
public static void main(String[] args) throws Exception {
String jarPath = "C:\\Users\\HongCheng\\Desktop\\11.jar";
JavaDocReader javaDocReader = new JavaDocReader( "hongcheng.code_generator"
,"hongcheng.code_generator"
,Collections.singletonList(jarPath),Modifier.PRIVATE,Modifier.PUBLIC );
List<ClassComment> execute = javaDocReader.execute(); WordExport wordExport = new WordExport();
wordExport.export(execute,"C:\\Users\\HongCheng\\Desktop\\1.docx");
}
}

这是javadoc的参数,你也可以自己设置

代码上传码云了,相关jar包也在上面

https://gitee.com/1281003978/javadoc_generator

欢迎分享,转载请注明来源:内存溢出

原文地址: https://outofmemory.cn/zaji/586516.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2022-04-12
下一篇 2022-04-12

发表评论

登录后才能评论

评论列表(0条)

保存