龙空技术网

Java文档的简要介绍和快速生成

py今晚打老虎 398

前言:

此刻朋友们对“javadoc模板”可能比较注重,各位老铁们都需要了解一些“javadoc模板”的相关文章。那么小编也在网络上网罗了一些有关“javadoc模板””的相关知识,希望朋友们能喜欢,各位老铁们一起来学习一下吧!

在开发中遇到问题,开发人员都是习惯性的去查阅相关手册,通俗来说就是注释文档。当我们在实际工作中封装了相关的函数方法,便于其他人使用则采用文档注释的方法。

要达成这种效果其实蛮简单的,利用java有自带的工具javadoc

先来写个小例子;

写好相关的工具类,并写好注释(注意:类的修饰符要用public 使用最大权限。且private修饰的方法无法注释)

@author 作者 @version 版本 @param 参数 @return 返回值

2.打开cmd窗口,找到classs文件路径,并输入相关执行参数

javadoc -d Mydoc -author -version ArrayTools.java (1.-d表示生成文件路径 2.Mydoc表示生成文档所在文件夹 3.-author作者 4.version版本 5.ArrayTools.java表示对该类进行文档注释)

3.执行完成效果如下 打开index.html:

这样完成后,其他开发人员想要使用你所写的方法就可以清晰的知道需要传哪些参数,返回什么值。当然这算是一种友好的行为。

标签: #javadoc模板 #java官方文档如何阅读 #java教程文档