должен ли я вернуть коллекцию или поток?

<p>предположим, у меня есть метод, который возвращает представление только для чтения в список участников:</p><pre><code>class team { private list<player> players = new arraylist<>(); // ... public list<player> getplayers() { return collections.unmodifiablelist(players); } } </code></pre><p>далее предположим, что все, что делает клиент, это итерация по списку один раз, немедленно. возможно поместить игроков в jlist или что-то. клиент <em>не</em> сохраняет ссылку на список для последующей проверки!</p><p>учитывая этот общий сценарий, я должен вместо этого вернуть поток?</p><pre><code> public stream<player> getplayers() { return players.stream(); } </code></pre><p>или возвращает поток не-идиоматических в java? были ли потоки предназначены для того, чтобы всегда быть "завершенными" внутри одного и того же выражения, в котором они были созданы?</p>

<p>ответ, как всегда, "это зависит". это зависит от того, насколько большой будет возвращенная коллекция. это зависит от того, изменяется ли результат с течением времени, и насколько важна согласованность возвращаемого результата. и это очень сильно зависит от того, как пользователь может использовать ответ.</p><p>во-первых, обратите внимание, что вы всегда можете получить коллекцию из потока, и наоборот:</p><pre><code>// if api returns collection, convert with stream() getfoo().stream()... // if api returns stream, use collect() collection<t> c = getfoostream().collect(tolist()); </code></pre><p>таким образом, вопрос в том, что более полезно для ваших абонентов.</p><p>если ваш результат может быть бесконечным, есть только один выбор: поток.</p><p>если ваш результат может быть очень большим, вы, вероятно, предпочли бы stream, так как может не иметь смысла материализовать его все сразу, и это может создать значительное давление кучи.</p><p>если все, что собирается сделать вызывающий объект, - это перебрать его (поиск, фильтр, агрегат), вы должны предпочесть stream, так как stream уже имеет эти встроенные функции, и нет необходимости материализовать коллекцию (особенно, если пользователь может не обрабатывать весь результат.) это очень распространенный случай.</p><p>даже если вы знаете, что пользователь будет повторять его несколько раз или иным образом хранить его, вы все равно можете захотеть вернуть stream вместо этого, потому что тот факт, что независимо от выбранной вами коллекции (например, arraylist), может не быть форма, которую они хотят, и тогда звонящий должен все равно скопировать это. если вы возвращаете поток, они могут выполнить <code>collect(tocollection(factory))</code> и получить его в той форме, которую они хотят.</p><p>вышеупомянутые случаи "предпочтения stream" в основном происходят из-за того, что stream более гибок; вы можете позднее связать с тем, как вы используете его, не неся при этом затрат и ограничений, связанных с его материализацией в коллекцию.</p><p>единственный случай, когда вы должны вернуть коллекцию, - это когда существуют строгие требования согласованности, и вы должны создать согласованный снимок движущейся цели. затем вы захотите поместить элементы в коллекцию, которая не изменится.</p><p>поэтому я бы сказал, что чаще всего stream является правильным ответом - он более гибкий, он не требует обычно ненужных затрат на материализацию и может быть легко превращен в коллекцию по вашему выбору, если это необходимо. но иногда вам может понадобиться вернуть коллекцию (скажем, из-за строгих требований согласованности), или вы можете захотеть вернуть коллекцию, потому что вы знаете, как ее будет использовать пользователь, и знаете, что это наиболее удобно для них.</p>

<p>у меня есть несколько моментов, которые нужно добавить к <a href="https://stackoverflow.com/a/24679745/1441122">отличный ответ брайана гетца</a> .</p><p>весьма распространено возвращать stream из вызова метода в стиле "getter". смотрите <a href="http://docs.oracle.com/javase/8/docs/api/java/util/stream/class-use/stream.html">страница использования потока</a> в javadoc java 8 и ищите "методы ..., которые возвращают stream" для пакетов, отличных от <code>java.util.stream</code>. эти методы обычно используются в классах, которые представляют или могут содержать несколько значений или совокупностей чего-либо. в таких случаях api обычно возвращают коллекции или массивы из них. по всем причинам, которые брайан отметил в своем ответе, очень гибко добавить сюда методы, возвращающие поток. многие из этих классов уже имеют методы, возвращающие коллекции или массивы, потому что классы предшествуют api streams. если вы разрабатываете новый api, и имеет смысл предоставить методы, возвращающие поток, возможно, нет необходимости добавлять методы, возвращающие коллекцию.</p><p>брайан упомянул стоимость "материализации" ценностей в коллекцию. чтобы усилить этот момент, на самом деле здесь есть две затраты: стоимость хранения значений в коллекции (выделение памяти и копирование), а также стоимость создания значений в первую очередь. последнюю стоимость часто можно уменьшить или избежать, воспользовавшись ленивым поведением stream. хорошим примером этого являются api в <code>java.nio.file.files</code>:</p><pre><code>static stream<string> lines(path) static list<string> readalllines(path) </code></pre><p>мало того, что <code>readalllines</code> должен хранить все содержимое файла в памяти, чтобы сохранить его в списке результатов, он также должен прочитать файл до самого конца, прежде чем он вернет список. метод <code>lines</code> может возвращаться почти сразу после того, как он выполнил некоторую настройку, оставляя чтение файла и разрыв строки до более позднего момента, когда это необходимо - или нет вообще. это огромное преимущество, если, например, звонящий интересуется только первыми десятью строками:</p><pre><code>try (stream<string> lines = files.lines(path)) { list<string> firstten = lines.limit(10).collect(tolist()); } </code></pre><p>конечно, можно сэкономить значительное место в памяти, если вызывающий фильтр фильтрует поток так, чтобы он возвращал только строки, соответствующие шаблону и т.д.</p><p>идиома, которая, кажется, появляется, состоит в том, чтобы называть методы, возвращающие поток, во множественном числе от имени вещей, которые он представляет или содержит, без префикса <code>get</code>. кроме того, хотя <code>stream()</code> является разумным именем для метода, возвращающего поток, когда существует только один возможный набор значений, которые должны быть возвращены, иногда существуют классы, которые имеют совокупности значений нескольких типов. например, предположим, что у вас есть какой-то объект, который содержит как атрибуты, так и элементы. вы можете предоставить два api, возвращающих поток:</p><pre><code>stream<attribute> attributes(); stream<element> elements(); </code></pre>

<p>в отличие от коллекций, потоки имеют <a href="https://stackoverflow.com/questions/46644595/understanding-deeply-spliterator-characteristics">дополнительные характеристики</a> . поток, возвращаемый любым методом, может быть:</p><ul> <li>конечный или бесконечный</li> <li>параллельный или последовательный (перенос с собственным выбором пула потоков)</li> <li>заказанный или не заказанный</li> </ul><p>эти различия также существуют в коллекциях, но там они являются частью очевидного контракта:</p><ul> <li>все коллекции имеют размер, iterator/iterable может быть бесконечным.</li> <li>коллекции явно упорядочены или не упорядочены</li> <li>к счастью, параллельность - это не то, о чем заботится коллекция, кроме безопасности потоков.</li> </ul><p>для потребителя потока (из метода return или в качестве параметра метода) это, к сожалению, очень опасная и запутанная ситуация. чтобы убедиться, что ваш алгоритм работает правильно, вы должны убедиться, что он отвечает, как определено, различным характеристикам, которые задает поток. и это очень сложно сделать. в модульном тестировании это будет означать, что вы должны умножить все ваши тесты, которые будут повторяться, с тем же содержимым потока, но с потоками, которые</p><ul> <li>(конечный, упорядоченный, последовательный)</li> <li>(конечный, упорядоченный, параллельный)</li> <li>(конечный, неупорядоченный, последовательный) ...</li> </ul><p>вы даже не можете просто обойти проблему, написав методы защиты, которые выдают исключение illegalargumentexception, если входной поток имеет характеристики, нарушающие ваш алгоритм, потому что свойства скрыты.</p><p>это оставляет stream только как допустимый выбор в сигнатуре метода, когда ни одна из характеристик не имеет значения для алгоритма потребления. поскольку вы никогда не знаете, какую обработку кто-то еще захочет сделать с результатом вашего алгоритма, вы никому не сделаете одолжение, используя stream в публичной сигнатуре метода.</p><p>гораздо безопаснее использовать datatype в сигнатурах методов с явным контрактом (и без неявной обработки пула потоков), что делает невозможным случайную обработку данных с неправильными предположениями об упорядоченности, размерности или параллельности (и использовании пула потоков).</p>

<blockquote> <p>были ли потоки предназначены для того, чтобы всегда быть "завершенными" внутри одного и того же выражения, в котором они были созданы?</p> </blockquote><p>вот как они используются в большинстве примеров.</p><p>примечание: возврат потока не так уж отличается от возврата итератора (допускается с гораздо большей выразительностью)</p><p>имхо, лучшее решение - заключить в капсулу, почему вы это делаете, а не возвращать коллекцию.</p><p>например.</p><pre><code>public int playercount(); public player player(int n); </code></pre><p>или если вы собираетесь их посчитать</p><pre><code>public int countplayerswho(predicate<? super player> test); </code></pre>

<p>если поток конечен, и есть ожидаемая/нормальная операция с возвращенными объектами, которая вызовет проверенное исключение, я всегда возвращаю коллекцию. потому что, если вы собираетесь что-то делать с каждым из объектов, которые могут вызвать исключение проверки, вы будете ненавидеть поток. один реальный недостаток потоков - невозможность элегантно работать с проверенными исключениями.</p><p>теперь, возможно, это признак того, что вам не нужны проверенные исключения, что справедливо, но иногда они неизбежны.</p>

<blockquote> <p>возможно, фабрика stream будет лучшим выбором. большим преимуществом только экспонирования коллекций через stream является то, что он лучше инкапсулирует структуру данных вашей доменной модели. при использовании классов вашего домена невозможно повлиять на внутреннюю работу вашего списка или сета, просто раскрыв поток.</p> <p>это также побуждает пользователей вашего класса домена писать код в более современном стиле java 8. существует возможность поэтапного рефакторинга в этом стиле, сохранив существующие геттеры и добавив новые потоковые геттеры. со временем вы можете переписать свой прежний код, пока окончательно не удалите все получатели, которые возвращают список или набор. этот вид рефакторинга действительно хорош после того, как вы очистили весь старый код!</p> </blockquote>

<p>я думаю, это зависит от вашего сценария. может быть, если вы заставите свой <code>team</code> реализовать <code>iterable<player></code>, этого будет достаточно.</p><pre><code>for (player player : team) { system.out.println(player); } </code></pre><p>или в функциональном стиле:</p><pre><code>team.foreach(system.out::println); </code></pre><p>но если вы хотите более полный и свободный api, поток может быть хорошим решением.</p>