Kotlin internal与Java package-private的差异及Java等效实现方案

我有两个独立项目：

• 第一个是API项目：以接口定义为主、极少实现，可作为依赖供他人使用；
• 第二个是API实现项目：不可被外部开发者访问。

在Java实现中，由于UserServiceImpl是package-private（默认权限），AccountServiceImpl无法访问甚至导入它；而用Kotlin的internal修饰符实现时该问题可解决。我原本以为二者权限作用相同，但实际存在差异。目前Java实现有两个不理想的选择：

• 将类设为public以支持分包但暴露实现；
• 保持package-private权限但无法分包。

我希望既能隐藏实现又能合理分包，因此想了解以下三个问题：

1. internal与package-private的差异是什么？
2. Java中能否实现类似internal的效果？
3. Java 11的模块系统能否解决该问题？

一、internal与package-private的核心差异 #

• 作用范围天差地别：
  • Java的package-private：仅对同一个包内的类开放访问权限，哪怕是同项目下的其他包也无法访问。
  • Kotlin的internal：对同一模块内的所有类开放权限——这里的模块指同一个Gradle/Maven项目、IntelliJ模块这类编译单元，不管类分到哪个包，只要在同一个模块里，就能互相访问。
• 设计初衷不同：
  • package-private是Java早期为包级封装设计的，主打细粒度的包内隔离；
  • internal是Kotlin专门针对"同一项目内跨包但不想对外暴露实现"的场景设计的，刚好匹配这类分包隐藏需求。

二、Java中实现类似internal效果的方案 #

Java没有直接对应internal的修饰符，但有几种模拟方式：

• 模块系统（Java 9+）：最规范的方案，后面单独展开；
• 包名巧规划：把需要互相访问的实现类放进同一个父包的子包，用protected配合继承跨包访问，但仅适用于继承场景，局限性大；或者把所有实现类放在同一个Java包下，用目录结构做逻辑分包，但本质还是同一个包，没解决真正的分包问题；
• 反射：通过反射强行访问package-private的类，但属于hack手段，破坏封装，不适合生产环境；
• 工具类中转：在目标类的包下写一个public工具类作为访问入口，委托方法给目标类，但会暴露工具类，无法完全隐藏实现细节。

三、Java 11模块系统能解决这个问题吗？ #

完全可以！Java 9引入的模块系统就是为了解决模块级封装的问题，完美匹配你的需求：

具体操作步骤 #

1. 把API实现项目定义成一个模块，创建module-info.java文件，声明模块名并配置暴露规则：

   module com.example.api.impl {
       // 对外暴露API接口所在的包，供API项目或外部依赖使用
       exports com.example.api;
       // 实现类所在的包不对外暴露，模块内所有包默认可互相访问
   }
   

2. 模块内的所有包，不管实现类是package-private还是其他权限（除private），都能自由跨包访问；
3. 如果需要让特定模块（比如测试模块）访问实现包，可以用exports ... to精准开放：

   exports com.example.api.impl.user to com.example.api.test;
   

核心优势 #

• 既支持模块内跨包自由访问，又能彻底对外隐藏实现类；
• 权限控制粒度精准到模块，比package-private灵活得多，完全满足"隐藏实现+合理分包"的要求。

内容的提问来源于Stack Exchange，提问作者Matthew Layton