如何在 Java 中不公开公共接口

Question

在我的项目 jOOQ 中，我使用复杂的数据结构对 SQL 查询进行建模。查询的所有组件都实现

public interface QueryPart {
  int bind(java.sql.PreparedStatement stmt);
  int bind(java.sql.PreparedStatement stmt, int initialIndex);
  SQLDialect getDialect();
  String toSQLDeclaration();
  String toSQLDeclaration(boolean inlineParameters);
  String toSQLReference();
  String toSQLReference(boolean inlineParameters);
}

该接口的方法，由库的所有包在内部使用来构造和执行 SQL。不应直接从客户端代码调用它们。为此，我添加了

public interface QueryPartProvider {
  QueryPart getQueryPart();
}

Which is the only publicly expose 接口。实际查询部分的一个示例是：

public interface Table extends QueryPartProvider {}
class TableImpl implements QueryPart, Table {}

如您所见，QueryPart 方法只能通过 Table.getQueryPart().toSQLDeclaration() 等访问。

我的设计有助于阻止直接访问 QueryPart 方法，但无法完全隐藏。我的问题是：谁能告诉我一个好的设计模式来实现这个目标？

注意：最简单但不是很好的解决方案是将所有对象转换为 QueryPart，例如 ((QueryPart)表).toSQLDeclaration()

Answer 1

接口的所有方法始终是公共的，因此您无法访问库客户端也无法访问的内容。
也许您可以使用 Table 的抽象类和受包保护的 getQueryPart() 方法来实现您想要的目的。但我不确定我是否想要这样做，而不是从 Table 到 TableImpl 的转换。

Answer 2

在实现了与 sfussenegger 建议类似的方法后，我想出了一个更好的解决方案，涉及适配器设计模式。这是总体概要：

/**
 * Objects providing an internal API implement this interface
 */
public interface Adapter {

  /**
   * Dynamically expose an (publicly unknown) internal API. 
   */
  <T> T internalAPI(Class<T> internalType) throws ClassCastException;
}

此适配器类型是向公众公开的有关任何内部内容的唯一事实。只有包私有实现方法知道此方法的可能参数（以及那些真正想要实际使用内部 API 来解决方法、扩展等的黑客）。

/**
 * This type contains the public API for a QueryPart
 */
public interface QueryPart extends Adapter {
// [...]
}

/**
 * This type contains the internal API for a QueryPart
 */
public interface QueryPartInternal extends QueryPart {
// [...]
}

上面的QueryPart和QueryPartInternal是相关的。这一事实为公众所知，但没有公共类/类型扩展 QueryPartInternal。只有以下包私有类及其无数子类可以：

/**
 * This class is the base class for all QueryParts.
 * It is package private and thus doesn't expose anything
 */
abstract class AbstractQueryPart implements QueryPartInternal {
  // [...]

  /**
   * For other package private implementation methods
   */
  @Override
  public final <T> internalAPI(Class<T> internalType) {
    return internalType.cast(this);
  }

  /**
   * Convenience method for subclasses heavily using the
   * internal API
   */
  protected final QueryPartInternal internal(QueryPart part) {
    return part.internalAPI(QueryPartInternal.class);
  }
  // [...]
}

Answer 3

您能解释一下为什么您想这样做吗？我能看到的唯一原因是使您的库的用户无法实现该界面。

我认为这不是一个好方法。只需添加一些 Javadoc 并解释为什么实现它没有意义。但最后，让用户决定是否有正当理由创建自定义实现。预见每一个用例总是很困难。

如果有人坚持他的方法，那肯定不是你的错 - 他不能说他没有被警告:)

举个例子，这就是你可以在 Apache Wicket 的源代码中找到的内容：

/**
 * THIS IS WICKET INTERNAL ONLY. DO NOT USE IT.
 * 
 * Traverses all behaviors and calls ...
 */

编辑：
只是另一个：你可以尝试这个，尽管我仍然不鼓励它 - 不要说你没有被警告过；）

public interface ExposedInterface {
  void foo();
}

// only default visibility
interface InternalInterface extends ExposedInterface {
  // nothing here
}

// and here some methods
ExposedInterface get(); // user can use it

void set(InternalInterface obj); // user is out of luck here