我的Java基础学习第三天_com.lyy.test-CSDN博客

本文链接：https://blog.csdn.net/qq_45083168/article/details/107762398

Java基础知识

1.注释

1.1 单行注释
单行注释"//"到该行结束为注释内容

// 类名：test1
// 作用：单行注释测试类
// 日期：2020-08-03
// 作者：Dust
public class test1 { // test1类的大括号开始
	//main方法，固定写法，程序入口
	public static void main(String[] args){
		//向控制台中输出指定字符串内容
		System.out.println("hello java test");
		//下面一句代码被注释掉了，不会被执行
		//int a = 1；
	}
	//main方法结束
    }
} // test1类的大括号结束

编译、运行一切正常，注释不会对此产生任何影响
1.2 多行注释
注释从 “/*” 开始，到 “*/” 结束。
它可以注释一行，也可以注释多行

package com.briup.day03;

/*
    类名：test2
    作用：多行注释测试类
    日期：2020-08-03
    作者：Dust
 */
public class test2{ /* test2类的大括号开始 */

    /* main方法，固定写法，程序入口 */
    public static void main(String[] args){
        /* 向控制台中输出 */
        System.out.println("hello java test");
        /* 下面一句代码被注释掉了，不会被执行 */
        /* int a = 1；*/
    }
    /* main方法结束 */

}/* test2类的大括号结束 */

1.3 文档注释
可以注释单行，也可以注释多行，以 “/**” 开始，以 "*/"结束的。
同时在Java中，文档注释也被用于生成API文档。

如果在生成API文档的时候，希望得到更新详细的信息，例如方法参数、返回值、异常的详细说明，可以使用javadoc标记，常用的javadoc标记有：

@author：作者
@version：版本
@deprecated：不推荐使用的方法、过时的方法。
@param：方法的参数类型。
@return：方法的返回类型。
@see：用于指定参考的内容。
@exception：抛出的异常。
@throws：抛出的异常，和exception同义

package com.lyy.test;

/**
 * 文档注释测试类,利用文档注释，结合javadoc命令，可以生成API说明文档
 * @author Dust
 * @version 1.0
 * @since JDK1.8
 */
public class C{

    /**
     * main方法，程序入口，写法固定
     * @param args  程序入口参数，如果需要，运行时可以给main方法进行传参
     */
    public static void main(String[] args){
        System.out.println("hello java");
    }

}

使用javadoc命令，根据C中的文档注释和标记，生成API说明文档，并将生成的文档存放在API目录中：

javadoc -d api src/C.java

如果要显示作者和版本的话，需要加上-author和-version选项，前提是代码中使用@author @version 俩个标记

javadoc -d api -author -version src/C.java

在是Windows中，如果出现了中文乱码，可以加入-encoding UTF-8

javadoc -d api -author -version -encoding UTF-8 src/C.java

Windows中，命令窗口默认使用编码是GBK（中文版Windows）

Linux中，命令窗口默认使用编码是UTF-8

可以把src下面的多个java文件都生成对应的doc文件

javadoc -d api -author -version src/*.java

如果将源代码分别放在不同的文件夹中：

例如，

com.lyy.test1.Hello类对应的java文件中，存放在src/com/lyy/test1/Hello.java

com.lyy.test2.World类对应的java文件中，存放在src/com/lyy/test2/Hello.java

注意，编译生成的class文件分别存放在bin/com/lyy/test1/Hello.class 和 bin/com/lyy/test2/World.class

这时，如果要生成所有类的doc文档，可以执行以下命令：这样可以把src下面com包下面所有的子包里面存放的java文件全都查找到并生成对应的doc文档

javadoc -d api -sourcepath src -subpackages com -author -version

-sourcepath 指定源代码存放的位置
-subpackages 指定要递归查找的包的名字

2.符号

2.1 分号
java中，一句代码都是以分号（;）来结束的。
需要使用分号的代码语句有：

包的声明语句 package com.lyy.test;
类的引入语句 import java.util.Date;
属性的声明语句

public class Student{
    public String name;//声明name属性
    public int age;//声明age属性
}

方法中要执行的代码
方法中几乎每行要执行的代码都要加分号（;）

public class test(){    
	int a = 1;    
	int b = 2;    
	int c = a+b;    
	System.out.println(c);
}

2.2 空白

在代码中，可以使用空格、tab、换行（\n）、回车（\r），并且对代码是没有影响的

3.标识符

在java中，给类、方法、变量起的名字，就是标示符，因为它可以用来标识这个类、方法、变量

3.1 命名规则

标识符可以由字母、数字、下划线_ 、美元符号$组成
标识符开头不能是数字
标识符中的字符大小写敏感
标识符的长度没有限制
标示符不能使用java中的关键字或保留字

合法标示符	非法标示符
try1	try#
GROUP_1	1GROUP
helloworld	hello-world
_int	int
$int	$-int

3.2 推荐规则

类和接口，首字母大写，如果是2个单词，第二个单词的首字母大写
例如，public class Account{} ，public interface AccountBase{}
方法和变量，首字母小写，如果是俩个单词，第二个单词的首字母大写
例如，public void getStudentName(){} ， int personNum = 1；
常量，全部字母大写，如果是俩个单词，使用下划线分隔
例如，public static final int MAX_NUM = 10;
尽量使用有意义的名字，尽量做到见名知义。
例如，int numOfStudnet = 10; String userName = “tom”;

4 关键字


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