Java注释讲解

简介: 注释1.注释的作用通过注释提高程序的可读性,是java程序的条理更加清晰,易于区分代码行与注释行。

注释

1.注释的作用

通过注释提高程序的可读性,是java程序的条理更加清晰,易于区分代码行与注释行。另外通常在程序开头加入作者,时间,版本,要实现的功能等内容注释,方便后来的维护以及程序员的交流。

2.注释的种类

a.单行注释(line comment)用//表示,编译器看到//会忽略该行//后的所文本
b.多行注释(block comment)用/**/表示,编译器看到/*时会搜索接下来的*/,忽略掉/**/之间的文本。
c.文档注释用/** */表示,是java特有的注释,其中注释内容可以被JDK提供的工具 javadoc 所解析,生成一套以网页文件形式体现的该程序的说明文档。
public static void main(String[] args) {
            // 第一步: 获取半径?并将半径保存在程序中
            double radius = 5;
            // 第二步:计算面积,并将面积保存在程序中
            /*
            double area = radius * radius * 3.1415;
            // 第三步:在控制台现实面积
            System.out.println("半径为" + radius + "的圆的面积为:" + area);
            */

        }

   注意:多行注释中可以嵌套单行注释,多行注释不能嵌套多行注释。错误!!!

class Demo{
        /*
            这是主函数,是程序的入口
            它的出现可以保证程序的独立运行
         /*
            注意:多行注释嵌套多行注释是不行的。
        */
        */
     public static void main(String[] args){
        //这是输出语句用于将括号内的数据打印到控制台。
        System.out.println("hello java");
    }

d文档注释 (编写软件说明书)
1.需要使用sum给我们提供的javadoc工具生成一个html的说明文档。
2.只能抽取public的属性或者方法内容。
格式:
Javadoc –d 指定存储文档的路径 -version –author(可选) 目标文件

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

注释的使用细节:
三种注释可以出现在程序的任何地方,但是不推荐找任意位置。

3.编程习惯

1. 给那条语句进行说明,注释应该写在该语句的旁边。
2. 单行注释一般写在语句的后面多行注释和文档注释一般写在语句的上面
注意:文档注释只能出现在类、属性、方法的上面。

3注释的嵌套
单行注释可以在单行注释里面。
多行注释不能嵌套在多行注释里面。

4注释的调试作用:
可以作为初学者的调试方式。
可以帮组初学者确定代码的错误之处。

相关文章
|
Java 数据安全/隐私保护
java实现加密电话号码,有具体的加密流程注释
java实现加密电话号码,有具体的加密流程注释
19 0
|
6月前
|
Java Spring
【Java用法】Spring之@Nullable和@NotNull注释的使用
【Java用法】Spring之@Nullable和@NotNull注释的使用
70 0
|
30天前
|
Java 数据库连接 mybatis
mybatis简单案例源码详细【注释全面】——实体层(User.java)
mybatis简单案例源码详细【注释全面】——实体层(User.java)
13 0
|
29天前
|
Java 编译器 API
Java注释
Java注释
12 0
|
30天前
|
Java 数据库连接 mybatis
mybatis简单案例源码详细【注释全面】——Utils层(MybatisUtils.java)
mybatis简单案例源码详细【注释全面】——Utils层(MybatisUtils.java)
12 0
|
30天前
|
Java 数据库连接 mybatis
mybatis简单案例源码详细【注释全面】——测试层(UserMapperTest.java)
mybatis简单案例源码详细【注释全面】——测试层(UserMapperTest.java)
9 0
|
30天前
|
Java 数据库连接 mybatis
mybatis简单案例源码详细【注释全面】——实体层(Role.java)
mybatis简单案例源码详细【注释全面】——实体层(Role.java)
7 0
|
1月前
|
Java 程序员 编译器
Java注释
Java注释
14 0
|
1月前
|
Java 测试技术 API
滚雪球学Java(10):Java注释
【2月更文挑战第22天】🏆本文收录于「滚雪球学Java」专栏,专业攻坚指数级提升,助你一臂之力,带你早日登顶🚀,欢迎大家关注&&收藏!持续更新中,up!up!up!!
48 2
|
1月前
|
Java 程序员 编译器
【Java从入门到精通】Java注释
【Java从入门到精通】Java注释
16 0