Java的包、类路径、文本注释

一.包

(1)在导入类时发生命名冲突的时候，需要注意包的名字。例如，java.util和java.sql 包都有日期(Date)类。如果在程序中同时导入了这两个包，在程序使用
Date类时，就会出现一个编译错误。此时，编译器无法确定程序使用的是哪一个Date类。可以采用增加一个特定的import语句来解决这个问题：

import java.util.*;
import java.sql.*;
import java.util.Date;

如果这两个Date类都要使用，就在每个类名前面加上完整的包名。
(2)静态导入： 可以使用import导入静态方法和静态域。
例如,如果在源文件的顶部添加：import static java.lang.Math.*;
这样就可以直接使用Math类的方法，而不用加类名前缀。如：
sqrt(pow(x,2) + pow(y,2))
(3)包作用域：在Java语言的早期，只需要将例如：package java.awt.*;这样的语句放在类文件的开头，再把类文件放入java/awt子目录下，就可以访问java.awt包的内部了。
从JDK1.2起，明确地禁止加载用户自定义的，包名以"java."开始的类！对用户自定义的类我们可以使用包密封机制来解决这个问题。

二.类路径

(1)类路径包括：基目录；当前目录(.);JAR文件。
(2)在UNIX环境中，类路径中的不同项目之间采用冒号(:)分隔；
而在Windows环境中，则以分号(;)分隔。
(3)javac编译器总是在当前目录中查找文件，但Java虚拟机仅仅在类路径中有“.”目录的时候才查看当前目录。如果没有设置类路径，默认的类路径包含“.”目录。然而如果设置了类路径却忘记了包含“.”目录，则程序仍然可以通过编译，但是不能运行。

三.文档注释

(1)javadoc实用程序从下列几个特性中抽取信息：包、公有类和接口、公有的和受保护的构造器和方法、公有的和受保护的域。
应该为上面及部分编写注释。注释应该放在所描述特性的前面。注释以/*开始，并以/结束。
(2)通用注释
下面的标记可以用在类文档的注释中。
@author 这个标记产生一个作者条目。
@ version 对当前版本的描述。
@since 这个标记将产生一个始于条目，例如@since version 1.7.1
@deprecated 这个标记对类、方法或变量添加一个不再使用的注释。文本中给出了取代的建议。
@see 这个标记将在“see also”部分增加一个超级链接。它可以用于类中，也可以用在方法中。
例如：

@see packageA.TestClass#testMethod(double)
/*建立一个链接到packageA.TestClass类的testMethod(double)方法的超链接。
需要注意，一定要使用#而不是句号(.)来分隔类名和方法名，或类名与变量名。
如果@see标记后面有一个'<'字符，就需要指定一个超链接。*/

(3)方法注释
@param 变量描述
这个标记将对当前方法的参数部分添加一个条目。一个方法的所有@param标记必须放在一起。
@return 描述
这个标记将对当前方法添加“return”(返回)部分。
@throws 类描述
这个标记将添加一个注释，用于表示这个方法有可能抛出异常。