我应该返回集合还是流？

Question

假设我有一个方法将只读视图返回到成员列表中：

class Team {
    private List<Player> players = new ArrayList<>();

    // ...

    public List<Player> getPlayers() {
        return Collections.unmodifiableList(players);
    }
}

进一步假设客户机所做的只是立即对列表进行一次迭代。也许是为了把玩家放进一个JList或者别的什么。客户端没有存储对列表的引用以供以后检查！

对于这种常见的场景，我是否应该返回一个流呢？

public Stream<Player> getPlayers() {
    return players.stream();
}

还是返回流在Java中不是惯用的？流被设计成总是在创建它们的同一个表达式中“终止”吗？

Answer 1

答案是一如既往的“视情况而定”。这取决于返回的收藏会有多大。这取决于结果是否随时间变化，以及返回结果的一致性有多重要。这在很大程度上取决于用户可能如何使用答案。

首先，请注意，您始终可以从流中获取集合，反之亦然：

// If API returns Collection, convert with stream()
getFoo().stream()...

// If API returns Stream, use collect()
Collection<T> c = getFooStream().collect(toList());

所以问题是，哪一个对你的呼叫者更有用。

即使您知道用户将多次迭代它或保留它，您仍然可能希望返回一个流，因为一个简单的事实，即您选择将它放入的任何集合（例如，ArrayList)可能不是他们想要的表单，然后调用者必须复制它。如果返回一个流，他们可以执行collection(toCollection(factory))并以他们想要的形式获得它。

以上“偏爱流”的案例，大多源于流更灵活；您可以对如何使用它进行后期绑定，而不会产生将它物化到集合中的成本和限制。

必须返回集合的一种情况是有很强的一致性要求，并且必须生成移动目标的一致快照。然后，您需要将元素放入一个不会更改的集合中。

所以我要说，大多数时候，Stream是正确的答案--它更灵活，不会增加通常不必要的物化成本，并且如果需要，可以很容易地转换为您选择的集合。但有时，您可能必须返回集合（例如，由于强烈的一致性要求），或者您可能希望返回集合，因为您知道用户将如何使用它，并且知道这对他们来说是最方便的事情。

如果您已经有一个合适的集合“到处都是”，并且您的用户似乎更愿意将其作为集合进行交互，那么仅仅返回您所拥有的内容是一个合理的选择（尽管不是唯一的选择，而且更脆弱）。