Java编程那些事儿20—空缺、语句竣事和注释

3.8 空缺

在前面的内容中，已经先容了在编写代码中，单词和单词之间需要利用空格举办隔断，至于空格的数量则不限制。

而实际的编码中，为了使代码的布局清晰，一般需要在代码的前面插手必然数量的空格，譬喻如下名目：

public class Blank{
　public static void main(String[] args){
　　int n;
　　{
　　　n = 10;
　　}
　　System.out.println(n);
　}
}

在该代码中，除了第一行和最后一行外，每行都包括必然数量的空格，这种编码的名目称为代码缩进。

在实际代码中，只要存在包括干系，则代码就应该缩进，语句块是最典范的包括干系之一。说明：在编译时，每行开始的空格城市被忽略掉。

3.9 语句竣事

Java语法中，语句以“;”作为行竣事符，譬喻：

int n = 2;

凡是环境下，代码中每行只写一句代码，可是也可以写多句，譬喻：

int n = 2; byte b = 10;

可是一般为了代码布局清楚，只在一行中书写一句代码。

有些时候代码自己较量长，则也可以把一句代码写在多行，而代码语句竣事的处所书写一个“;”即可。

在实际代码中，一般大括号开始和竣事的处所，以及大部门小括号竣事的处所都不需要书写“;”来举办竣事。

3.10 注释

注释(comment)是对代码成果和用途的说明。在措施中编写适当的注释，将使措施代码更容易阅读，加强代码的可维护性。

注释在措施编译时城市被忽略，所以注释不会增加class文件的巨细。

Java语言中注释的语法有三种：单行注释、多行注释和文档注释。

3.10.1 单行注释

单行注释指只能书写一行的注释。单行注释属于注释中最简朴的语法名目，用于对付代码举办简朴的说明，譬喻变量成果等。

单行注释的语法名目为：

//注释内容

注释以两个斜线开始，该行后续的内容都是注释的内容，注释内容不能换行。

单行注释一般书写在需要说明的代码的上一行，可能该行代码的竣事处，示例布局如下：

//轮回变量

int i = 0;

char sex;//性别

3.10.2 多行注释

多行注释指可以书写任意多行的注释。多行注释一般用于说明较量巨大的内容，譬喻措施逻辑或算法实现道理等。

多行注释的语法名目为：

/*

注释内容

*/

注释以一个斜线和一个星号开始，后续是注释内容，注释内容可以书写任意多行，最后注释以一个星号和一个斜线末了。

许多多行注释在每行以星号开始，这个不是语法必须的。

3.10.3 文档注释

文档注释指可以被提取出来形成措施文档的注释名目，这是Java语言有特色的注释名目。一般对付措施措施的布局举办说明，譬喻类、属性、要领和结构要领举办说明，这些观念在后续将具体先容。

文档注释的语法名目为：

/**

注释内容

*/

注释以一个斜线和两个星号开始，后续是注释内容，注释内容可以书写任意多行，最后注释以一个星号和一个斜线末了。

在后续内容中还将完善该注释的语法名目。

3.10.4 其它

在类型的代码中，一般有10%-20%的注释，也就是每100行代码中包括10-20行注释的内容，可是海内许多开拓公司都远远达不到这个要求。

别的需要出格留意的是，在实际的项目开拓中，在修改代码后，必然要对应的修改注释的内容，保持代码和注释内容的同步。

文章来历:http://blog.csdn.net/Mailbomb/archive/2008/05/17/2453908.aspx