Java中Iterable长度计算深度解析：从误区到最佳实践

public static <T> int getLength(Iterable<T> iterable) {
   int numEntries = 0;
   // 错误：Iterable接口没有hasNex()和next()方法
   while(iterable.hasNext()) { 
      numEntries++;
      iterable.next();
   }
   return numEntries;
}

import java.util.Iterator;

public static int getLength(Iterable<?> iterable) {
  int numEntries = 0;
  // 正确：先获取迭代器，再通过迭代器进行遍历
  Iterator<?> iterator = iterable.iterator(); 
  while(iterator.hasNext()) {
    numEntries++;
    iterator.next();
  }
  return numEntries;
}

import java.util.Collection;
import java.util.Iterator;

public class Toolkit { // 假设这是一个工具类

    /**
     * 尝试计算Iterable的长度。
     * 如果Iterable是Collection的实例，则返回其确切大小。
     * 否则，抛出IllegalArgumentException，因为无法保证通用的Iterable能提供准确或无副作用的长度。
     *
     * @param iterable 待计算长度的Iterable对象
     * @return Iterable的长度
     * @throws IllegalArgumentException 如果无法获取指定Iterable的长度
     */
    public static int getLength(Iterable<?> iterable) throws IllegalArgumentException {
        // 如果是Collection类型，直接使用其size()方法
        if (iterable instanceof Collection<?>) {
            return ((Collection<?>) iterable).size();
        }
        // 对于非Collection的Iterable，我们不应尝试遍历以获取长度，
        // 因为这可能导致一次性迭代器失效、性能问题或不准确的结果。
        // 因此，抛出异常以明确表示不支持此操作。
        throw new IllegalArgumentException(
            "无法获取类型为 " + iterable.getClass().getName() + " 的 Iterable 的长度，因为它不是 Collection 类型。"
        );
    }

    public static void main(String[] args) {
        // 示例用法
        java.util.List<String> myList = new java.util.ArrayList<>();
        myList.add("Apple");
        myList.add("Banana");
        myList.add("Cherry");

        try {
            int length1 = getLength(myList);
            System.out.println("List的长度: " + length1); // 输出：3
        } catch (IllegalArgumentException e) {
            System.err.println(e.getMessage());
        }

        // 模拟一个非Collection的Iterable (例如，自定义的流式Iterable)
        // 这里使用匿名内部类模拟一个一次性Iterable，它不是Collection
        Iterable<Integer> customIterable = new Iterable<Integer>() {
            private int count = 0;
            @Override
            public Iterator<Integer> iterator() {
                return new Iterator<Integer>() {
                    @Override
                    public boolean hasNext() {
                        return count < 3;
                    }

                    @Override
                    public Integer next() {
                        return count++;
                    }
                };
            }
        };

        try {
            int length2 = getLength(customIterable);
            System.out.println("Custom Iterable的长度: " + length2);
        } catch (IllegalArgumentException e) {
            System.err.println("尝试获取Custom Iterable长度失败: " + e.getMessage());
        }
    }
}