upgrade 1.7.5
This commit is contained in:
parent
250b0189a8
commit
bc5dd886b0
11
README.md
11
README.md
|
@ -28,13 +28,13 @@ which looks a html like generated by `asciidoctor-maven-plugin` plugin.
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.github.shalousun</groupId>
|
<groupId>com.github.shalousun</groupId>
|
||||||
<artifactId>smart-doc</artifactId>
|
<artifactId>smart-doc</artifactId>
|
||||||
<version>1.7.4</version>
|
<version>1.7.5</version>
|
||||||
<scope>test</scope>
|
<scope>test</scope>
|
||||||
</dependency>
|
</dependency>
|
||||||
```
|
```
|
||||||
#### gradle
|
#### gradle
|
||||||
```
|
```
|
||||||
testCompile 'com.github.shalousun:smart-doc:1.7.4'
|
testCompile 'com.github.shalousun:smart-doc:1.7.5'
|
||||||
```
|
```
|
||||||
### Create a unit test
|
### Create a unit test
|
||||||
Just running a unit test will allow Smart-doc to generate a very concise api document for you,
|
Just running a unit test will allow Smart-doc to generate a very concise api document for you,
|
||||||
|
@ -95,6 +95,13 @@ public class ApiDocTest {
|
||||||
RevisionLog.getLog().setRevisionTime("2018/12/15").setAuthor("chen").setRemarks("test").setStatus("create").setVersion("V1.0"),
|
RevisionLog.getLog().setRevisionTime("2018/12/15").setAuthor("chen").setRemarks("test").setStatus("create").setVersion("V1.0"),
|
||||||
RevisionLog.getLog().setRevisionTime("2018/12/16").setAuthor("chen2").setRemarks("test2").setStatus("update").setVersion("V2.0")
|
RevisionLog.getLog().setRevisionTime("2018/12/16").setAuthor("chen2").setRemarks("test2").setStatus("update").setVersion("V2.0")
|
||||||
);
|
);
|
||||||
|
|
||||||
|
//since 1.7.5
|
||||||
|
//add data dictionary
|
||||||
|
config.setDataDictionaries(
|
||||||
|
ApiDataDictionary.dict().setTitle("Order status").setEnumClass(OrderEnum.class).setValueField("code").setDescField("desc"),
|
||||||
|
ApiDataDictionary.dict().setTitle("Order status1").setEnumClass(OrderEnum.class).setValueField("code").setDescField("desc")
|
||||||
|
);
|
||||||
|
|
||||||
long start = System.currentTimeMillis();
|
long start = System.currentTimeMillis();
|
||||||
//Generating Markdown documentation
|
//Generating Markdown documentation
|
||||||
|
|
11
README_CN.md
11
README_CN.md
|
@ -29,13 +29,13 @@ smart-doc使用和测试可参考[smart-doc demo](https://gitee.com/sunyureposit
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.github.shalousun</groupId>
|
<groupId>com.github.shalousun</groupId>
|
||||||
<artifactId>smart-doc</artifactId>
|
<artifactId>smart-doc</artifactId>
|
||||||
<version>1.7.4</version>
|
<version>1.7.5</version>
|
||||||
<scope>test</scope>
|
<scope>test</scope>
|
||||||
</dependency>
|
</dependency>
|
||||||
```
|
```
|
||||||
#### gradle
|
#### gradle
|
||||||
```
|
```
|
||||||
testCompile 'com.github.shalousun:smart-doc:1.7.4'
|
testCompile 'com.github.shalousun:smart-doc:1.7.5'
|
||||||
```
|
```
|
||||||
### Create a unit test
|
### Create a unit test
|
||||||
通过运行一个单元测试来让Smart-doc为你生成一个简洁明了的api文档
|
通过运行一个单元测试来让Smart-doc为你生成一个简洁明了的api文档
|
||||||
|
@ -109,6 +109,13 @@ public class ApiDocTest {
|
||||||
RevisionLog.getLog().setRevisionTime("2018/12/15").setAuthor("chen").setRemarks("测试").setStatus("创建").setVersion("V1.0"),
|
RevisionLog.getLog().setRevisionTime("2018/12/15").setAuthor("chen").setRemarks("测试").setStatus("创建").setVersion("V1.0"),
|
||||||
RevisionLog.getLog().setRevisionTime("2018/12/16").setAuthor("chen2").setRemarks("测试2").setStatus("修改").setVersion("V2.0")
|
RevisionLog.getLog().setRevisionTime("2018/12/16").setAuthor("chen2").setRemarks("测试2").setStatus("修改").setVersion("V2.0")
|
||||||
);
|
);
|
||||||
|
|
||||||
|
//since 1.7.5
|
||||||
|
//文档添加数据字典
|
||||||
|
config.setDataDictionaries(
|
||||||
|
ApiDataDictionary.dict().setTitle("订单状态").setEnumClass(OrderEnum.class).setValueField("code").setDescField("desc"),
|
||||||
|
ApiDataDictionary.dict().setTitle("订单状态1").setEnumClass(OrderEnum.class).setValueField("code").setDescField("desc")
|
||||||
|
);
|
||||||
|
|
||||||
|
|
||||||
long start = System.currentTimeMillis();
|
long start = System.currentTimeMillis();
|
||||||
|
|
4
pom.xml
4
pom.xml
|
@ -5,7 +5,7 @@
|
||||||
<modelVersion>4.0.0</modelVersion>
|
<modelVersion>4.0.0</modelVersion>
|
||||||
<artifactId>smart-doc</artifactId>
|
<artifactId>smart-doc</artifactId>
|
||||||
<packaging>jar</packaging>
|
<packaging>jar</packaging>
|
||||||
<version>1.7.4</version>
|
<version>1.7.5</version>
|
||||||
|
|
||||||
<name>smart-doc</name>
|
<name>smart-doc</name>
|
||||||
<url>https://github.com/shalousun/smart-doc.git</url>
|
<url>https://github.com/shalousun/smart-doc.git</url>
|
||||||
|
@ -59,7 +59,7 @@
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>com.github.shalousun</groupId>
|
<groupId>com.github.shalousun</groupId>
|
||||||
<artifactId>common-util</artifactId>
|
<artifactId>common-util</artifactId>
|
||||||
<version>1.8.7</version>
|
<version>1.8.8</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
<!--markdown to html-->
|
<!--markdown to html-->
|
||||||
<dependency>
|
<dependency>
|
||||||
|
|
|
@ -172,11 +172,11 @@ public class DocBuilderTemplate {
|
||||||
* @return list of ApiDocDict
|
* @return list of ApiDocDict
|
||||||
*/
|
*/
|
||||||
public List<ApiDocDict> buildDictionary(ApiConfig config) {
|
public List<ApiDocDict> buildDictionary(ApiConfig config) {
|
||||||
List<ApiDataDictConfig> apiDataDictionaryList = config.getDataDictConfigs();
|
List<ApiDataDictionary> apiDataDictionaryList = config.getDataDictionaries();
|
||||||
List<ApiDocDict> apiDocDictList = new ArrayList<>();
|
List<ApiDocDict> apiDocDictList = new ArrayList<>();
|
||||||
try {
|
try {
|
||||||
int order = 0;
|
int order = 0;
|
||||||
for (ApiDataDictConfig apiDataDictionary : apiDataDictionaryList) {
|
for (ApiDataDictionary apiDataDictionary : apiDataDictionaryList) {
|
||||||
order++;
|
order++;
|
||||||
ApiDocDict apiDocDict = new ApiDocDict();
|
ApiDocDict apiDocDict = new ApiDocDict();
|
||||||
apiDocDict.setOrder(order);
|
apiDocDict.setOrder(order);
|
||||||
|
|
|
@ -268,7 +268,7 @@ public class SourceBuilder {
|
||||||
if (null != method.getTagByName(IGNORE_TAG)) {
|
if (null != method.getTagByName(IGNORE_TAG)) {
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
url = url.replaceAll("\"", "").trim();
|
url = StringUtil.removeQuotes(url);
|
||||||
apiMethodDoc.setType(methodType);
|
apiMethodDoc.setType(methodType);
|
||||||
url = this.appUrl + "/" + baseUrl + "/" + url;
|
url = this.appUrl + "/" + baseUrl + "/" + url;
|
||||||
apiMethodDoc.setUrl(UrlUtil.simplifyUrl(url));
|
apiMethodDoc.setUrl(UrlUtil.simplifyUrl(url));
|
||||||
|
@ -918,7 +918,6 @@ public class SourceBuilder {
|
||||||
}
|
}
|
||||||
boolean containsBrace = apiMethodDoc.getUrl().contains("{");
|
boolean containsBrace = apiMethodDoc.getUrl().contains("{");
|
||||||
Map<String, String> paramsMap = new LinkedHashMap<>();
|
Map<String, String> paramsMap = new LinkedHashMap<>();
|
||||||
boolean hasFile = false;
|
|
||||||
for (JavaParameter parameter : parameterList) {
|
for (JavaParameter parameter : parameterList) {
|
||||||
JavaType javaType = parameter.getType();
|
JavaType javaType = parameter.getType();
|
||||||
String simpleTypeName = javaType.getValue();
|
String simpleTypeName = javaType.getValue();
|
||||||
|
|
|
@ -94,7 +94,7 @@ public class ApiConfig {
|
||||||
/**
|
/**
|
||||||
* api data dictionary
|
* api data dictionary
|
||||||
*/
|
*/
|
||||||
private List<ApiDataDictConfig> dataDictConfigs;
|
private List<ApiDataDictionary> dataDictionaries;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @since 1.7.5
|
* @since 1.7.5
|
||||||
|
@ -209,12 +209,12 @@ public class ApiConfig {
|
||||||
this.adoc = adoc;
|
this.adoc = adoc;
|
||||||
}
|
}
|
||||||
|
|
||||||
public List<ApiDataDictConfig> getDataDictConfigs() {
|
public List<ApiDataDictionary> getDataDictionaries() {
|
||||||
return dataDictConfigs;
|
return dataDictionaries;
|
||||||
}
|
}
|
||||||
|
|
||||||
public void setDataDictConfigs(ApiDataDictConfig... dataDictConfigs) {
|
public void setDataDictionaries(ApiDataDictionary... dataDictConfigs) {
|
||||||
this.dataDictConfigs = CollectionUtil.asList(dataDictConfigs);
|
this.dataDictionaries = CollectionUtil.asList(dataDictConfigs);
|
||||||
}
|
}
|
||||||
|
|
||||||
public boolean isCoverOld() {
|
public boolean isCoverOld() {
|
||||||
|
|
|
@ -3,7 +3,7 @@ package com.power.doc.model;
|
||||||
/**
|
/**
|
||||||
* @author yu 2019/10/31.
|
* @author yu 2019/10/31.
|
||||||
*/
|
*/
|
||||||
public class ApiDataDictConfig {
|
public class ApiDataDictionary {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Dictionary
|
* Dictionary
|
||||||
|
@ -31,15 +31,15 @@ public class ApiDataDictConfig {
|
||||||
private String descField;
|
private String descField;
|
||||||
|
|
||||||
|
|
||||||
public static ApiDataDictConfig dict() {
|
public static ApiDataDictionary dict() {
|
||||||
return new ApiDataDictConfig();
|
return new ApiDataDictionary();
|
||||||
}
|
}
|
||||||
|
|
||||||
public String getTitle() {
|
public String getTitle() {
|
||||||
return title;
|
return title;
|
||||||
}
|
}
|
||||||
|
|
||||||
public ApiDataDictConfig setTitle(String title) {
|
public ApiDataDictionary setTitle(String title) {
|
||||||
this.title = title;
|
this.title = title;
|
||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
@ -48,7 +48,7 @@ public class ApiDataDictConfig {
|
||||||
return enumClass;
|
return enumClass;
|
||||||
}
|
}
|
||||||
|
|
||||||
public ApiDataDictConfig setEnumClass(Class enumClass) {
|
public ApiDataDictionary setEnumClass(Class enumClass) {
|
||||||
this.enumClass = enumClass;
|
this.enumClass = enumClass;
|
||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
@ -57,7 +57,7 @@ public class ApiDataDictConfig {
|
||||||
return valueField;
|
return valueField;
|
||||||
}
|
}
|
||||||
|
|
||||||
public ApiDataDictConfig setValueField(String valueField) {
|
public ApiDataDictionary setValueField(String valueField) {
|
||||||
this.valueField = valueField;
|
this.valueField = valueField;
|
||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
@ -66,7 +66,7 @@ public class ApiDataDictConfig {
|
||||||
return descField;
|
return descField;
|
||||||
}
|
}
|
||||||
|
|
||||||
public ApiDataDictConfig setDescField(String descField) {
|
public ApiDataDictionary setDescField(String descField) {
|
||||||
this.descField = descField;
|
this.descField = descField;
|
||||||
return this;
|
return this;
|
||||||
}
|
}
|
||||||
|
@ -75,7 +75,7 @@ public class ApiDataDictConfig {
|
||||||
return enumClassName;
|
return enumClassName;
|
||||||
}
|
}
|
||||||
|
|
||||||
public ApiDataDictConfig setEnumClassName(String enumClassName) {
|
public ApiDataDictionary setEnumClassName(String enumClassName) {
|
||||||
this.enumClassName = enumClassName;
|
this.enumClassName = enumClassName;
|
||||||
return this;
|
return this;
|
||||||
}
|
}
|
|
@ -95,7 +95,7 @@ for(dict in dictList){
|
||||||
### ${dict.title}
|
### ${dict.title}
|
||||||
|
|
||||||
Code |Type|Description
|
Code |Type|Description
|
||||||
---|---
|
---|---|---
|
||||||
<%
|
<%
|
||||||
for(dataDict in dict.dataDictList){
|
for(dataDict in dict.dataDictList){
|
||||||
%>
|
%>
|
||||||
|
|
|
@ -52,8 +52,8 @@ public class ApiDocTest {
|
||||||
//SourcePath.path().setPath("F:\\Personal\\project\\smart\\src\\main\\java")
|
//SourcePath.path().setPath("F:\\Personal\\project\\smart\\src\\main\\java")
|
||||||
//SourcePath.path().setDesc("加载项目外代码").setPath("E:\\ApplicationPower\\ApplicationPower\\Common-util\\src\\main\\java")
|
//SourcePath.path().setDesc("加载项目外代码").setPath("E:\\ApplicationPower\\ApplicationPower\\Common-util\\src\\main\\java")
|
||||||
);
|
);
|
||||||
config.setDataDictConfigs(
|
config.setDataDictionaries(
|
||||||
ApiDataDictConfig.dict().setTitle("订单字典").setEnumClass(OrderEnum.class).setValueField("code").setDescField("desc")
|
ApiDataDictionary.dict().setTitle("订单字典").setEnumClass(OrderEnum.class).setValueField("code").setDescField("desc")
|
||||||
);
|
);
|
||||||
//设置请求头,如果没有请求头,可以不用设置
|
//设置请求头,如果没有请求头,可以不用设置
|
||||||
/* config.setRequestHeaders(
|
/* config.setRequestHeaders(
|
||||||
|
@ -76,11 +76,11 @@ public class ApiDocTest {
|
||||||
RevisionLog.getLog().setRevisionTime("2018/12/16").setAuthor("chen2").setRemarks("测试2").setStatus("修改").setVersion("V2.0")
|
RevisionLog.getLog().setRevisionTime("2018/12/16").setAuthor("chen2").setRemarks("测试2").setStatus("修改").setVersion("V2.0")
|
||||||
);
|
);
|
||||||
|
|
||||||
List<ApiDataDictConfig> apiDataDictionaryList = config.getDataDictConfigs();
|
List<ApiDataDictionary> apiDataDictionaryList = config.getDataDictionaries();
|
||||||
try {
|
try {
|
||||||
List<ApiDocDict> apiDocDictList = new ArrayList<>();//模板中遍历这个字典表生成字典文档
|
List<ApiDocDict> apiDocDictList = new ArrayList<>();//模板中遍历这个字典表生成字典文档
|
||||||
int order = 0;
|
int order = 0;
|
||||||
for (ApiDataDictConfig apiDataDictionary : apiDataDictionaryList) {
|
for (ApiDataDictionary apiDataDictionary : apiDataDictionaryList) {
|
||||||
System.out.println("dictionary:" + apiDataDictionary.getTitle());
|
System.out.println("dictionary:" + apiDataDictionary.getTitle());
|
||||||
order++;
|
order++;
|
||||||
ApiDocDict apiDocDict = new ApiDocDict();
|
ApiDocDict apiDocDict = new ApiDocDict();
|
||||||
|
|
Loading…
Reference in New Issue