Java代码中的各种因素

※ java代码中的注释

作用：使部分内容只为程序员可见，不为编译器所编译、虚拟机所执行
位置：类声明前后、方法声明前后、属性声明前后、方法体中。几乎可以在一个源文件任意位置，但不能在一个关键字字符中插入注释
类型:
1）单行注释：
//text ——从 // 到本行结束的所有字符均作为注释而被编译器忽略
2）多行注释：
/text/ ——从 /* 到 */ 间的所有字符会被编译器忽略
3）文档注释：
/test*/ ——从”/“到”*/”间的所有字符会被编译器忽略。当这类注释出现在任何声明(如类的声明、类的成员变量的声明或者类的成员方法的声明)之前时，会作为JavaDoc文档的内容；
@author 类的作者
@version 类的版本
@param 方法的参数
@return 方法的返回类型
@see 另外参照…
@since 从什么时候开始使用的

例如:
package com.briup.ch02;

/**
 * this is my CommentTest Class
 *@author briup
 *@version 1.0
 *@since JDK1.7
 * */
public class CommentTest{
    //表示这个人的名字 
    private String name;

    /**
     *this is a age of person
     *
     * */
    private int age;

    /**
     *@param name :a name of person
     * */
    public void setName(String name){
        this.name = name;

    }
    /**
     *@return 没有返回类型
     * */
    public String getName(){
        return this.name;

    }
    public static void main(String[] args){
    /*  
        CommentTest ct = new CommentTest();
        ct.setName("tom");
        String temp = ct.getName();
        System.out.println(temp);
    */
    }

}

使用javadoc进行编译：
javadoc -d doc src/CommentTest.java

如果想显示出author和version
javadoc -d doc -author -version src/CommentTest.java
或者:
javadoc -d doc -author -version src/*.java

※ 分号、代码块和空格

※ 分号（；）
1）每个语句短语以“；”结束。
2）类的声明最后不需要加“；”
public class Hello{ …. }
3）方法的声明最后不需要加;
public class Hello{

public void go(){….}
}
4）属性的声明最后一定要加“；”
public class Hello{
int id;
private String name;
public int age;
public void go(){….}
}

※ 代码段以{}结束;
常见的有：
类的声明后加{}
方法的声明后加{}
注意:代码的{}后面都不加;

※ 空白处（空格、tab键、新行和回车（几个语句短语连接在一起））是无关紧要的。

※ 标识符

类、方法和变量的名字
1）java标识符以字母、“_”和“$”开头，不能以数字开头，后跟字母、数字、下划线和Shift+4(和前面一样，不知道为什么不能再写一次了)的组合;
2) 大小写敏感
3) 没有长度限制。
4）不能是java中的关键字

 举例：  合法标识符     非法标识符
           try1         try#
           GROUP_7      7GROUP
           openDoor     open-door
           boolean1     boolean
           _int         int
           $int         int

※ 关键字

Java语言的关键字是程序代码中的特殊字符。包括：
. 类和接口的声明——class, extends, implements, interface
. 包引入和包声明——import, package
. 数据类型——boolean, byte, char, double, float, int, long, short
. 某些数据类型的可选值——（false, true,不是关键字） null
. 流程控制——break, case, continue, default, do, else, for, if, return, switch, while
. 异常处理——catch, finally, throw, throws, try
. 修饰符——abstract, final, native, private, protected, public, static, synchronized, transient, volatile
. 操作符——instanceof
. 创建对象——new
. 引用——this, super
. 方法返回类型——void

Java语言的保留字是指预留的关键字，它们虽然现在没有作为关键字，但在以后的升级版本中有可能作为关键字。(goto const)
. 所有关键字都是小写；
. friendly, sizeof不是Java语言的关键字，这有别于C++；
. 程序中标识符不能以关键字命名；

※ 推荐命名规则

1) 类名以大写字母开头；
Hello Person Teacher TypeTest
2) 接口名以大写字母开头；
Eat Fly
3) 方法名以小写字母开头；(驼峰命名法，小写字母开头，其他单词首字母大写)
say go doSomething
4) 变量名以小写字母开头；
name age myName myAge
5) 常量名全部大写，多个单词以”_”连接；
FILE_TYPE PERSON_TITLE
常量：不可改变值的变量
常量 static final修饰
static final String MSG=”test”;
变量：可以改变值的变量
String msg=”test”;
msg=”test1”;