Java基础：命名和注释规范

命名规范

数字不可以开头（可以在中间或结尾），不可以有中文，不可以有特殊字符（只允许$和_），不能是关键字；

关键字

goto和const是保留字，main不是关键字。

特点：全部小写。

项目

全部小写。

包

全部小写。

包名之前最好加上唯一的前缀，通常使用组织倒置的网络域名。

例如：域名javagroup.net -> package net.javagroup.mypackage;

包名后续部分依不同机构内部的规范不同而不同。

例如: package net.javagroup.research.powerproject;（倒置的网络域名.部门名.项目名）

类

一个单词，首字母大写；

多个单词，每一个单词的首字母都大写。

常量

一个单词：全部大写；

多个单词：所有字母都大写，用_隔开。

变量和方法

一个单词：全部小写；

多个单词：从第二个单词开始，每个单词首字母大写。

注释规范

类注释

在每个类前面必须加上类注释，注释模板如下：

/**

* Copyright (C), 2006-2010, ChengDu Lovo info. Co., Ltd.

* FileName: Test.java

* 类的详细说明

*

* @author 类创建者姓名

* @Date 创建日期

* @version 1.00

*/

属性注释

在每个属性前面必须加上属性注释，注释模板如下：

/** 提示信息 */

private String strMsg = null;

方法注释

在每个方法前面必须加上方法注释，注释模板如下：

/**

* 类方法的详细使用说明

*

* @param 参数1 参数1的使用说明

* @return 返回结果的说明

* @throws 异常类型.错误代码 注明从此类方法中抛出异常的说明

*/

构造方法注释

在每个构造方法前面必须加上注释，注释模板如下：

/**

* 构造方法的详细使用说明

*

* @param 参数1 参数1的使用说明

* @throws 异常类型.错误代码 注明从此类方法中抛出异常的说明

*/

方法内部注释

在方法内部使用单行或者多行注释，该注释根据实际情况添加。

//背景颜色

 Color bgColor = Color.RED

包

其实就是文件夹。

作用

对类进行分类管理，把相同的类名放到不同的包中。

定义包的格式

package 包名;

注意

package语句必须是程序的第一条可执行的代码；

package语句在一个Java文件中只能有一个；

如果没有package，默认表示无包名。

导包

每次使用不同包下的类的时候，都需要加包的全路径类，比较麻烦，所以，Java提供了导包的功能。

导包：import 关键字 //import 包名.类名

系统包：import java.util.* //*指包中所有类

自定义包：import 包名.类名

快捷键：ctrl+shift+o

变量的定义、声明、引用、创建、赋值、初始化的区别

定义：变量定义方式包含了4个动作，变量的声明、引用、创建、初始化。

基本数据类型 变量名 = 值;
类 变量名 = new 类();

声明：该变量user并没有引用，系统会给它一个默认的引用：null。

User user;

引用：变量名＝对象，这个＝的过程就是引用。

User user2 = user;//这引用表示：变量user2引用的对象与user引用的对象为同一个。

赋值：赋值的概念其实基本同引用，所不同是赋值是针对基本数据类型的叫法，引用是针对引用数据类型来讲。

int n = 100;

创建：new 类();这个new的动作即为创建对象。

初始化：在变量定义时的赋值或引用即为初始化，也可以理解为第一次赋值或引用的过程。

作用域

被定义变量只在被定义的大括号内有效。