Java / 系统课时

包机制与代码组织

包机制与代码组织

包既是 Java 类型的命名空间,也是组织源代码的重要边界。本课通过一个拆分为 model 与 app 的最小项目,说明包声明、目录结构、导入、编译输出和运行类名如何对应。

学习目标

  • 理解包名与类型全限定名
  • 建立包声明和目录结构的映射
  • 从命令行编译并运行多包程序

包名、目录与类路径

com.anystack.model.User 由包名和类名共同组成,因此不同包可以存在同名类。普通 Java 源文件若有 package 声明,它出现在导入和类型声明之前,可以由注释或注解引领。建议让源目录与包名层级一致,方便工具按包名寻找源文件。

import 只简化源代码中的类型书写,不会复制类,也不会建立继承关系。编译时可用 -d 指定类文件输出根目录,运行时则通过类路径和全限定类名定位入口类。

Java 包名与目录映射

主示例

先创建目录:

text
src/
└── com/
    └── anystack/
        ├── app/
        │   └── Main.java
        └── model/
            └── User.java

src/com/anystack/model/User.java:

java
package com.anystack.model;

public class User {
    private final String name;

    public User(String name) {
        // public 构造方法允许其他包创建 User
        this.name = name;
    }

    public String greeting() {
        return "你好," + name;
    }
}

src/com/anystack/app/Main.java:

java
package com.anystack.app;

import com.anystack.model.User;

public class Main {
    public static void main(String[] args) {
        // import 后可使用简单类名 User
        User user = new User("Anystack");
        System.out.println(user.greeting());
    }
}

编译并运行:

bash
javac -d out src/com/anystack/model/User.java src/com/anystack/app/Main.java
java -cp out com.anystack.app.Main

预期输出:

text
你好,Anystack

关键边界

目录与 package 不一致时,IDE、编译器或构建工具可能无法正确定位类型。运行有包声明的主类时必须使用全限定类名,而不是只写 Main。

两个包中存在同名类时,不能同时通过简单名称导入;通常导入一个,另一个使用全限定名。包名一般使用反向域名并全部小写。

从类路径推算虚拟机查找的位置

运行 javac -d out ... 后,在项目根目录检查 out/com/anystack/app/Main.class 是否存在。-cp out 给出查找的起点,随后 Java 根据 com.anystack.app.Main 推导包目录和文件名。运行入口写类名,路径由类加载过程推导。

bash
java -cp out com.anystack.app.Main
java -cp out/com/anystack/app com.anystack.app.Main
java -cp out Main

第一条应输出 你好,Anystack。第二条的起点已经进入包目录,按包名继续查找就会找不到主类。第三条只会在类路径根目录查找无包的 Main。如果第一条也失败,先确认终端位于项目根目录,再核对编译产物。如果提示 User 无法访问,检查类型及构造方法是否需要对其他包声明为 public。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

包机制与代码组织

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通