Какой знаешь метод в Iterable?

Методы интерфейса Iterable в Java

Интерфейс Iterable - это фундаментальный элемент Java Collections Framework, который позволяет объектам быть используемыми в for-each циклах (enhanced for loop). Рассмотрю основные методы и их практическое применение.

Основной метод: iterator()

Это единственный абстрактный метод в интерфейсе Iterable:

public interface Iterable<T> {
    Iterator<T> iterator();
}

Метод iterator() возвращает объект типа Iterator, который позволяет последовательно перебирать элементы коллекции.

Практический пример реализации

public class CustomCollection<T> implements Iterable<T> {
    private List<T> items = new ArrayList<>();
    
    public void add(T item) {
        items.add(item);
    }
    
    @Override
    public Iterator<T> iterator() {
        return items.iterator();
    }
}

// Использование
CustomCollection<String> collection = new CustomCollection<>();
collection.add("Java");
collection.add("Python");

for (String language : collection) {
    System.out.println(language);
}

Метод forEach() (Java 8+)

С Java 8 был добавлен default метод forEach(), который принимает Consumer:

public interface Iterable<T> {
    default void forEach(Consumer<? super T> action) {
        Objects.requireNonNull(action);
        for (T t : this) {
            action.accept(t);
        }
    }
}

// Использование
List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);
numbers.forEach(num -> System.out.println(num));

// Или с методом-ссылкой
numbers.forEach(System.out::println);

Метод spliterator() (Java 8+)

Еще один default метод для работы с parallel streams:

public interface Iterable<T> {
    default Spliterator<T> spliterator() {
        return Spliterators.spliteratorUnknownSize(
            iterator(),
            Spliterator.ORDERED
        );
    }
}

// Использование для параллельной обработки
List<Integer> numbers = Arrays.asList(1, 2, 3, 4, 5);
numbers.stream()
    .parallel()
    .forEach(num -> System.out.println(num));

Различия между методами

Практический пример: Custom Iterator

public class StringCollection implements Iterable<String> {
    private String[] items;
    
    public StringCollection(String... items) {
        this.items = items;
    }
    
    @Override
    public Iterator<String> iterator() {
        return new Iterator<String>() {
            private int index = 0;
            
            @Override
            public boolean hasNext() {
                return index < items.length;
            }
            
            @Override
            public String next() {
                if (!hasNext()) {
                    throw new NoSuchElementException();
                }
                return items[index++];
            }
        };
    }
}

// Использование
StringCollection collection = new StringCollection("A", "B", "C");
for (String item : collection) {
    System.out.println(item);
}

Сравнение способов итерации

List<String> fruits = Arrays.asList("Apple", "Banana", "Orange");

// 1. For-each loop (использует iterator())
for (String fruit : fruits) {
    System.out.println(fruit);
}

// 2. forEach() с lambda
fruits.forEach(fruit -> System.out.println(fruit));

// 3. Iterator напрямую
Iterator<String> iterator = fruits.iterator();
while (iterator.hasNext()) {
    System.out.println(iterator.next());
}

// 4. Stream API (использует spliterator())
fruits.stream()
    .forEach(System.out::println);

Когда использовать каждый метод

• iterator(): когда нужно получить полный контроль над итерацией, например для удаления элементов во время итерации
• forEach(): когда нужно просто применить операцию к каждому элементу
• spliterator(): когда нужна параллельная обработка через Stream API
• for-each loop: в большинстве обычных случаев - это самый читаемый вариант

Ключевые моменты

✓ Iterable позволяет использовать for-each loops
✓ iterator() - единственный обязательный метод для реализации
✓ forEach() и spliterator() - это default методы с Java 8
✓ Iterator позволяет безопасно удалять элементы во время итерации через remove()
✓ Spliterator оптимален для параллельной обработки

Эти методы - основа для работы с коллекциями в Java и критически важны для написания гибкого и масштабируемого кода.