|
/** 这是一个文档注释的例子，主要介绍下面这个类 */
public class DocTest{
/** 变量注释，下面这个变量主要是充当整数计数 */
public int i;
/** 方法注释，下面这个方法的主要功能是计数 */
public void count( ) {}
}
通过在命令行下面运行"javadoc -d . DocTest.java"，就生成了介绍类DocTest的index.html文件，注意到DocTest.java文件中的文档注释的内容都出现在该index.html文件中。
1.6 建立java开发环境
1.6.1 安装Java Develop Kit(JDK)
Sun公司为所有的java程序员提供了一套免费的java开发和运行环境，取名为Java2 SDK，可以从http://sun.com上进行下载，也可以从同方教育网站上下载。但是最新的消息和版本必须从Sun的网站上才能够得到。安装的时候可以选择安装到任意的硬盘驱动器上，例如安装到D:\jdk1.3目录下。通常在JDK目录下有bin、demo、lib、jre等子目录，其中bin目录保存了javac、java、appletviewer等命令文件，demo目录保存了许多java的例子，lib目录保存了java的类库文件，jre保存的是java的运行时环境。
1.6.2 安装java帮助文档
由于JDK的安装程序中并不包含帮助文档，因此也必须从Sun的网站上下载进行安装。通常安装在JDK所在目录的docs子目录下面。用浏览器打开docs子目录下的index.html文件就可以阅读所有的帮助文档。
1.6.3 配置类路径
在安装完JDK之后，必须配置类路径classpath和环境变量path，JDK才能够正常运行。如果是在windows98中运行，则在
C:\autoexec.bat文件的末尾添加下列语句：
classpath= .;d:\jdk1.3\lib;
path=%path%;d:\jdk1.3\bin;
如果是在windows2000中，则需要用右键单击桌面上"我的电脑"，选择"属性"，则弹出一个名为"系统特性"的窗口，选择"高级"，然后选择"环境变量"，在"环境变量"窗口中编辑classpath和path。
【本讲小结】
java语言的产生起源于Sun Microsystems公司为消费电子产品上应用程序的开发寻找一门编程语言的过程中，而随着互联网时代的到来，原有的Oak软件就顺理成章的改造成java语言推向了市场，其跨平台、面相对象、安全等特点使其得到广泛的应用。通过在不同的软硬件上实现的java虚拟机，java的字节码文件就可以跨平台的进行运行，无用内存自动回收器也给程序员带来了极大的方便。java程序以两种方式进行运行，一种是通过java虚拟机进行直接运行的java application，另一种是通过浏览器进行运行的java applet，但是无论是何种方式，java都是一门纯粹的面向对象的编程语言。面向对象编程的思路认为程序都是对象的组合，因此要克服面向过程编程的思路，直接按照对象和类的思想去组织程序，面向对象所具有的封装性、继承性、多态性等特点使其具有强大的生命力。Sun公司为全世界java开发人员提供了一套免费的软件开发包Java2 SDK，也称为JDK，它不仅是java的开发平台，还是java的运行平台。java源程序存放在.java文件中，可以通过任意一个文本编辑器编辑产生，源程序经过"javac"命令编译过后，就生成了相应的.class文件，而用"java"命令就可以运行.class文件。作为面向对象编程人员来说，大体可以分为两种：类创建者和应用程序员，应用程序员是类的使用者。所以对程序的可读性和API帮助文档就有要求，java语言本身有一套约定成俗的编程规范，同时程序员首先要学会阅读系统API帮助文档，还要学会生成自己编写的程序的API帮助文档。
| 
