Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
A
apidoc
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Service Desk
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Operations
Operations
Incidents
Environments
Analytics
Analytics
CI / CD
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
duanledexianxianxian
apidoc
Commits
34c5d0a5
Commit
34c5d0a5
authored
Jul 28, 2020
by
duanledexianxianxian
😁
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
添加文档文件
parent
678ef8b4
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
1 addition
and
47 deletions
+1
-47
README.md
README.md
+1
-47
No files found.
README.md
View file @
34c5d0a5
# 🐷 Apigcc - 非侵入的RestDoc文档生成工具
待补充
\ No newline at end of file
![](
https://img.shields.io/badge/Language-Java-yellow.svg
)
### 前言
程序员一直以来都有一个烦恼,只想写代码,不想写文档。代码就表达了我的思想和灵魂。
Python提出了一个方案,叫
**docstring**
,来试图解决这个问题。即编写代码,同时也能写出文档,保持代码和文档的一致。docstring说白了就是一堆代码中的注释。Python的docstring可以通过help函数直接输出一份有格式的文档,本工具的思想与此类似。
### 代码即文档
Apigcc是一个
**非侵入**
的RestDoc文档生成工具。工具通过分析代码和注释,获取文档信息,生成RestDoc文档。
### 有这样一段代码
```
java
/**
* 欢迎使用Apigcc
* @index 1
*/
@RestController
public
class
HelloController
{
/**
* 示例接口
* @param name 名称
* @return
*/
@RequestMapping
(
"/greeting"
)
public
HelloDTO
greeting
(
@RequestParam
(
defaultValue
=
"apigcc"
)
String
name
)
{
return
new
HelloDTO
(
"hello "
+
name
);
}
}
```
### 生成文档效果
![
示例
](
https://apigcc-1252473972.cos.ap-shanghai.myqcloud.com/apigcc-hub-demo.png
)
### 使用方式
[
Hub
](
https://github.com/apigcc/apigcc-hub
)
[
Gradle插件
](
https://github.com/apigcc/apigcc-gradle-plugin
)
[
Maven插件
](
https://github.com/apigcc/apigcc-maven-plugin
)
\ No newline at end of file
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment