本文探讨在Java中，当一个公共类和一个包私有（default）类位于同一文件，且测试类位于不同包时，如何进行单元测试。我们将深入分析Java的访问修饰符规则，解释为何初始设置可能导致编译失败，并提供多种有效的解决方案，包括调整类可见性、使用内部类，以及合理的项目结构，以确保代码的可测试性和维护性。
引言：Java类可见性与单元测试的交错
在Java开发中，单元测试是确保代码质量的关键环节。然而，当涉及到类的访问修饰符，特别是包私有（default）类时，开发者可能会遇到一些挑战。一个常见的问题场景是：一个公共类（public class A）和一个非公共类（class B，即包私有）被定义在同一个.java源文件中，并且公共类A依赖于包私有类B。此时，如果尝试从另一个包中的单元测试类（ATest）直接实例化或引用包私有类B，通常会导致编译错误。
例如，考虑以下结构：
-
主代码包： src.main.java
立即学习“Java免费学习笔记（深入）”；
// src/main/java/A.java package src.main.java; public class A { public String doSomething(B objB){ return objB.getName(); } } class B { // 包私有（default）类 private String name; public B(String name){ this.name = name; } public String getName(){ return name; } } -
测试代码包： src.test.java
// src/test/java/ATest.java package src.test.java; import org.junit.Test; import static org.junit.Assert.assertEquals; import src.main.java.A; // import src.main.java.B; // 尝试导入B会失败，因为B是包私有且不在当前包 public class ATest { @Test public void test01() { // 编译错误：B cannot be resolved to a type // assertEquals("Name1", new A().doSomething(new B("Name1"))); } }在这种情况下，由于B是包私有的，并且ATest位于不同的包src.test.java中，ATest无法直接访问或实例化B，从而阻碍了对A的完整单元测试。
Java访问修饰符的核心规则
要理解上述问题，首先需要回顾Java的访问修饰符：
- public： 任何地方都可见。
- protected： 同一包内可见，或不同包的子类可见。
- default (包私有)： 仅在同一包内可见。
- private： 仅在同一类内可见。
对于顶级类（非嵌套类），只能使用public或default修饰符。当一个类没有显式声明public时，它默认为default（包私有）。这意味着，如果class B被定义为包私有，它只能被src.main.java包内的其他类访问。
原始问题场景分析：为何默认行为会导致失败
根据Java的访问修饰符规则，如果B类在src.main.java包中被声明为包私有，那么任何尝试从src.test.java包访问B的操作都将导致编译错误。这是因为src.test.java和src.main.java是两个不同的包，B的可见性范围不包含src.test.java。这正是上述示例中ATest无法实例化B的原因。
可行的解决方案与实践
针对这类问题，有多种解决方案可以确保代码的可测试性。
方案一：将测试类置于同一包中（特定场景下的工作方式）
一种看似简单的解决方案是将测试类ATest也放置在与A和B相同的包中。虽然这在技术上可行，因为它满足了包私有类的访问条件，但在实际项目结构中，这通常不被推荐，因为它混淆了生产代码和测试代码的边界。
示例代码（基于提供的答案）： 假设我们将所有类都放在com.example包下。
// src/main/java/com/example/A.java (或者直接在com/example目录下)
package com.example;
public class A {
public String doSomething(B objB){
return objB.getName();
}
}
class B { // 包私有（default）类
private String name;
public B(String name){
this.name = name;
}
public String getName(){
return name;
}
}
// src/test/java/com/example/ATest.java (或者直接在com/example目录下)
package com.example;
import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.api.Test;
public class ATest {
@Test
public void test01() {
// 在同一包内，B是可访问的
assertEquals("Name1", new A().doSomething(new B("Name1")));
}
}注意事项： 尽管这种方法能使测试通过，但在标准的Maven或Gradle项目中，生产代码通常位于src/main/java，测试代码位于src/test/java，并且这两个目录下的同名包会被视为不同的逻辑包。因此，将测试类放在生产代码的同一包中，通常意味着将测试文件直接放在src/main/java下，这破坏了项目结构的最佳实践。
方案二：将包私有类声明为公共静态内部类
如果类B的功能与类A紧密相关，并且B的存在主要是为了辅助A，那么将其声明为A的公共静态内部类是一个合理的选择。这样，B的完整名称将是A.B，并且由于A是公共的，A.B也将在外部可见。
示例代码：
// src/main/java/src/main/java/A.java
package src.main.java;
public class A {
public String doSomething(B objB){
return objB.getName();
}
// 将B声明为A的公共静态内部类
public static class B {
private String name;
public B(String name){
this.name = name;
}
public String getName(){
return name;
}
}
}
// src/test/java/src/test/java/ATest.java
package src.test.java;
import org.junit.Test;
import static org.junit.Assert.assertEquals;
import src.main.java.A;
public class ATest {
@Test
public void test01() {
// 通过 A.B 访问内部类
assertEquals("Name1", new A().doSomething(new A.B("Name1")));
}
}适用场景： 当内部类与外部类有强烈的逻辑关联，且内部类不应独立存在时。
方案三：将包私有类独立为公共类
这是最推荐的做法，也最符合面向对象设计原则。如果一个类（如B）是一个独立的实体，即使它目前只被A使用，也应该将其定义为public class，并放在自己的.java文件中。这样，它就可以被任何其他包中的类（包括测试类）导入和使用。
示例代码：
// src/main/java/src/main/java/A.java
package src.main.java;
public class A {
public String doSomething(B objB){
return objB.getName();
}
}
// src/main/java/src/main/java/B.java
package src.main.java;
public class B { // 现在B是一个公共类
private String name;
public B(String name){
this.name = name;
}
public String getName(){
return name;
}
}
// src/test/java/src/test/java/ATest.java
package src.test.java;
import org.junit.Test;
import static org.junit.Assert.assertEquals;
import src.main.java.A;
import src.main.java.B; // 现在B可以被正常导入
public class ATest {
@Test
public void test01() {
assertEquals("Name1", new A().doSomething(new B("Name1")));
}
}推荐做法： 这是最清晰、最模块化的设计，使得类B可以被独立测试和重用，并且遵循了标准的项目结构。
单元测试的最佳实践建议
- 保持生产代码与测试代码的隔离： 始终将生产代码（src/main/java）和测试代码（`src/
