Java 包（学习 Java 编程语言 035）

Java 允许使用包（package）将类组织在一个集合中。借助包可以方便地组织自己的代码，并将自己的代码与别人提供的代码库分开管理。

标准的 Java 类库分布在多个包中，包括 java.long、java.util 和 java.net 等。标准的 Java 包具有一个层次结构。所有标准的 Java 包都处于 java 和 javax 包层次中。

1. 包名

使用包的主要原因是确保类名的唯一性。事实上，为了确保包名的绝对唯一性，要用一个因特网域名（这显然是唯一的）以逆序的形式作为包名，然后对于不同的工程使用不同的子包。例如，域名

xiang117.com

，逆序来写，得到包名

com.xiang117

。然后可以追加一个工程名，如

com.xiang117.corejava

。如果在把 Employee 类放在这个包里，那么这个类的 “完全限定” 名就是

com.xiang117.corejava.Employee

。

从编译器的角度看来，嵌套的包之间没有任何关系。例如，java.util 包与 java.util.jar 包毫无关系。每一个包都是独立的类集合。

2. 类的导入

一个类可以使用所属包中的所有类，以及其他包中的公共类（public class）。
可以采用两种方式访问另一个包中的公有类：

1. 使用完全限定名（fully qualified name），即包名后跟着类名。
   

   java.time.LocalData today = java.time.LocalDate.now();

2. 使用 import 语句。

   可以使用 import 语句导入一个特定的类或者整个包。import 语句应该位于资源文件的顶部（但位于 package 语句的后面）。

   import 语句是一种引用包中各个类的简捷方式。一旦使用了 import 语句，在使用类时，就不必写出类的全名了。

   import 语句的唯一好处是简捷。可以使用简短的名字而不是完整的包名来引用一个类。

可以使用下面语句导入 java.time 包中的所有类。
 

import java.time.*;

就可以使用
 

LocalDate today = localDate.now();

无需在前面加上包的前缀。

java.time.*

的语法比较简单，对代码的规模也没有任何负面影响。当然，如果能够明确地指出所导入的类，将会使代码的读者更加准确地知道你使用了哪些类。

需要注意的是，只能使用星号（）导入一个包，而不能使用 `import java.

或

import java..` 导入以 java 为前缀的所有包。

可以导入一个包中的特定类：
 

import java.time.LocalDate;

在大多数情况下，可以只导入所需要的包，并不必过多地考虑它们。但在发生命名冲突的时候，就要注意包了。例如，java.util 和 java.sql 包都有 Date 类。如果在程序中导入了这两个包：
 

import java.util.*;

 

import java.sql.*;

在程序使用 Date 类的时候，就会出现一个编译错误：
 

Date today; // Error--java.util.Date or java.sal.Date?

此时编译器无法确定程序使用的是哪一个 Date 类。可以采用增加一个特定的 import 语句来解决这个问题：
 

import java.util.*;

 

import java.sql.*;

 

import iava.util.Date;

如果这两个 Date 类都需要使用，需要在每个类名的前面加上完整的包名。
 

java.util.Date deadline = new java.util.Date();

 

java.sql.Date today = new java.sql.Date();

在包中定位类是编译器（compiler）的工作。类文件中的字节码总是使用完整的包名引用其他类。

3. 静态导入

有一种 import 语句允许导入静态方法和静态字段，而不只是类。

如果在源文件顶部，添加一条指令：
 

import static java.lang.System.*;

就可以使用 System 类的静态方法和静态字段。而不必加类名前缀：
 

out.println("Goodbye, World!"); // i.e., System.out

 

exit(0); // i.e., System.exit

可以导入特定的方法或字段：
 

import static java.lang.System.out;

实际上，是否有很多程序员想要用简写 System.out 或 System.exit，这一点让人怀疑。这样写出的代码看起来不太清晰。不过，
 

sqrt(pow(x, 2) + pow(y, 2))

看起来比
 

Math.sqrt(Math.pow(x, 2) + Math.pow(y, 2))

清晰得多。

4. 在包中增加类

要想将类放入包中，就必须将包的名字放在源文件的开头，即放在定义这个包中各个类的代码之前。例如在

