JAVA 文档注释


1. 生成文档   

/**  苍井空哈萨克福建省

*可是大家都

*能看出的看法被说哭

*/

2.   多行注释

/*  的巴萨后方可

*你们都是比翻书不麻烦

*们,阿萨德

*/

3. 单行注释

//角度看撒

//才能不仔细看

 

 

完毕。

 

### Java 文档注释的编写方式 Java文档注释是一种特殊的注释形式,用于描述类、接口、方法以及字段等内容。这些注释可以通过 JDK 自带的 Javadoc 工具提取出来,生成结构化的 API 文档。 #### 1. 文档注释的基本格式 文档注释以 `/**` 开始,并以 `*/` 结束[^3]。它通常位于被注释的内容之前,例如类、方法或变量前。以下是基本语法: ```java /** * 这里是文档注释的内容。 */ public class Example { public static void main(String[] args) { System.out.println("Hello, World!"); } } ``` #### 2. 常见标签及其用途 为了增强文档的功能性和可读性,可以在文档注释中使用特定的标签。常见的标签包括但不限于以下几种: - **@author**: 表明作者的名字。 - **@version**: 定义版本号。 - **@param**: 描述方法参数的意义。 - **@return**: 阐述方法返回值的信息。 - **@throws/@exception**: 指定可能抛出的异常类型及原因。 - **@see**: 提供额外的相关链接或参考信息。 下面是一个完整的例子,展示了如何利用上述标签来撰写详细的文档注释: ```java /** * This is a simple calculator that adds two integers. * * @author John Doe * @version 1.0 */ public class Calculator { /** * Adds two integer values and returns the result. * * @param num1 The first number to be added. * @param num2 The second number to be added. * @return The sum of num1 and num2. * @throws IllegalArgumentException If either input parameter is null or invalid. */ public int add(int num1, int num2) throws IllegalArgumentException { if (num1 < Integer.MIN_VALUE || num2 < Integer.MIN_VALUE) { throw new IllegalArgumentException("Input parameters cannot be less than minimum value."); } return num1 + num2; } /** * Prints out a greeting message with specified name. * * @param name Name of the person being greeted. */ public void greet(String name) { System.out.println("Hello, " + name); } } ``` #### 3. 使用 Javadoc 工具生成文档 一旦完成带有适当文档注释的源代码后,就可以借助 Javadoc 工具将其转换为 HTML 格式的帮助文档。具体操作步骤如下所示(基于命令行环境)[^2]: 假设有一个名为 `Calculator.java` 的文件,则可通过运行以下命令生成对应的文档: ```bash javadoc -d docs Calculator.java ``` 此命令会将生成的结果存储到当前目录下的 `docs` 文件夹中。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值