java编程中使用nodejs的apidoc工具生成Java api文档

位置:首页>文章>详情   分类: 教程分享 > Java教程   阅读(1184)   2024-03-18 14:16:52

java编程中使用nodejs的apidoc工具生成Java api文档,apidoc可以根据代码注释生成web api文档,支持大部分主流语言
1.下载安装nodejs环境,(已安装请忽略)
下载地址:http://nodejs.cn/download/
如果不是很会,推荐下载msi文件格式的,会自动集成到系统中
2.安装apidoc工具
弹出:cmd窗口输入以下命令安装:

npm install apidoc -g

3.创建一些配置和文件夹
 创建一个存放Java源代码的文件夹myapp
 创建一个存放生成api文档的文件夹apidoc
4.创建json配置文件
在存放Java代码的根目录创建apidoc.json

{
  "name": "example",
  "version": "0.1.0",
  "description": "apiDoc basic example",
  "title": "Custom apiDoc browser title",
  "url" : "https://api.github.com/v1"
}


5.执行命令

apidoc -i pathto/myapp/ -o pathto/apidoc/

6.支持的api注释
注释
java example:

package net.xqlee.example

import net.xqlee.common.pojo.Result;

/**
 *测试DOC
 * 
 * @author xqlee
 *
 */
@RestController
public class Example {

	/**
	 * @apiVersion 1.0.0
	 *
	 * @api {get} /apis/example.json 获取验证码
	 * 
	 * @apiName doexample
	 * 
	 * @apiGroup exampleGroup
	 * 
	 * @apiPermission none
	 * 
	 * @apiParam {String} [timeStamp] 时间戳
	 * @apiParam {String} timeStamp2 时间戳2
	 * 
	 * @apiSuccessExample {json} 成功返回值: 
	 * {
			"id": "1be34f4a324c4123b0325ecf0593d70e",
			"data": {
				"image": "iVBORwCCAAAAAAAAAAAAAAAAA=="
			},
			"code": "00000",
			"dateTime": "2017-05-23 14:00:23",
			"msg": null
		}
	 * @apiErrorExample {json} 失败返回值:
	 *{
			"id": "1be34f4a324c4123b0325ecf0593d70e",
			"data": "",
			"code": "EEEEE",
			"dateTime": "2017-05-23 14:00:23",
			"msg": "系统异常"
		}
	 */
	@GetMapping("/apis/validation/getcode.json")
	public Result example(String name,String sex) {
		
		return "{}";

	}
}


7.其他参数参考
http://apidocjs.com/#params

 

地址:https://www.leftso.com/article/101.html

相关阅读

java编程中使用nodejs的apidoc工具生成Java api美观的HTML文档,apidoc可以根据代码注释生成web api文档,支持大部分主流语言
nodejs中http模块使用简单demo
Java编程软件有哪些?常用Java编程软件下载、安装和使用说明
Java编程中Spring Boot整合RabbitMQ实现消息中间件RabbitMQ的使用
java编程之java jwt token使用,autho0的Java-jwt框架使用,java编程,java-jwt
Java编程中纯jdk java方式编写webservice服务(server)和客服端(client)
Java编程之java static关键字,Java编程,static关键字
Java编程中使用POI框架以模板方式导出Excel文件,适合Excel比较复杂的情况
java编程中float或double类型保留2位/n位小数使用BigDecimal进行处理
Map与Java bean之间的转换工具类,用于java.util.Map与普通javabean直接的相互转换,Java编程