org.neo4j.collection.RawIterator Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of neo4j-collections Show documentation
Collections and collection utilities for Neo4j.
There is a newer version: 5.24.0
/*
 * Copyright (c) "Neo4j"
 * Neo4j Sweden AB [https://neo4j.com]
 *
 * This file is part of Neo4j.
 *
 * Neo4j is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see .
 */
package org.neo4j.collection;

import java.util.Iterator;
import java.util.NoSuchElementException;
import org.neo4j.function.ThrowingSupplier;
import org.neo4j.internal.helpers.collection.Iterators;

/**
 * Just like {@link Iterator}, but with the addition that {@link #hasNext()} and {@link #next()} can
 * be declared to throw a checked exception.
 *
 * @param  type of items in this iterator.
 * @param  type of exception thrown from {@link #hasNext()} and {@link #next()}.
 */
public interface RawIterator {
    boolean hasNext() throws EXCEPTION;

    T next() throws EXCEPTION;

    default void remove() {
        throw new UnsupportedOperationException();
    }

    RawIterator EMPTY_ITERATOR = RawIterator.of();

    @SuppressWarnings("unchecked")
    static  RawIterator empty() {
        return (RawIterator) EMPTY_ITERATOR;
    }

    static  RawIterator of(T... values) {
        return new RawIterator<>() {
            private int position;

            @Override
            public boolean hasNext() {
                return position < values.length;
            }

            @Override
            public T next() throws EX {
                if (hasNext()) {
                    return values[position++];
                }
                throw new NoSuchElementException();
            }
        };
    }

    /**
     * Create a raw iterator from the provided {@link ThrowingSupplier} - the iterator will end
     * when the supplier returns null.
     */
    static  RawIterator from(ThrowingSupplier supplier) {
        return new AbstractPrefetchingRawIterator<>() {
            @Override
            protected T fetchNextOrNull() throws EX {
                return supplier.get();
            }
        };
    }

    /**
     * Create a raw iterator from a regular iterator, assuming no exceptions are being thrown
     */
    static  RawIterator wrap(final Iterator iterator) {
        return Iterators.asRawIterator(iterator);
    }
}