Java基础语法
注释
平时我们编写代码,在代码量较少的时候,我们还可以看懂自己写的。
但当项目代码一旦多了起来,这时候我们就需要用到注释了
-
注释并不会被执行,是我们写代码的人看的
-
书写注释是一个很好的习惯!
-
平时写代码一定眼规范!
// // _oo0oo_ // o8888888o // 88" . "88 // (| -_- |) // 0\ = /0 // ___/`---'\___ // .' \\| |// '. // / \\||| : |||// \ // / _||||| -:- |||||- \ // | | \\\ - /// | | // | \_| ''\---/'' |_/ | // \ .-\__ '-' ___/-. / // ___'. .' /--.--\ `. .'___ // ."" '< `.___\_<|>_/___.' >' "". // | | : `- \`.;`\ _ /`;.`/ - ` : | | // \ \ `_. \_ __\ /__ _/ .-` / / // =====`-.____`.___ \_____/___.-`___.-'===== // `=---=' // // // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ // // 佛祖保佑 永无BUG // // //
Java注释一般分为三种:
单行注释
顾名思义,只对一行代码注释。
例如 //单行注释
,以‘//
’开头,跟在‘//
’后面的文本就是注释内容。
单行注释不会被编译,不要把代码写在‘//’的后面。
快捷键:ctrl
+/
Tip:单行注释可放在代码的任何地方,但为了规范,方便且好看,一般都写在要解释的代码的上边,假如要解释某一行某一部分的话,可写在同一行。
例如:
多行注释
当多行内容要被注释时,选择多行注释。例如 /*
多行注释 */
快捷键:选中要注释的内容,按ctrl
+shift
+/
,也可以输入 /*
后按ENTER
键即可。
文档注释
JavaDoc文档注释
常用的文档注释标签:
标签 | 描述 | 示例 |
---|---|---|
@author | 标识一个类的作者 | @author description |
@deprecated | 指名一个过期的类或成员 | @deprecated description |
{@docRoot} | 指明当前文档根目录的路径 | Directory Path |
@exception | 标志一个类抛出的异常 | @exception exception-name explanation |
{@inheritDoc} | 从直接父类继承的注释 | Inherits a comment from the immediate surperclass. |
{@link} | 插入一个到另一个主题的链接 | {@link name text} |
{@linkplain} | 插入一个到另一个主题的链接,但是该链接显示纯文本字体 | Inserts an in-line link to another topic. |
@param | 说明一个方法的参数 | @param parameter-name explanation |
@return | 说明返回值类型 | @return explanation |
@see | 指定一个到另一个主题的链接 | @see anchor |
@serial | 说明一个序列化属性 | @serial description |
@serialData | 说明通过writeObject( ) 和 writeExternal( )方法写的数据 | @serialData description |
@serialField | 说明一个ObjectStreamField组件 | @serialField name type description |
@since | 标记当引入一个特定的变化时 | @since release |
@throws | 和 @exception标签一样. | The @throws tag has the same meaning as the @exception tag. |
{@value} | 显示常量的值,该常量必须是static属性。 | Displays the value of a constant, which must be a static field. |
@version | 指定类的版本 | @version info |
例如:
标识符
Java 中标识符是为方法、变量或其他用户定义项所定义的名称。标识符可以有一个或多个字符。
在 Java 语言中,标识符的构成规则如下。
-
标识符由数字(09)和**字母**(AZ 和 a~z)、美元符号(
$
)、下划线(_
)以及 Unicode 字符集中符号大于 0xC0 (十六进制)的所有符号组合构成(各符号之间没有空格)。 -
标识符的第一个符号为字母、下划线和美元符号,后面可以是任何字母、数字、美元符号或下划线。
-
Java 区分大小写,因此
Hello
和hello
是两个不同的标识符 -
可以使用中文命名,但是一般不建议这样去用,也不建议使用拼音,因为很low。。。
Tips:标识符命名时,切记不能以数字开头,也不能使用任何 Java 关键字作为标识符,而且不能赋予标识符任何标准的方法名。
标识符分为两类,分别为关键字和用户自定义标识符。
-
关键字是有特殊含义的标识符,如
true
、false
表示逻辑的真假。 -
用户自定义标识符是由用户按标识符构成规则生成的非保留字的标识符,如
abc
就是一个标识符。
Tips:使用标识符时一定要注意,或者使用关键字,或者使用自定义的非关键字标识符。此外,标识符可以包含关键字,但不能与关键字重名。
例如以下合法与不合法标识符。
- 合法标识符:
delete
、$2021
、_delete
、D_$delete
等。 - 不合法的标识符:
baidu.com
、2com
、for、if 等。
标识符用来命名常量、变量、类和类的对象等。因此,一个良好的编程习惯要求命名标识符时,应赋予它一个有意义或有用途的名字。
关键字
Java 所有的组成部分都需要名字。类名、变量名以及方法名都被称为标识符。
常用的关键词
(起名不能和关键字重名)
abstract | assert | boolean | break | byte |
---|---|---|---|---|
case | catch | char | class | const |
continue | default | do | double | else |
enum | extends | final | finally | float |
for | goto | if | implements | import |
instanceof | int | interface | long | native |
new | package | private | protected | public |
return | strictfp | short | static | super |
switch | synchronized | this | throw | throws |
transient | try | void | volatile | while |
比如我们之前写的Hello
再比如:
String author = "北屿";
这就是我们常说的对明显的定义变量,定义变量的名字就是author
,可以自己随便写,这里的=
和我们数学当中的等号不同,这里的意思为赋值
,即将等号右边的值赋给等号左边的值