Can list(), listByName(), listByNameAndType() returns Iterable instead of Iterator? about denominator HOT 2 CLOSED

So, the penalty usability-wise is java hasn't short-cutted Iterator loops, so you have to be explicit.

for (Iterator<ResourceRecordSetWithConfig<?>> i = api.list(); i.hasNext();) {
ResourceRecordSetWithConfig<?> rrset = i.next();
..
}

Iterable is syntactic sugar, like so:

for (ResourceRecordSetWithConfig<?> rrset : api.list()) {
..
}

However, doing iterable has a lot of network implications when called twice and requires persistence of means to call it twice. This is a lot of tradeoffs for syntax. If you aren't streaming, then maybe you can do this, which is similar sugar but without opening up a can of worms:

for (ResourceRecordSetWithConfig<?> rrset : ImmutableList.copyOf(api.list())) {
..
}

Can you use this syntax instead?

from denominator.

After chatting with Adrian, the intention of the Iterator is to indicate that each next() call may involve network call and only one iteration is allowed since there is no caching.

from denominator.