JarCasting
JarCasting JarCasting

com.fangdd:doclet-render

Duo-Doc使用javadoc机制，在项目构建期通过代码、注释的解析，抽取RESTful、Dubbo接口信息。可用于接口文档、接口调用、GraphQL Schema生成等用途。

License

License
GroupId

GroupId

com.fangdd
ArtifactId

ArtifactId

doclet-render
Last Version

Last Version

1.0.0
Release Date

Release Date
Type

Type

jar
Description

Description

Duo-Doc使用javadoc机制，在项目构建期通过代码、注释的解析，抽取RESTful、Dubbo接口信息。可用于接口文档、接口调用、GraphQL Schema生成等用途。
Project URL

Project URL

http://doc.duoec.com/doclet-render

Download doclet-render

Filename Size
doclet-render-1.0.0.pom
doclet-render-1.0.0.jar 17 KB
doclet-render-1.0.0-sources.jar 10 KB
doclet-render-1.0.0-javadoc.jar 69 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.fangdd/doclet-render/ -->
<dependency>
    <groupId>com.fangdd</groupId>
    <artifactId>doclet-render</artifactId>
    <version>1.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/com.fangdd/doclet-render/
implementation 'com.fangdd:doclet-render:1.0.0'
// https://jarcasting.com/artifacts/com.fangdd/doclet-render/
implementation ("com.fangdd:doclet-render:1.0.0")
'com.fangdd:doclet-render:jar:1.0.0'
<dependency org="com.fangdd" name="doclet-render" rev="1.0.0">
  <artifact name="doclet-render" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.fangdd', module='doclet-render', version='1.0.0')
)
libraryDependencies += "com.fangdd" % "doclet-render" % "1.0.0"
[com.fangdd/doclet-render "1.0.0"]

Dependencies

compile (2)

Group / Artifact Type Version
com.fangdd : doclet-pojo jar 1.0.0
com.google.guava : guava jar 26.0-jre

Project Modules

There are no modules declared in this project.

自动化文档说明

一、模块说明

本项目分为两部分： doclet插件和文档展示模块

doclet插件

doclet即是自动化文档模块，由三个模块组件：

doclet-pojo：基类，主要是定义文档的基础信息，由JavaBean组成，是一个公共模块

doclet-render：渲染类，主要实现文档数据的渲染，比如渲染成Markdown / Html

doclet: Maven插件的入口，实现了java源文件的解析与文档元素抽取功能

文档展示模块

tp-demo-api：本模块只是作为Dubbo的接口定义模块，不实现任何功能

tp-demo-server：文档的Web展示端，也作为doclet的测试模块。本模块基于spring-boot + freemarker实现的简单网站

二、代码调试

doclet插件有两种调试方法

  1. 代码调试

com.fangdd.tp.doclet.TpDocletTest类里面有一个简单的Doclet类的调试，本方法可以实现断点功能

  1. 插件调试

插件调试直接在tp-doclet/tp-demo-server/pom.xml里面，但需要将doclet插件打包安装后才能使用，此方法不支持断点

使用插件测试时，请先看下代码：com.fangdd.tp.doclet.TpDoclet#start()目前开发环境与发布环境暂未自动化，所以需要调整此方法内的前面几行配置 发布环境默认是生成到10.0.1.86文档服务器的web模式，而开发环境建议使用本地127.0.0.1的'console'模式，即把生成的Markdow打印到控制台

三、注意事项

  1. 目前发布系统不支持拉此插件的SNAPSHOT包，所以发布时暂时以正式包发布。目前会在将数据提交到文档服务器时添加doclet版本信息，未来，如果版本过低时，需要在文档内做明显升级提示

  2. 本开源项目，禁止用于商业用途和专利注册

com.fangdd

fangdd

Open Source of fangdd.com

Versions

Version
1.0.0