wanjia950611
/
smart-doc
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
1,004 Commits 8 Branches 68 Tags 5 MiB
Java 82.4%
HTML 14.9%
JavaScript 2%
CSS 0.7%
Go to file
cqmike a4abc7866f Merge remote-tracking branch 'origin/dev' into dev 2021-11-21 17:26:25 +08:00
.gitee format code and fix CustomField set value lost in formdata. 2021-05-16 12:02:05 +08:00
.github/ISSUE_TEMPLATE update issue templates 2021-07-16 12:42:12 +08:00
css update css href 2020-10-09 15:42:11 +08:00
images add image 2021-11-20 21:58:02 +08:00
screen change dubbo top png 2020-12-27 18:27:41 +08:00
src fix(template): remove default group when default group not has childen 2021-11-21 17:25:52 +08:00
.gitignore init smart-doc 2019-09-10 09:39:04 +08:00
.travis.yml add travis ci config 2020-09-01 23:17:58 +08:00
CHANGELOG.md update CHANGELOG.md 2021-11-18 00:08:26 +08:00
LICENSE Add license 2020-03-17 09:33:23 +08:00
README.md update README.md 2021-11-04 23:49:16 +08:00
README_CN.md update image url 2021-11-20 22:06:21 +08:00
pom.xml supported controller implements interface. 2021-11-14 22:26:04 +08:00

README.md

Smart-Doc Project

maven License number of issues closed closed pull requests java version chinese

Introduce

smart-doc is a tool that supports both JAVA REST API and Apache Dubbo RPC interface document generation. Smart-doc is based on interface source code analysis to generate interface documents, and zero annotation intrusion. You only need to write Javadoc comments when developing, smart-doc can help you generate Markdown or HTML5 document. smart-doc does not need to inject annotations into the code like Swagger.

quick start

Features

  • Zero annotation, zero learning cost, only need to write standard JAVA document comments.
  • Automatic derivation based on source code interface definition, powerful return structure derivation support.
  • Support Spring MVC, Spring Boot, Spring Boot Web Flux (Not support endpoint), Feign.
  • Supports the derivation of asynchronous interface returns such as Callable, Future, CompletableFuture.
  • Support JSR-303 parameter verification specification.
  • Support for automatic generation of request examples based on request parameters.
  • Support for generating JSON return value examples.
  • Support for loading source code from outside the project to generate field comments (including the sources jar package).
  • Support for generating multiple formats of documents: Markdown,HTML5,Asciidoctor,Postman Collection 2.0+,OpenAPI 3.0.
  • Support for exporting error codes and data dictionary codes to API documentation.
  • The debug html5 page fully supports file upload and download testing.
  • Support Apache Dubbo RPC.

Best Practice

smart-doc + Torna form an industry-leading document generation and management solution, using smart-doc to complete Java source code analysis and extract annotations to generate API documents without intrusion, and automatically push the documents to the Torna enterprise-level interface document management platform.

smart-doc+torna

Building

You could build with the following commands. (Java 1.8 is required to build the master branch)

mvn clean install -Dmaven.test.skip=true

TODO

  • Jakarta RS-API 2.x

Who is using

These are only part of the companies using smart-doc, for reference only. If you are using smart-doc, please add your company here to tell us your scenario to make smart-doc better.

IFLYTEK                  

Acknowledgements

Thanks to JetBrains SoftWare for providing free Open Source license for this open source project.

License

Smart-doc is under the Apache 2.0 license. See the LICENSE file for details.

Contact

Email： 836575280@qq.com