Java入门-注释的类别以及标识符，关键字的认识

Java入门-第二节

    一.Java入门的第二节主要讲了一些Java编程的规则，主要有：
    1.Java的方法之间可以有空行，第一句与第二句之间可以留空行，定义变量的语句长度从上至下依次递增，以保持代码的可读性。
    2.注释的分类：Java的注释分为单行注释和多行注释，其中，多行注释分为文档注释和非文档注释，只有文档注释所注释的内容才会出现在帮助文档中，非文档注释所注释的内容不会出现在帮助文档中（比如add方法，由于该方法的注释是非文档注释，所以注释内容没有生成到帮助文档中，只出现了该方法的一些信息）。
    只有被public和protected修饰的方法添加的文档注释的注释内容才能出现在帮助文档中，所以division方法和residual方法尽管采用了文档注释，但注释内容和方法信息却没有出现在帮助文档中；

 

1.     /** 
2.      * 取余运算 
3.      *  
4.      * @param a 被除数 
5.      * @param b 除数 
6.      * @return 返回两个整数的相除后的余数 
7.      */  
8.     private int residual(int a, int b){  
9.         return a%b;  
10.     }  
11. }

1.     /** 
2.      * 除法运算 
3.      *  
4.      * @param a 被除数 
5.      * @param b 除数 
6.      * @return 返回两个整数的商 
7.      */  
8.     int division(int a, int b){  
9.         return a/b;  
10.     }

以上的注释由private int division修饰，是不会显示在帮助文档中的，而下面

 

1.     /** 
2.      * 减法运算 
3.      *  
4.      * @param a 被减数 
5.      * @param b 减数 
6.      * @return 返回两个整数的差 
7.      */  
8.     public static int subtraction(int a, int b){  
9.         return a-b;  
10.     }  
11.       
12.     /** 
13.      * 乘法运算 
14.      *  
15.      * @param a 因数 
16.      * @param b 因数 
17.      * @return 返回两个整数的乘积 
18.      */  
19.     protected static int multiplication(int a, int b){  
20.         return a*b;  
21.     } 

是由public protected 修饰的就可以在帮助文档中显示出来，这就是他们之间的区别。

    二. 标识符&关键字

     标识符是编程时使用的名字：Java对包、类、接口、方法、变量、常量（不包括项目名）等命名时使用的字符序列称为标识符。    Java标识符有如下命名规则：

       1、标识符由字母、数字、 “_”、 “$”组成，且首字母不能是数字；

      2、不能把Java关键字作为标识符；

       3、标识符没有长度限制；

       4、标识符对大小写敏感。

    标识符的命名规则建议

   规范（类、接口、方法名、变量名采用驼峰式，包名一律小写，常量一律大写并且有多个单词组成时以_间隔）、易读（简短）、含义清楚（见名知意）

    关键字

    关键字也称做保留字，是Java语言规定的具有特定含义的标识符。这些关键字已经被Java语言本身所使用。

关键字不能用作变量名、方法名、类名、包名。

 

  

 

 

    注意：
    -goto和const标识符虽从不使用，但作为Java保留字保留。

    -Java中所有关键字一律由小写英文字母组成。