全国旗舰校区

不同学习城市 同样授课品质

北京

深圳

上海

广州

郑州

大连

武汉

成都

西安

杭州

青岛

重庆

长沙

哈尔滨

南京

太原

沈阳

合肥

贵阳

济南

下一个校区
就在你家门口
+
当前位置:首页  >  技术干货

java注释:单行、多行和文档注释

发布时间:2023-06-09 12:59:00
发布人:yyy

  在 Java 中,有三种常用的注释形式:单行注释、多行注释和文档注释。

  1. 单行注释:以双斜线 (`//`) 开始,用于在一行内注释单个语句或说明代码的含义。

java
// 这是一个单行注释
int x = 5; // 初始化变量 x

   2. 多行注释:以斜线加星号 (`/*`) 开始,以星号加斜线 (`*/`) 结束,用于注释多行代码或较长的说明。 

java
/*
这是一个多行注释
它可以跨越多行,用于注释多个语句或一段代码
*/
int x = 5;
int y = 10;

   3. 文档注释:以斜线加星号加两个星号 (`/**`) 开始,以星号加斜线 (`*/`) 结束,用于为类、方法、字段等编写详细的文档说明。文档注释可以通过工具生成文档,如使用 `javadoc` 工具生成 API 文档。

java
/**
* 这是一个文档注释
* 用于对类、方法、字段等进行详细的文档说明
*/
public class MyClass {
/**
* 这是一个方法的文档注释
* @param x 参数 x
* @param y 参数 y
* @return 返回结果
*/
public int add(int x, int y) {
return x + y;
}
}

   文档注释使用特殊的标记(`@`)和标记名称,例如 `@param` 用于描述方法的参数,`@return` 用于描述方法的返回值。通过在代码中使用文档注释,可以为其他开发人员提供清晰的代码文档和使用说明。

  注意,注释是用于解释代码和提供文档,不会被编译器编译和执行。注释不会对程序的运行产生任何影响,仅供开发人员阅读和理解代码。

#java注释

相关文章

什么是中台?

什么是中台?

2023-10-15
什么是位置参数?

什么是位置参数?

2023-10-15
什么是PLC?

什么是PLC?

2023-10-15
服务器、虚拟主机、空间、域名分别是什么?

服务器、虚拟主机、空间、域名分别是什么?

2023-10-15

最新文章

常见网络安全面试题:Windows常用的命令有哪些?

常见网络安全面试题:Windows常用的命令有哪些?

2023-10-09
常见网络安全面试题:根据设备告警如何展开排查?

常见网络安全面试题:根据设备告警如何展开排查?

2023-10-09
常见网络安全面试题:mysql加固呢?(数据库加固)

常见网络安全面试题:mysql加固呢?(数据库加固)

2023-10-09
常见网络安全面试题:windows和linux加固?(操作系统加固)

常见网络安全面试题:windows和linux加固?(操作系统加固)

2023-10-09
在线咨询 免费试学 教程领取