博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
单行注释、多行注释与文档注释
阅读量:6407 次
发布时间:2019-06-23

本文共 788 字,大约阅读时间需要 2 分钟。

单行注释:// 注释内容

多行注释:/* 注释内容*/

文档注释:/** 注释内容 */ (它是java语言特有的注释,其中的注释内容可以被JDK提供的工具 javadoc 所解析,生成一套能够以网页形式体现程序的说明文档)

区别:多行注释不可以生成开发者文档,而文档注释可以生成开发者文档(文档分为使用者文档和开发者文档)。

注意规范点:

1、三种注释都可以出现在程序的任何地方,但是一般要有个规范的地方,不推介任意找位置。

2、单行注释一般写在语句的后面。

3、多行注释和文档注释一般写在语句的上面,文档注释只能出现在类、属性、方法的上面,否则提取不到。

4、多行注释中可以嵌套单行注释,多行注释中不能嵌套多行注释。

文档注释的使用(如果一个类想要使用javadoc工具生成开发者文档,那么这个类必须使用public修饰):

在已经成功安装jdk并已经配置好path环境变量的前提下

1、使用dos命令

使用 javadoc 开发工具生成,在命令行下输入javadoc会有一些javadoc使用说明可以看到。我们使用javadoc -d命令,使用格式:javadoc -d 存放路径 java源文件

2、eclipse

使用eclipse就没有这么些问题了,直接创建java类,然后Project-->Generate Javadoc,点击Generate Javadoc后,进入弹出的界面,选择javadoc.exe命令的位置,选择要生成Javadoc的包,或者包下的类,以及生成的Javadoc文档所存的路径,默认生成到当前工程目录下。之后会生成Javadoc文件:在生成文档的目录下会有一堆文件,找到index.html文件,打开查看具体的内容就ok

转载于:https://www.cnblogs.com/lansebandaoti/p/9523235.html

你可能感兴趣的文章
Java多线程学习(吐血超详细总结)
查看>>
css3 变形
查看>>
Win7 64bit 安装Mysql5 出错 无法启动服务。
查看>>
嵌入式 H264参数语法文档: SPS、PPS、IDR以及NALU编码规律
查看>>
初识Opserver,StackExchange的监控解决方案
查看>>
给大家讲解一下JavaScript与后台Java天衣无缝相结合
查看>>
探索HTML5之本地文件系统API - File System API
查看>>
javascript有用代码块(1)
查看>>
libevent 笔记
查看>>
PHP实现人人OAuth登录和API调用
查看>>
redis源码笔记 - initServer
查看>>
FindBugs工具常见问题
查看>>
ECSHOP报错误Deprecated: preg_replace(): The /e modifier is depr
查看>>
【iOS】iOS之Button segue弹出popOver消除(dismiss)问题
查看>>
java多线程系列5-死锁与线程间通信
查看>>
数据库分库分表
查看>>
腾讯Hermes设计概要——数据分析用的是列存储,词典文件前缀压缩,倒排文件递增id、变长压缩、依然是跳表-本质是lucene啊...
查看>>
ARP协议(1)什么是ARP协议
查看>>
小程序模板嵌套以及相关遍历数据绑定
查看>>
Systemd入门教程:命令篇(转)
查看>>