Apache Commons Collections

De EjnTricks

La librairie Commons Collections offrent un ensemble d'outils pour manipuler les "listes" en Java. Cet article présente des utilisations courament mises en place, permettant de simplifier le code tant en compléxité que couverture de tests.

A noter qu'il existe plusieurs versions de cette librairie. Afin de garantir une montée de version sans conflit, les développeurs ont changé le nom des packages entre la version 3 et 4. Ainsi, il est possible de profiter facilement de la nouvelle version, dans des projets qui utilisaient une ancienne version, cmme cela peut être le cas d'intégration de progiciels. Certains exemples ne sont disponibles que sur les dernières versions de la librairie, mais cela donne une première vue d'ensemble sur les possibilités. Il est imortant d'étudier les utilitaires disponibles pour profiter de la puissance de la librairie.

File-find-icon.png Filtre

Update icon.png Transformation

Start-icon.png Exécution

Tool-box.png Utilitaires collections

Mylogs-icon.png Résumé

La librairie est très riche et il est important d'explorer les différents utilitaires fournis. Le tableau suivant résume les principaux utilisés dans les différents projets.

Fonction Description
org.apache.commons.collections4.CollectionUtils
addIgnoreNull Fonction qui permet d'ajouter un élément à une collection, uniquement si celui-ci est non null.
isEmpty Fonction qui permet de tester si une collection est null ou vide.
isNotEmpty Fonction qui permet de tester si une collection n'est pas null et contient au moins un élément.
select Fonction de sélection d'éléments, dans une nouvelle collection, depuis une collection source avec un Predicate. Permet d'extraire des éléments en fonction d'un critère.

Si aucune collection cible n'est fournie en argument, une instance de ArrayList est créée.

selectRejected Effectue l'invers de select en retournant que les éléments non validés par l'instance de Predicate.
org.apache.commons.collections4.IterableUtils (depuis 4.1)
find Fonction de recherche d'un élément dans une instance de Iterable avec un Predicate.
forEach Fonction pour exécuter un action sur tous les éléments une instance de Iterable avec un Closure.
indexOf Fonction de recherche de la position d'un élément dans une instance de Iterable avec un Predicate.
transformedIterable Retourne une instance de Iterable qui transforme les données de la collection encapsulée.

Permet d'effectuer une transformation à la volée des données.

org.apache.commons.collections4.ListUtils
select Fonction de sélection d'éléments, dans une nouvelle liste, depuis une liste source avec un Predicate. Permet d'extraire des éléments en fonction d'un critère et de s'assurer que le résultat est une liste contrairement à CollectionUtils qui retourne une collection.


Viewer icon.png Voir aussi

Site officiel : http://commons.apache.org/proper/commons-collections/