# 基础语言要素 ## 注释 代码注释是编程中非常重要的环节，往往优秀的程序员，注释写的比代码都多。 注释是编程中非常重要的环节，往往优秀的程序员，注释写的比代码都多。 > 注释是不会被程序执行的 注释可能出现的位置： * 类、方法、属性等上部（文档注释：通过 javadoc 命令生成 API 文档，方便使用的人阅读） * 方法体内负责业务逻辑处理过程中（一般性注释） **文档注释** ~~~ /** * 相关的注释内容，甚至可以使用 HTML 标签 * */ ~~~ 在 javadoc 中也提供了丰富的标记 * @author：指定程序的作者 * @version：指定源代码的版本 * @param：在方法中指定参数 * @return：在方法中指定返回值 在文档注释中可以使用html标签，但是不能用自封闭的标签。 使用javadoc命令生成**API文档**，-d指定生成的目录地址。 ~~~ 执行命令： javadoc -encoding utf-8 -d apidoc -version -author Hello.java ~~~ **单行注释** ~~~ // 单行注释 ~~~ **多行注释** ~~~ /* 第一行注释 第二行注释 */ ~~~ ## JDK 帮助文档 地址：[http://tool.oschina.net/apidocs/apidoc?api=jdk-zh](http://tool.oschina.net/apidocs/apidoc?api=jdk-zh) 在学习过程中，一定要经常的阅读 JDK 文档，去帮助理解相关类的定义。 看 JDK 中相关类的源码，去学习编码规范以及设计程序的思路。 > 在doc中包含了，类的说明、类的继承关系、属性的说明、构造器的说明、方法的说明等。 ## 标识符和关键字 标识符包含了 Java 中默认的关键字以及程序员自己定义的类名、方法名、变量名等等。 **标识符的命名规范：** * 只能包含数字、字母（大小写，Unicode字符）、下划线 \_、美元符`$` * 不能以数字开头 * demo1、~demo-1~、$demo、\_demo、~1demo~ **分隔符：** * 花括号`{}`：定义代码块，逻辑上是一个整体，包括类的主体、方法体、静态代码块、条件和循环语句的执行体； * 分号`;`：语句的结束，如果出现在一行中有几条语句，那么多条之间也要用 ; 隔开； * 方括号`[]`：用于数组中； * 圆括号`()`：在方法中声明形式参数，在调用方法的时候传入实际参数，表达式优先级定义； * 空格：单个空格、Tab 键、Enter 键，空格的出现是不会影响程序运行的，但是良好的缩进，可以提高程序的可读性； * 圆点`.`：用于类/对象与其成员之间的分隔，表示调用类/对象的属性或者方法。 > 在 Java 中，只要看见单词首字母是大写的，那就是类 ~~~ 示例： class Client1 { public static void main(String[] args) { //多条语句可以定义在一行里，建议分开写，可读性更好 //int i = 0;String s = "Hello"; int i = 0; String s = "Hello"; System.out.println(i + " " + s); } } ~~~ ## 关键字  ## Java语言的书写规则 * 大小写敏感：所谓大小写敏感就是在书写的时候，例如Hello和HELLO，表示的是不一样的意思。 * 类名：以驼峰的方式命名，首字母大写，所谓驼峰就是出现两个单词的时候，单词的首字母大写，例如StudentScore * 方法名：以驼峰的方式命名，首字母小写； * 源文件：在定义源文件名的时候，要和类名相同； * Java运行的主入口函数：public static void main(String\[\] args)，在执行java Hello后面可以跟着输入参数，输入参数可以多个，用空格隔开； * 代码规范，如花括号的位置，代码缩进等