第三章 第一个Java程序及三种注释、文档注释生成文档

一、第一个java 程序

1、新建文本文件

更改文件名称和文件后缀名为 .java
文件后缀名为 .java的文件是代码文件

2、用文本工具打开文件，输入代码

public class HelloWorld{
   public static  void main(String [] args){
 		System.out.println("hello world!!");
   }
}

3、编译代码

运行cmd 命令，并切换到代码文件存放路径。

使用javac命令进行编译。

当文件目录下出现HelloWorld.class 表示编译成功。

4 、运行代码

运行编译文件代码，Java HelloWorid 在这里HelloWorid 代表的是方法的名称，而不是文件的名称。

二、注释

注释：不会被编译的说明，方便开发人员对代码进行描述

1、 文档注释 /** */

/**	
   		public  关键字 ，公共的
   		Class 关键字 ， 类别
   		HelloWorld  自定义的名称 ，类名
   		{ }   范围、作用域
*/
public class HelloWorld{
   public static  void main(String [] args){
 		System.out.println("hello world!!");
   }
}

2、多行注释 /* */

/*
static  关键字  静态的
   		void   关键字   返回值类型为空的（没有返回的值）
   		main  主函数名称，不能修改，
   		String []   字符串数组
   		args    数组的名称 
*/
	public static  void main(String [] args){
 		System.out.println("hello world!!");
   }

3、单行注释 //

 	public static  void main(String [] args){
 	     //向控制台输出一条语句
  		System.out.println("hello world!!");
	}

三、代码格式

1、Java代码的位置
2、Java代码严格区分大小写
3、java是一种自由格式语言
4、代码分为结构定义语句和功能执行语句
5、功能执行语句最后必须用分号结束

四、文档注释生成文档

1、运行 CMD 命令，输入 CD /d E:/java

2、输入 javadoc *.java 符号*号代表通配符 ，该行命令表示在当前文件夹下生成文件，

   javadoc -private -d doc -author -version Helloworld.java
   
// javadoc   执行的程序
// -private   Javadoc只能为public,protected两种权限的类成员进行处理注释文档。当然也可以使用-private参数强制进行处理, 我们可以在注释中嵌入HTML个标记来丰富最后文档的显示, 因为Javadoc最后生成的文档就是HTML.
// doc   表示会在当前文件夹目录下新建一个文件夹，所有生成的文档都会放入该文件夹下
// -author  类注释是写在类前面的, 用来说明类的一些情况, 可以包涵 @version,@author参数, 但Javadoc缺省情况下不处理, 也就是说不在最后文档中出现的, 为了使用这些信息, 我们可以加入参数 -version和 -author来强制输出到最后的文档中
// Helloworld.java   代码文件

执行完后会生成一个doc文件夹

打开index.html 等文件后，可以在网站中看到相关文档注释