com.xiang017.corejava

包中增加 Employee 类：

Employee.java

package com.xiang017.corejava;

public class Employee
{
...
}

如果没有在源文件中放置 package 语句，这个源文件中的类就属于无名包（unnamed package）。无名包没包名。

PackageTest.java

import com.xiang017.javacore.*;

public class PackageTest {
public static void main(String[] args) {

Employee harry = new Employee("Harry Hacker", 50000, 1989, 10, 1);
}
}

将源文件放到与完整包名匹配的子目录中。例如，

com.xiang017.corejava

包中的所有源文件应该放置在子目录

com/xiang017/corejava

中。编译器将类文件也放在相同的目录结构中。例如：

. (基目录)
│  PackageTest.java
│
└─com
└─xiang017
└─javacore
Employee.java

要想编译这个程序，只需切换到基目录，并运行命令：
 

javac PackageTest.java

编译器就会自动地查找文件

com/xiang017/corejava/Employee.java

并进行编译。编译后的结果如下：

. (基目录)
│  PackageTest.class
│  PackageTest.java
│
└─com
└─xiang017
└─javacore
Employee.class
Employee.java

要运行这个程序，需要在基目录下执行命令：
 

java PackageTest

假如 PackageTest.java 源文件没有在基目录下，在 mycompany 包下，如：

.(基目录)
|-- com/
|-- corejava/
|      |-- Employe.java
|      |-- Employe.class
|
|-- mycompany/
|-- PackageTest.java
|-- PackageTest.class

仍然要从基目录编译和运行类，即包含 com 目录的目录：
 

javac com/mycompany/PackageTest.java

 

java com.mycompany.PackageTest

需要注意，编译器对文件（带有文件分隔符的扩展名 .java 的文件）进行操作。而 Java 解释器加载类（带有 . 的分隔符）。

警告： 编译器在编译源文件的时候不检查目录结构。例如，假定有一个源文件开头有以下指令：
 

package com.mycompany;

即使这个源文件不在子目录

com/mycompany

下，也可以进行编译。如果它不依赖于其他包，就可以通过编译而不会出现编译错误。但是，最终的程序将无法运行，除非先将所有的类文件移到正确的位置上。如果包与目录不匹配，虚拟机就找不到类。

PackageTest.java

import com.xiang017.javacore.*;

public class PackageTest {
public static void main(String[] args) {

Employee harry = new Employee("Harry Hacker", 50000, 1989, 10, 1);
System.out.println("name=" + harry.getName() +
",salary=" + harry.getSalary() +
",hireDay=" + harry.getHireDay());
}
}

com/mycompany/Employee.java

package com.xiang017.javacore;

import java.time.LocalDate;
import java.util.Objects;

public class Employee {

private String name;

private double salary;

private LocalDate hireDay;

public Employee(String name, double salary, int year, int month, int day) {
this.name = name;
this.salary = salary;
hireDay = LocalDate.of(year, month, day);
}

public String getName() {
return name;
}

public double getSalary() {
return salary;
}

public LocalDate getHireDay() {
return hireDay;
}

public void raiseSalary(double byPercent) {
double raise = salary * byPercent / 100;
salary += raise;
}
}

5. 包访问

标记为 public 的部分可以由任意类使用；标记为 private 的部分只能由定义它们的类使用。如果没有指定 public 或 private，这个部分（类、方法或变量）可以被同一个包中的所有方法访问。

没有标记修饰符的类只有在同一个包中其他类可以访问。对于类来说，这种默认方式是合乎情理的。但是，对于变量来说就有些不适宜了，变量必须显式地标记为 private，不然的话将默认为包可见。这样会破坏封装性。

在默认情况下，包不是一个封闭的实体。也就是说，任何人都可以向包中添加更多的类。

从 1.2 版开始，JDK 的实现者修改了类加载器，明确禁止加载包名以 “java.” 开头的用户自定义类！当然，用户自定义的类无法从这种保护中受益。另一种机制让 JAR 文件声明包为密封的（sealed），以防止第三方修改，但这种机制已经过时。现在应当使用模块封装包。