java标识符&注释

什么是标识符

就是程序员在定义java程序时，自定义的一些名字，例如helloworld 程序里关键字class 后跟的Demo，就是我们定义的类名。类名就属于标识符的一种。
标识符除了应用在类名上，还可以用在变量、函数名、包名上。

标识符必须遵循以下4条规则

1. 标识符由26个英文字符大小写（a~zA~Z）、数字(0~9)、下划线(_)和美元符号($)组成。
2. 不能以数字开头，不能是关键字
3. 严格区分大小写
4. 标识符的可以为任意长度
   如：合法的标识符：ComputeArea，radius，area $happy _happy so_happy
   注意：由于Java严格区分大小写，HAPPY 和happy是完全不同的标识符
   非法标识符：
5. class (关键字)
6. 100java(不能以数字开头)
7. Hello java (空格不是组成标识符的元素)

Java中的标识符命名规范

1. 包名
   多个单词组成时所有字母小写（例:package com.test）
2. 类名和接口
   多个单词组成时所有单词的首字母大写(例：HelloWorld)
3. 变量名和函数名
   多个单词组成时第一个单词首字母小写，其他单词首字母大写（例：lastAccessTime、getTime）。
4. 常量名
   多个单词组成时，字母全部大写，多个单词之间使用_分隔（例：INTEGER_CACHE）
   注意：只是为了增加规范性、可读性而做的一种约定，标识符在定义的时候最 好见名知意，提高代码阅读性。

:java注释方法

注释的作用

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

注释的种类

1.单行注释（line comment）用//表示，编译器看到//会忽略该行//后的所文本
2.多行注释(block comment)用//表示，编译器看到/时会搜索接下来的/,忽略掉//之间的文本。
3．文档注释用/* /表示，是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");
    }

文档注释 （编写软件说明书）
1. 需要使用sum给我们提供的javadoc工具生成一个html的说明文档。
2. 只能抽取public的属性或者方法内容。
格式：

Javadoc –d 指定存储文档的路径  -version –author（可选）  目标文件

/**
需求：在控制台上打印hellojava
@author happyhappy
@version 1.0
*/
class Demo{
     /*
         该方法是程序的主入口，保证该类可以独立运行
         @param args 运行该类的时候需要使用的参数     
     */
     public static void main(String[] args){
        //这是输出语句用于将括号内的数据打印到控制台。
        System.out.println("hello java");
    }

@author 作者
@version 版本
@param 方法的参数
@return 返回值
注释的使用细节：
三种注释可以出现在程序的任何地方，但是不推荐找任意位置。
. 编程习惯：
1. 给那条语句进行说明，注释应该写在该语句的旁边。
2. 单行注释一般写在语句的后面多行注释和文档注释一般写在语句的上面
注意：文档注释只能出现在类、属性、方法的上面。

/*
多行注释应该鞋子啊方法类或属性的上方
*/
/**
注意：文档注释只能出现在方法与类的上方，否则提取不到。
*/
class Demo{

     public static void main(String[] args){
        System.out.println("hello");//这条语句输出hello
        System.out.println("java");//这个语句输出java
    }

.注释的嵌套
1.单行注释可以在单行注释里面。
2.多行注释不能嵌套在多行注释里面。
.注释的调试作用:
1. 可以作为初学者的调试方式。
2. 可以帮组初学者确定代码的错误之处。