Kiedy powinienem zaakceptować parametr Iterable vs. Collection w Javie?

An Iterable produkuje Iterator obiekty. Obiekt Iterator z definicji jest iteracją . Zauważ, że interfejs Iterator nie daje żadnej obietnicy ile razy next() może być wywołany przed hasNext() zwróci false. {[1] } może być iteracją nad wartościami Integer.MAX_VALUE + 1, zanim jej metoda hasNext() zwróci false.

Jednak Collection jest specjalną formą Iterable. Ponieważ Collection nie może mieć więcej niż Integer.MAX_VALUE elementów (na mocy metody size()), naturalnie zakłada się, że jego Iterator obiekty nie będzie iterować nad tak wieloma elementami.

Dlatego akceptując Collection zamiast Iterable, twoja klasa może mieć pewną gwarancję, ile elementów jest przekazywanych. Jest to szczególnie pożądane, jeśli twoja klasa sama w sobie jest Collection.

Użyj najbardziej ogólnego interfejsu, jaki możesz. Ponieważ wszystko, co zamierzasz zrobić, to iterację, to powiedziałbym, że Iterable jest drogą do zrobienia (ponieważ pozwala na leniwe Iteratory itp.). Nie obchodzi cię, skąd pochodzi iterator, więc nie ograniczaj go bardziej niż musisz.

Użytkownicy Spring Data JPA przekonają się, że Repositories zwracają zbiory typu Iterable<T>.

W projektach, nad którymi pracowałem w przeszłości, używających Spring, odkryłem, że potrzeba operowania na kolekcji po pobraniu często dyktowała, że Iterable<T> jest używana w warstwie biznesowej, a nie Collection<T> w celu wybrania obiektu T z kolekcji.

Wszystkie kolekcje to Iterable (czyli interfejsy rozszerzające interfejs Collection, a nie Map!), więc używanie Iterable w biznesie layer jest tylko przypadkiem odniesienia do zbioru przez jego super typ i nadal pozwala na użycie for-each do iteracji.

Jeśli chcesz manipulować zawartością kolekcji, wygodna metoda pozwoli Ci wypełnić nową Collection, abyś mógł skorzystać z contains(), remove(), itp z oryginalnymi danymi kolekcji.

Alternatywnie, metody wygody są dostarczane w tym celu przez popularne interfejsy API stron trzecich, takie jak Google Guava i Apache Commons.

Niektóre konstruktory, np. ArrayList (Kolekcja c), używają metody zbioru toArray() dla efektywności.

Zobacz " skąd taki nacisk na Iteratory i iterable?"na Google Collection FAQ za przyzwoity argument za preferowaniem iteratorów, zwłaszcza gdy mamy do czynienia z dużą ilością danych. Jedną z analogii, która może pomóc, jest myślenie o różnicy między kursorami tylko do odczytu do przodu i kursorami przewijalnymi.

Jeśli wybierzesz Collection, wtedy twoja klasa może być zainicjalizowana tylko z kolekcji, jeśli wybierzesz Iterable, wtedy możesz zainicjalizować ją z kolekcji lub iterable.

Ponieważ wysiłek i wydajność dla obu będzie taka sama, ma sens akceptowanie iterowalnych w konstruktorze.

Zgodnie z zasadą najmniejszego zaskoczenia, należy emulować wzorzec kolekcji Java i wziąć konstruktor kolekcji arg. To sprawi, że ludzie, którzy przyjdą po ciebie nieco mniej zdziwiony.

Masz rację, ponieważ jest to dobra praktyka, aby poprosić o najbardziej ogólną formę tego, czego potrzebujesz.