[LANG-927] Create Iterable APIs

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Fix Version/s: Discussion
• Component/s: lang.*
• Assignee: Unassigned
• Reporter: Henri Yandell
• Created: 24/Oct/13 20:00
• Updated: 24/Oct/13 20:00

Description

LANG-848 suggests having Iterable APIs in addition to CharSequence... (or potentially other vararg methods).

Currently we have 10 Iterable APIs:

ClassUtils.hierarchy(final Class<?> type) {
ClassUtils.hierarchy(final Class<?> type, Interfaces interfacesBehavior) {
EnumUtils.generateBitVector(final Class<E> enumClass, final Iterable<E> values) {
EnumUtils.generateBitVectors(final Class<E> enumClass, final Iterable<E> values) {
StringUtils.join(final Iterable<?> iterable, final char separator) {
StringUtils.join(final Iterable<?> iterable, final String separator) {
StrBuilder.java.StrBuilder appendAll(final Iterable<?> iterable) {
StrBuilder.appendWithSeparators(final Iterable<?> iterable, String separator) {
Validate.noNullElements(final T iterable, final String message, final Object... values) {
Validate.noNullElements(final T iterable) {

There are many other methods that could have such, but continuing to add Iterable wherever we see varargs is going to bloat the API.

Perhaps adding a method to ArrayUtils (or IteratorUtils) can suffice:

public static E[] iteratorToArray(Iterator<E> iterator);

Issue Links

• relates to: LANG-848 Improve StringUtils.is(Not)Blank with a CharSequence... version