如何正确获取Java Iterable的长度

import java.util.Iterator;

public class Toolkit {

    /**
     * 通过迭代器计算Iterable的长度。
     * 注意：此方法会消耗迭代器，对于某些Iterable类型（如一次性流），
     * 后续的迭代将无法进行或得到不完整的结果。
     *
     * @param iterable 待计算长度的Iterable对象。
     * @return Iterable中元素的数量。
     */
    public static int getLength(Iterable<?> iterable) {
        int numEntries = 0;
        // 从Iterable获取一个迭代器
        Iterator<?> iterator = iterable.iterator();
        while (iterator.hasNext()) {
            numEntries++;
            iterator.next(); // 消耗元素以推进迭代器
        }
        return numEntries;
    }

    public static void main(String[] args) {
        // 示例用法
        java.util.List<String> myList = new java.util.ArrayList<>();
        myList.add("Apple");
        myList.add("Banana");
        myList.add("Cherry");
        System.out.println("List length: " + getLength(myList)); // 输出：List length: 3

        // 警告：对于某些Iterable（如Stream的迭代器），此方法可能导致后续无法再次迭代。
        // 例如，如果iterable是一个一次性数据源（如文件流或网络流），
        // 调用getLength后，该数据源可能已被完全消费，无法再次遍历。
    }
}

import java.util.Collection;

public class Toolkit {

    /**
     * 尝试获取Iterable的长度。
     * 如果Iterable是Collection的实例，则使用其size()方法获取长度。
     * 否则，抛出IllegalArgumentException，因为无法可靠地获取其长度。
     *
     * @param iterable 待计算长度的Iterable对象。
     * @return Iterable中元素的数量。
     * @throws IllegalArgumentException 如果无法获取指定Iterable的长度。
     */
    public static int getLength(Iterable<?> iterable) throws IllegalArgumentException {
        // 检查Iterable是否是Collection的实例
        if (iterable instanceof Collection<?>) {
            // 如果是Collection，直接调用其size()方法，这是最可靠和高效的方式
            return ((Collection<?>) iterable).size();
        } else {
            // 对于非Collection的Iterable，我们无法可靠地获取其大小
            // 因为遍历可能消耗迭代器，或者性能低下，或者结果不确定。
            // 抛出异常明确表示此操作不被支持或不可靠。
            throw new IllegalArgumentException(
                "无法获取类型为 " + iterable.getClass().getName() + " 的Iterable的长度。 " +
                "此方法仅支持实现java.util.Collection接口的Iterable。"
            );
        }
    }

    public static void main(String[] args) {
        // 示例用法
        java.util.List<String> myList = new java.util.ArrayList<>();
        myList.add("Apple");
        myList.add("Banana");
        myList.add("Cherry");
        System.out.println("List length: " + getLength(myList)); // 输出：List length: 3

        // 尝试传入一个不是Collection的Iterable (例如，一个自定义的仅可迭代一次的Iterable)
        // 这里为了演示，我们创建一个匿名类模拟一个非Collection的Iterable
        Iterable<Integer> customIterable = () -> new Iterator<Integer>() {
            private int count = 0;
            @Override
            public boolean hasNext() {
                return count < 3;
            }
            @Override
            public Integer next() {
                return count++;
            }
        };

        try {
            // 这将抛出IllegalArgumentException
            System.out.println("Custom Iterable length: " + getLength(customIterable));
        } catch (IllegalArgumentException e) {
            System.err.println(e.getMessage());
            // 输出：无法获取类型为 ...$1 的Iterable的长度。 此方法仅支持实现java.util.Collection接口的Iterable。
        }
    }
}