178. Java 包

了解包

在 Java 编程中，包（Package） 是一种将相关类型（如类、接口、枚举和注释类型）组合在一起的机制。包提供了以下几种主要的优势：

更易于查找和使用：通过组织类型，包帮助程序员更轻松地找到相关类型。
避免命名冲突：不同包中的类型可以有相同的名称，因为每个包都有自己的命名空间。
控制访问权限：包还提供了访问保护，确保包内的类型可以自由互相访问，但包外的类型访问受限。

Java 自带了许多标准库包，按功能将类型分组。例如：

java.lang 包包含基本类，如 String、Math 和 Object。
java.io 包包含输入输出相关的类，如 File 和 BufferedReader。
java.util 包包含常用的集合类，如 List 和 Map。

可以创建自己的包，并将自定义类型放入其中。

📌 包声明的规则

包声明位置 ：package 语句必须是源文件中的第一行。它指定了该文件中的所有类型属于哪个包。
每个源文件只能有一个包声明：一个源文件中只能包含一个包声明，这个声明适用于该文件中的所有类型。
公共类型限制 ：如果在同一个源文件中定义了多个类型，其中只有一个类型可以是 public，并且它的名称必须与源文件的名称相同。例如，如果文件名是 Circle.java，那么其中的 public class Circle 必须与文件名一致。
非公共类型的访问 ：非 public 类型只能在同一个包中访问。它们的访问级别是包私有（package-private），即只能在包内部使用。

📌 示例：使用包组织类型

假设编写了一组与图形对象相关的类，包括圆形（Circle）、矩形（Rectangle）、线条（Line）和点（Point）。此外，还编写了一个接口 Draggable，它表示某些类型可以被拖动。为了提高代码的可组织性和可维护性，可以将这些类和接口放入一个包中。

代码示例

Draggable 接口 （Draggable.java）

java 复制代码

package com.example.graphics;

public interface Draggable {
    void drag(int x, int y); // 拖动方法
}

Graphic 类 （Graphic.java）

java 复制代码

package com.example.graphics;

public abstract class Graphic {
    int x, y;

    public void moveTo(int x, int y) {
        this.x = x;
        this.y = y;
    }

    public abstract void draw(); // 每个具体的图形都有自己的绘制方式
}

Circle 类 （Circle.java）

java 复制代码

package com.example.graphics;

public class Circle extends Graphic implements Draggable {
    private int radius;

    public Circle(int x, int y, int radius) {
        this.moveTo(x, y);
        this.radius = radius;
    }

    @Override
    public void drag(int x, int y) {
        moveTo(x, y); // 移动圆的位置
    }

    @Override
    public void draw() {
        System.out.println("Drawing a circle at (" + x + ", " + y + ") with radius " + radius);
    }
}

Rectangle 类 （Rectangle.java）

java 复制代码

package com.example.graphics;

public class Rectangle extends Graphic implements Draggable {
    private int width, height;

    public Rectangle(int x, int y, int width, int height) {
        this.moveTo(x, y);
        this.width = width;
        this.height = height;
    }

    @Override
    public void drag(int x, int y) {
        moveTo(x, y); // 移动矩形的位置
    }

    @Override
    public void draw() {
        System.out.println("Drawing a rectangle at (" + x + ", " + y + ") with width " + width + " and height " + height);
    }
}

Point 类 （Point.java）

java 复制代码

package com.example.graphics;

public class Point extends Graphic implements Draggable {
    int x, y;

    public Point(int x, int y) {
        this.moveTo(x, y);
    }

    @Override
    public void drag(int x, int y) {
        moveTo(x, y); // 移动点的位置
    }

    @Override
    public void draw() {
        System.out.println("Drawing a point at (" + x + ", " + y + ")");
    }
}

Line 类 （Line.java）

java 复制代码

package com.example.graphics;

public class Line extends Graphic implements Draggable {
    Point start, end;

    public Line(Point start, Point end) {
        this.start = start;
        this.end = end;
    }

    @Override
    public void drag(int x, int y) {
        start.moveTo(x, y); // 移动线的起点
        end.moveTo(x + 10, y + 10); // 也移动线的终点
    }

    @Override
    public void draw() {
        System.out.println("Drawing a line from (" + start.x + ", " + start.y + ") to (" + end.x + ", " + end.y + ")");
    }
}

📌 组织代码的好处

可维护性：所有与图形相关的类和接口都集中在同一个包内，这样当其他开发人员查看代码时，他们能够快速识别这些类型属于同一个领域。
避免命名冲突 ：假设有一个名为 Circle 的类，它可以与其他库中的 Circle 类共存，因为它们处于不同的包（如 com.example.graphics.Circle 和 java.awt.Circle）。
易于扩展 ：当项目发展时，可以在同一个包内添加更多相关的类型，如 Polygon、Ellipse 等，而不会影响其他部分的代码。

📌 访问控制和包的作用

Java 中的包不仅用于组织类型，还可以通过访问修饰符来控制类型的访问权限。使用包可以限制外部访问，并允许包内的类型彼此自由访问。例如，类内的字段和方法可以使用 private、protected 或默认访问修饰符来限制访问。

访问控制示例：

java 复制代码

package com.example.graphics;

class Graphic {
    // 默认的访问修饰符（包级别），只有同一包内的类可以访问
    int x, y;
}

在这个示例中，x 和 y 变量的访问修饰符是 包级别的默认访问，这意味着它们只能被同一包中的类访问。如果其他包中的类尝试访问这些变量，将会报错。

📌 未使用包的情况：Unnamed Package

如果不在源文件中使用 package 语句，则这些类型将位于 Unnamed Package （未命名包）中。通常，Unnamed Package 只适用于小型或临时的应用程序，或者是刚开始开发阶段的项目。在实际的生产环境中，使用包来组织代码是推荐的做法。

未命名包的例子：

java 复制代码

// 没有使用 package 语句，默认处于未命名包中
public class Circle {
    // 类的内容
}

虽然在初期开发中，可以不使用包来快速编写代码，但随着项目规模的扩大，使用包来组织代码会显得更加清晰和高效。

📌 小结

包是组织 Java 类型的方式，它为类、接口等提供了一个命名空间和访问控制。
Java 中的许多标准类库被划分到不同的包中（如 java.util、java.io 等）。
自定义类型可以组织到包中，提供更好的代码管理、避免命名冲突、以及精细的访问控制。
包可以通过访问修饰符控制类型间的访问权限，从而增强代码的封装性和安全性。

通过合理使用包，可以更好地组织代码，增强项目的可维护性，并减少潜在的命名冲突。