java多行注释_Java注释:单行、多行和文档注释
注释是对程序语言的说明,有助于开发者和用户之间的交流,方便理解程序。注释不是编程语句,因此被编译器忽略。
Java支持以下三种注释方式:
1)单行注释
以双斜杠“//”标识,只能注释一行内容,用在注释信息内容少的地方。打开 Eclipse,在 Java 代码中使用单行注释,如图 1 所示。
图 1 单行注释
2)多行注释
包含在“/*”和“*/”之间,能注释很多行的内容。为了可读性比较好,一般首行和尾行不写注释信息(这样也比较美观好看),如图 2 所示。
注意:多行注释可以嵌套单行注释,但是不能嵌套多行注释和文档注释。
图 2 多行注释
3)文档注释
包含在“/**”和“*/”之间,也能注释多行内容,一般用在类、方法和变量上面,用来描述其作用。注释后,鼠标放在类和变量上面会自动显示出我们注释的内容,如图 3 所示。
注意:文档注释能嵌套单行注释,不能嵌套多行注释和文档注释,一般首行和尾行也不写注释信息。
图 3 文档注释
文档注释可以通过 Javadoc 命令把文档注释中的内容生成文档,并输出到 HTML 文件中,方便记录程序信息。还可以包含一个或多个 @ 标签,每个 @ 标签都在新的一行开始。Javadoc 工具识别的标签如下表所示:标签描述示例
@author标识一个类的作者@author description
@deprecated指名一个过期的类或成员@deprecated description
{@docRoot}指明当前文档根目录的路径Directory Path
@exception标志一个类抛出的异常@exception exception-name explanation
{@inheritDoc}从直接父类继承的注释Inherits a comment from the immediate surperclass.
{@link}插入一个到另一个主题的链接{@link name text}
{@linkplain}插入一个到另一个主题的链接,但是该链接显示纯文本字体Inserts an in-line link to another topic.
@param说明一个方法的参数@param parameter-name explanation
@return说明返回值类型@return explanation
@see指定一个到另一个主题的链接@see anchor
@serial说明一个序列化属性@serial description
@serialData说明通过 writeObject() 和 writeExternal() 方法写的数据@serialData description
@serialField说明一个 ObjectStreamField 组件@serialField name type description
@since标记当引入一个特定的变化时@since release
@throws和 @exception 标签一样.The @throws tag has the same meaning as the @exception tag.
{@value}显示常量的值,该常量必须是 static 属性。Displays the value of a constant, which must be a static field.
@version指定类的版本@version info
在 Java 中,一行注释以双斜杠“//”标识;多行注释包含在“/*”和“*/”之间;文档注释包含在“/**”和“*/”之间。当编译器执行到“//”时,就会忽略该行“//”之后的所有文本;当执行到“/*”时,会扫描下一个“*/”并忽略“/*”和“*/”之间的任何文本;当执行到“/**”时,也会扫描下一个“*/”并忽略“/**”和“*/”之间的任何文本内容。
本文来自投稿,不代表访得立场,如若转载,请注明出处:http://www.found5.com//view/1179.html
java多行注释_Java注释:单行、多行和文档注释相关推荐
- 【Java注释:单行 多行 文档注释】
Java注释:单行 多行 文档注释 注释是程序语言的说明,它有助于开发者之间的交流,方便解释程序. 注释在程序语言中不会被视作代码,不会执行,而被编译器忽视. Java中,注释可分为三类 1.单行注释 ...
- Java注释:单行、多行和文档注释
注释是对程序语言的说明,有助于开发者和用户之间的交流,方便理解程序.注释不是编程语句,因此被编译器忽略. Java 支持以下三种注释方式: 1)单行注释 以双斜杠"//"标识,只能 ...
- Swift 注释规范和文档注释
目录 普通注释 结构性或者功能提示: MARK.TODO.FIXME 编译器提示 文档注释 Playground注释 今天,我知道我写是什么,上帝和我知道 明天,我知道这个代码什么意思 ...
- java页码_Java 添加页码到PDF文档
本文介绍通过Java程序来添加页码到PDF文档的方法. 使用工具:Free Spire.PDF for Java (免费版) Jar文件获取及导入: 方法1:可通过官网 方法2:可通过 Java代码示 ...
- javav转义字符“\”和文档注释//
第二天学习 1.转义字符 第六个北京会替换掉韩顺,\r会将光标移到第一个字符 2.文档注释
- Eclipse文档注释快捷键以及自定义文档注释内容
文档注释快捷键 shift+alt+j 自定义文档注释 打开Eclipse--Window--Perference--Java--Code Style--Code Templates--Comment ...
- java计算器注释_java计算器实现,百行代码,清晰注释
写安卓写了三年有余了吧!今天无聊,在网上看看安卓的计算器居然没有一个实现的好的,真实让人心寒啊! 闲着无聊,我也写了一个java实现计算器,代码简单易懂,稍微有那么点不好懂的我都写了详细的注释的! 那 ...
- 以太坊java接口_java以太坊库web3j文档
通过java打包以太坊智能合约 Web3j可以自动打包智能合同代码,以便在不脱离JVM的情况下进行以太坊智能合同部署和交互. 要打包代码,需要先编译智能合同: $ solc .sol --bin -- ...
- java飞机大战编程_[源码和文档分享]Java飞机大战游戏设计与实现
1 概述 本次Java课程设计是做一个飞机大战的游戏,应用Swing编程,完成一个界面简洁流畅.游戏方式简单,玩起来易于上手的桌面游戏.该飞机大战项目运用的主要技术即是Swing编程中的一些窗口类库. ...
- java rpg对战_[源码和文档分享]基于java的RPG回合制游戏
一.工作积累总结 该项目是一个回合制RPG游戏,讲述了动物主角对抗人类,自逃出动物园开始,一路与人类对抗,提升能力,并寻找新队友组成团体,逼得人类不得不与之谈判,最终与人类达成了和平协议的故事.玩家可 ...
最新文章
- qt能使用logback_Spring boot使用logback实现日志配置
- inode与block详解
- oracle 恢复dmp文件时,创建 tablespace user
- K-Median Subsequence
- 逆向-002-iOS重签名
- 12v小型电机型号大全_电机型号参数大全,再不怕看不懂型号了
- Struts2(补充)
- surf算子匹配物体
- mysql存储过程返回结果集_原来MySQL的存储过程也可以这么玩?
- Unity3d设置成中文版
- 密码学应用的四个进化阶段
- 假设有一台多道程序的计算机,某多道程序设计系统配有一台处理器和两台外设101、102,现有3个优先级由高到低的作业J1、J2、J3都已 - 试题答案网问答...
- 【音乐】基于matlab演奏《天空之城》【含Matlab源码 1874期】
- 空间点集的三角剖分工具——四面体生成器(TetGen)和三维三角剖分包(CGAL)
- PR剪辑-电子相册学习笔记
- java电商项目搭建-------分布式文件存储系统(fastDFS)
- [Codeforces757E]Bash Plays with Functions数学
- CleanMyMac X2023Mac电脑空间内存清理工具
- 【简易版】知网下载PDF硕博论文
- java 随机生成不重复的数字_生成8位随机不重复的数字编号的方法