将公共 API 转换为内部粘合代码时避免强制转换

Question

因此，我的应用程序公开了这个公共 API，允许客户编写插件。 对于这个例子，假设这是一个相当简单的键值对系统，类似于：

public interface Key {
  // marker interface, guaranteed unique in some scope
}

public interface KVPService {
  Set<Key> getKeys();
  Object getValue(Key k); // must be a key provided by getKeys() or it blows up
}

现在假设在内部，Key 有一些不应该公开的属性 - 比如说数据库 ID。 我目前正在做的是这样的：

/** Internal impl of external Key */    
class InternalKey implements Key {
  int getDatabaseId() {
    // do something...
  }
}

/** Internal impl of external KVPService */    
class InternalKVPService implements KVPService {
  // ...

  public Object getValue(Key k) {
    InternalKey ik = (InternalKey) k;
    return getValueFromDBOrWherever(ik.getDatabaseId());
  }

  // ...
}

这似乎不太理想。 有什么方法可以重新安排职责以避免强制转换并仍然保持内部/外部封装？

请注意，在现实世界中，情况比这要复杂一些； Key 等价物附加了相当多的元数据，除了获取一个简单的值之外，人们可能还想用它来做很多事情，所以只需公开，比如说，Map.Entry<相反，类似 /code> 的对象不一定能解决问题。

我唯一能想到的就是将内部键和外部键完全分开，并保留一个 Map。 但在这种情况下，我必须复制元数据，这违反了 DRY，或者将外部 Key 委托给 InternalKey，在这种情况下 Map< /code> 违反了 DRY。

有人能想出更聪明的办法吗？

Answer 1

我见过的一种方法是为所有对象（在本例中为键）公开一个公共接口，并提供一个基本实现，该实现只需为每个方法抛出 UnsupportedOperationException （或不执行任何操作）。 然后子类实现随后重写方法以提供功能。 虽然它不太像 OO，但您会在 JDK API 中找到一些示例（例如 Iterator 的 remove() 方法）。

另一种选择：您可以使用 visitor 模式让每个对象执行功能而无需向下转换； 例如，

public interface KeyVisitor {
  void visitInternalKey(InternalKey k);
  void visitFooBarKey(FooBarKey k);
}

public interface Key {
  void visit(KeyVisitor kv);
}

public class InternalKey implements Key {
  public void visit(KeyVisitor kv) {
    kv.visitInternalKey(this);
  }
}

这里的缺点是您必须公开 InternalKey 上的方法（至少通过接口）以允许您的访问者实现调用它们。 但是，您仍然可以将实现细节保留在包级别。

Answer 2

我不这么认为。 但为什么类型转换会让你担心呢？ 潜在的 ClassCastException 在实践中不会发生（假设我了解您的用例），转换只需要 5 条左右的机器指令，并且它对 KPService API 的调用者是隐藏的。