我的内部API类应该都在一个包中吗?

对于您的问题,有两种解决方案不涉及将所有类保持在同一个包中。

首先是使用朋友访问器/ Friend Package 模式描述见(实用API设计,Tulach 2008)。

第二个是使用OSGi。有篇文章 here 解释OSGi是如何实现这一点的。

相关问题: 1 , 2 , 3 和 4 .

一个例子是 Servlet API 正如您看到的,它们将通用servlet API和HTTP分为两个包。

如果在 api.jar 和 implementation.jar 您可以使用API.jar用户看不到的实现接口。 如果类的对象不管其包是什么,都必须以任何方式协作,那么方法当然必须是可见的(至少在实现中是可见的)。

是的,您只是无法保护内部实现人员不被访问。有一些技术(如OSGi)在运行时/应用程序启动期间提供解决方案。这是一个Java语言设计的模块化缺陷(但由于下兼容,以后很难添加)。

我喜欢将公开可见的工件添加到 /API 包装和内部构件 内部的 . 最后你会得到。

# this package is allowed to be accessed by api-users
com.foo.users.api
# this is completely internal logic (api implementation)
# should only be touched by the api-module itself.
com.foo.users.internal

这样您就有了清晰的分离,还可以运行静态代码分析代码规则。

像上面提到的servlet API一样,您甚至可以将API和impl进一步拆分到不同的jar中。但这涉及到更多的构建生命周期和维护模块的工作,所以我只会在完整的运行时工件分割有意义的情况下进行(就像在JSR规范和IMPL中一样)。