一、注释(Comment)
注释可以提高代码的可读性,是一个很好的编程习惯。注释不会被 JVM 解释执行。Java中的注释有三种:
1、单行注释
单行注释在 Java 中由 //
开始,注释内容从 //
开始直到这一行的末尾。单行注释一般用于对单行代码进行简要说明,或者临时注释掉某行代码。
//这是一个注释示例
int a = 0;//这是一个注释示例
2、多行注释
多行注释在 Java 中由 /*
开始,并以 */
结束,可以跨越多行。这种注释一般用于对一段代码块进行说明,或者临时注释掉多行代码。
/*这是一个多行注释示例
这是一个多行注释示例*/
多行注释中不能嵌套多行注释,就像下面这样,是错误的:
/*这是一个多行注释示例
这是一个多行注释示例
/* 嵌套多行注释是错误的
*/
*/
可以发现这里的最后一个 */ 都没有被解释为一个注释,实际上注释在第一个 */ 就结束了。后面的就不是注释内容,如果运行这段代码,就会出现报错。
3、文档注释
文档注释在 Java 中由 /**
开始,并以 */
结束。这种注释主要用于描述类、接口和方法,并且可以被 Javadoc 工具解析成 API 文档。文档注释通常用于提供更加详细的注释信息,包括参数描述、返回值描述、异常说明等。
Javadoc 注释的常用标签:
@param
:描述方法的参数@return
:描述方法的返回值@throws
或@exception
:描述方法可能抛出的异常@see
:提供相关主题的参考链接@since
:标识自哪个版本开始加入的功能@deprecated
:标识该方法或类已经不推荐使用
可以通过 javadoc 指令来自动生成详细的 HTML 文档。
/**
* @author stewie
* @version 1.0
*/
public class Hello{
public static void main(String[] args){
System.out.println("Hello World!");
}
}
使用 -d 参数指定路径,使用 -author 指定生成作者信息,使用 -version 指定生成版本信息。
二、Windows的dos指令
1、cd
我们知道 cd 指令可以更换目录,但是如果我们想要从 D 盘切换到 C 盘呢,也就是切换驱动器,就需要一个参数:/d。就像下面这样:
如果你希望直接切换到 C 盘的某个特定目录,可以使用 /d
参数。例如:
cd /d C:\Path\To\Directory
这将会切换到 C 盘,并进入指定的目录。
实际上还可以直接输入目标盘符,例如:
C:
这将会切换到 C 盘,并切换到你上次在 C 盘所在的目录。
2、tree
tree
命令是在 Windows 命令行中用来以树状结构显示目录和子目录的结构图。它提供了一种直观的方式来查看文件系统的层次结构。
tree [drive:][path] [/f] [/a]
[drive:][path]
:指定要显示的驱动器或路径。如果未指定,tree
将从当前目录开始显示。/f
:显示每个文件而不仅仅是目录。/a
:使用 ASCII 字符而不是扩展字符来显示树形结构。这在某些字符集或远程连接中可能更容易阅读。
示例: