Java 7 API 设计最佳实践——返回 Array 或返回 Collection

Question

我知道在泛型问世之前已经有人问过这个问题。鉴于 Array 强制执行返回类型，Array 确实有点胜出，它更加类型安全。

但是现在，使用最新的 JDK 7，每次我设计这种类型的 API 时:

public String[] getElements(String type)
vs
public List<String> getElements(String type)

我一直在努力想出一些好的理由来返回 A Collection 而不是 Array 或其他方式。在选择 String[] 或 List 作为 API 的返回类型时，最佳做法是什么？或者是马匹类(class)。

我心中没有特例，我更想寻找通用的优缺点比较。

Answer 1

如果您正在编写公共(public) API，那么您的客户通常会更喜欢集合，因为它们更易于操作并与代码库的其余部分集成。另一方面，如果您希望在对性能高度敏感的上下文中使用您的公共(public) API，则首选原始数组。

如果您编写此代码供自己使用，最好的做法是从集合类型开始，并且只有在涉及到明确的性能问题时才切换到数组。

数组的元素类型可以在运行时通过反射确定，因此如果该特定功能对您很重要，那将是另一种情况，更喜欢数组。