如何避免使用内部方法污染 API 类？

Question

背景：

• 在 C# 中，您可以将 internal 方法限定为程序集 (JAR)
• 内部方法可以由该程序集中的其他类调用，但不能在外部调用。
• Java 没有这样的类比。
• 创建 API 时，我的内部方法必须是公开的，以便我的 API 的其他部分可以调用它们。
• 这会污染我的 API，并可能允许用户调用内部方法。

TLDR：鉴于这些方法是公开的，我如何指示（或者更好的是保护）我的 API 的内部方法不被我的 API 类之外的用户调用？

典型示例：

  // public class in com.ashes999.components
  class SpriteComponent {
    // This method should be internal
    public void dispose() { ... } 
  }

  // public class in com.ashes999.management
  class SceneManager {
    public void changeScene(Scene s) {
      for (SpriteComponent s : this.allEntities.allSprites) {
        s.dispose();
      }
    }
  }  

我只会在com.ashes999.* 自己的班级中致电SpriteComponent.dispose。我永远不会期望（甚至希望）其他用户会直接调用它；这样做会导致混乱、破坏、混乱和未受管理的资源被过早处置，从而导致崩溃。

Answer 1

可以使用修饰符 public 声明一个类，在这种情况下，该类对任何地方的所有类都是可见的。 如果一个类没有修饰符（默认值，也称为 package-private），则它仅在其自己的包中可见（包是相关类的命名组 - 您将在稍后了解它们教训。）

在成员级别，您还可以使用公共修饰符或不使用修饰符（包私有），就像顶级类一样，和同一个意思。对于成员，还有两个额外的访问修饰符：private 和 protected。 private 修饰符指定该成员只能在其自己的类中访问。 protected 修饰符指定该成员只能在其自己的包中访问（与 package-private 一样），此外，它的类在另一个包中的子类也可以访问。

(Access control)