Java 代码的基本知识
Java 代码的基本知识Java 私塾跟我学系列——JAVA 篇
1：语句
用分号”;”结尾的一行代码就是语句，Java 中语句必须以”;”结尾。
如：int a = 10;
可以有块语句，例如：
int i=0;
{
int j = 0;
j = j+1;
}
i++;
2：块（block）
一个块是以{}作为边界的语句的集合，块可以嵌套。如：
{
int a = 10;
String s = ""; //一条语句或多条语句均可
{
System.out.println(“块可以嵌套”);
}
}
3：注释
什么是注释呢？就是标注解释的意思，主要用来对 Java 代码进行说明。Java 中有三种注释方式：
（1）//：注释单行语句
示例：
//定义一个值为 10 的 int 变量
int a = 10;
（2）/**/：多行注释
示例：
/*
这是一个注释，不会被 Java 用来运行
这是第二行注释，可以有任意多行
*/
（3）/** */：文档注释
紧放在变量、方法或类的声明之前的文档注释,表示该注释应该被放在自动生成的文档中(由 javadoc 命令生成的 HTML 文件)以当作对声明项的描述。
示例：
/**
*这是一个文档注释的测试
*它会通过 javadoc 生成标准的 java 接口文档
*/
常常在 javadoc 注释中加入一个以“@”开头的标记，结合 javadoc 指令的参数，可以在生成的 API 文档中产生特定的标记。
常用的 javadoc 标记
@author：作者
@version：版本
@deprecated：不推荐使用的方法
@param：方法的参数类型
@return：方法的返回类型
@see：参见，用于指定参考的内容
@exception：抛出的异常
@throws：抛出的异常，和 exception 同义
javadoc 标记的应用范围
在类和接口文档注释中的标记有@see @deprecated@author @version
在方法或者构造方法中的标记有：@see@deprecated@param@return@exception @throws
在属性文档注释中的标记@see @deprecated
4：空格
在一个 Java 程序中任何数量的空格都是允许的
5：Java 编程基本的编码约定
可能有些还没有学到，没有关系，先了解一下。
类──类名应该是名词，大小写可混用，但首字母应大写。例如：
classAccountBook
classComplexVariable
接口──接口名大小写规则与类名相同。
interfaceAccount
方法──方法名应该是动词，大小写可混用，但首字母应小写。在每个方法名内，大写字母将词分隔并限制使用下划线。例如：
balanceAccount( )
addComplex( )
变量──所有变量都可大小写混用，但首字符应小写。词由大写字母分隔，限制用下划线，限制使用美元符号（$），因为这个字符对内部类有特殊的含义。
currentCustomer
变量应该代表一定的含义，通过它可传达给读者使用它的意图。尽量避免使用单个字符，除非是临时“即用即扔”的变量（例如，用 i, j, k 作为循环控制变量）
常量──全部大写并用下划线将词分隔。
HEAD_COUNT
MAXIMUM_SIZE
控制结构──当语句是控制结构的一部分时，即使是单个语句也应使用括号（｛｝）将语句封闭。例如：
if(condition){
do something
}else{
do something else
}
语句行──每行只写一个语句并使用四个缩进的空格使你的代码更易读。
注释──用注释来说明那些不明显的代码段落；对一般注释使用//分隔符， 而大段的代码可使用 /*…*/分隔符。使用/**…*/将注释形成文档，并输入给 javadoc 以生成 HTML 代码文档。
页:
[1]
