Java允许使用包(package)将类组织起来。借助于包可以方便地组织自己的代买,并将自己的代码与别人提供的代码库分开管理。
标准的Java类库分布在多个包中,例如:java.lang,java.util,java.net等。
使用包的主要原因就是确保类名的唯一性。如果两个类名相同的类,只要不放在一个包中,那么便不会产生冲突。
(一)类的导入
一个类可以使用所属包中的所有类,以及其他包中的公有类(public class)。
访问另一个包中的公有类有两种方式:
①在每个类之前添加完整的包名,如:
java.time.LoclaDate today = java.time.LocalDate.now();
②使用import关键字,引用一个包或者一个特定的类。如:
import java.util.*
(二)静态导入
①import语句不仅可以导入类,还可以导入静态方法和静态域。
如果在源文件顶部,添加一条指令:
import static java.lang.System.*;
就可以使用System类的静态方法和静态域了,而不必加类名前缀:
out.println("Goodbye World");
②也可以导入特定的方法或域:
import static java.lang.System.out;
(三)将类放入包中
要想将一个类放入包中,就必须将包的名字放在源文件的顶部即开头。
package com.horstman.corejava;
public class Employee{
...
}
如果没有在源文件中放置package语句,那么这个类会被放入一个默认包(default package)中。
类还可以存储在JAR(Java归档)文件中。在程序中使用到第三方库文件时,通常会给出一个或多个需要包含的jar文件。
为了使类能够被多个程序共享,需要做到以下几点:
①把类放到一个目录中
②将jar文件放在一个目录中
③设置类路径(class path)
类路径包括:①基目录,②当前目录(.),③jar文件
JDK包含一个很有用的工具,就是javadoc,它可以由源文件生成一个HTML文档。
(一)注释的插入
javadoc实用程序(utility)从下面几个特性中抽取信息:
①包
②公有类与接口
③公有的和受保护的构造器及方法
④公有的和受保护的域
应该为上面的几个部分编写注释。注释应该放置在所描述的特性前面。注释以/**开始,以*/结束。
(二)类注释
类注释必须放在import语句之后,类定义之前。
(三)方法注释
每一个方法注释需要放在所描述的方法之前,除了通用的标记之外还可以使用以下几个标记:
@param //变量描述:对当前方法的param进行描述
@return //返回描述:对当前方法的返回部分进行描述
@throws //类描述:表示这个方法可能抛出异常
(四)通用注释
@author //作者
@version //版本
@since //始于
@deprecated //这个标记将对类,方法或变量添加一个不再使用的注释
@see //引用,可以增加一个超链接
①一定要保证数据私有:这是最重要的,绝对不要破坏封装性
②一定要对数据初始化:最好不要依赖于系统默认初始化,具体的初始化方式是提供默认值或者在所有构造器中设置默认值。
③不要在类中使用过多的基本类型:用其他的类代替多个相关的基本类型的使用
④不是所有的域都需要独立的域访问器和域更改器
⑤将职责过多的类进行分解
⑥类名和方法名要能够体现它们的职责
⑦优先使用不可变的类