生成JavaDoc文档

生成 JavaDoc 文档

1、快速生成 文档 注解

2、常见的文档注解

3、脚本生成 doc 文档

4、IDEA工具栏生成 doc 文档

第一章 快速入门

第01节 使用插件

在插件工具当中,找到插件 javaDoc

使用方式,在代码区域,直接点击右键。选择

第02节 常用注解

作用在 类或者接口 上面

注解名称 使用案例 详细说明
author @author cosmo 作者 cosmo
version @version 1.0 版本 1.0
apiNote @apiNote API 介绍

作用在方法上

注解名称 使用案例 详细说明
author @author cosmo 作者 cosmo
version @version 1.0 版本 1.0
return @return 返回值介绍
param @param 参数介绍
throws @throws 异常说明

其他注解

注解名称 使用案例 详细说明
see @see 引用其他类、接口、方法、文档
since @since 说明该 类、方法、或者字段 从哪个版本开始引入
link @link 连接某个地址或者类 接口 方法
deprecated @deprecated 标记已经过时的方法或者类
code @code 某个代码片段

第03节 生成文档的效果

第二章 快速脚本

第01节 脚本代码

bash 复制代码
@echo off   
setlocal enabledelayedexpansion

:: 只需要修改当前项目所在的目录、匹配上 src 路径和包名称的根路径
set "ROOT_PATH=D:\workspace\demo04\XCPP"
set "srcPath=%ROOT_PATH%\src"
set "packageName=com"
:: -------------------------------------------------------------
set "docPath=.\docs" 
:: =============================================================


:: 检查Java环境是否已配置   
where java >nul 2>&1   
if %errorlevel% neq 0 (
    echo error:not found Java Environment,please install and configure Java first。
    pause
    exit /b 1   
)
   
:: 检查Javadoc是否可用   
where javadoc >nul 2>&1   
if %errorlevel% neq 0 (
    echo Error: Javadoc tool not found, please ensure JDK is installed
    pause
    exit /b 1   
)


:: 删除之前旧的 docs 文件夹  
if exist "%docPath%" (  
	echo delete old docs 
    rmdir /s /q "%docPath%"       
)


:: 执行 Javadoc 命令   
echo Generating Javadoc....
javadoc -encoding UTF-8 -charset UTF-8 -d  %docPath% -sourcepath %srcPath% -subpackages %packageName%
   
if %errorlevel% equ 0 (
	echo -------------------------------------------------------------
   	echo Javadoc Successfully generated, document located at: %docPath%
    echo -------------------------------------------------------------
) else (
    echo Javadoc Generation failed, please check the command or path.
)
   
pause   
endlocal

第02节 后续说明

在脚本代码当中,需要修改以下几点:

修改项 说明 是否必填
ROOT_PATH 项目的绝对路径 是(建议根据实际情况修改)
srcPath src 文件夹的路径 是(根据项目不同 src 的相对项目路径不一致,是需要进行修改的)
packageName 一级包的路径 是(目前默认的一级包路径是 com 后面根据实际需求来确定)
docPath 生成DOC文档的路径 否(目前是生成在当前脚本,所在的目录下面,是否在其他位置,根据实际需求来确定)

第03节 系统工具类

在系统工具栏上面,可以直接生成 doc 文档。

相关推荐
茶本无香21 分钟前
RequestContextFilter介绍
java·spring·filter·requestcontext
iナナ35 分钟前
初识JVM
java·jvm
m0_570466411 小时前
代码随想录算法训练营第二十八天 | 买卖股票的最佳实际、跳跃游戏、K次取反后最大化的数组和
java·开发语言·算法
ST.J2 小时前
swing笔记
java·笔记
菩提树下的凡夫2 小时前
瑞芯微RV1126目标识别算法Yolov8的部署应用
java·算法·yolo
爱隐身的官人2 小时前
新后端漏洞(上)- Java RMI Registry反序列化漏洞
java·反序列化漏洞
叫我阿柒啊2 小时前
从Java全栈到前端框架:一次真实的面试对话与技术解析
java·javascript·typescript·vue·springboot·react·前端开发
晚安里2 小时前
Spring 框架(IoC、AOP、Spring Boot) 的必会知识点汇总
java·spring boot·spring
爱隐身的官人2 小时前
新后端漏洞(上)- Aapache Tomcat AJP 文件包含漏洞(CVE-2020-1938)
java·tomcat·ajp
@CLoudbays_Martin112 小时前
为什么动态视频业务内容不可以被CDN静态缓存?
java·运维·服务器·javascript·网络·python·php