Project

General

Profile

Librairie comprenant un ensemble de classe utilitaires Java. JTheque Utils fait partie du projet JTheque Utilities.

1. Documentation

Voici la documentation de JTheque Utils

2. Collections et tableaux

2.1 ArrayUtils

La classe ArrayUtils fournit une série de méthodes utilitaires pour la manipulation des tableaux. Vous pouvez consulter la Javadoc.

Voici les méthodes que la classe fournit :
  • void reverse(Object[] array) : Permet d'inverser l'ordre des éléments du tableau
  • int indexOf(Object object, Object[] tab) : Retourne l'index de l'objet dans le tableau ou -1 s'il ne se trouve pas
  • boolean isEmpty(Object[] array) : Teste si le tableau est vide ou ne contient que des références null
  • T[] copyOf(T[] array) : Crée une copie du tableau et la retourne

2.2. CollectionUtils

La classe CollectionUtils fournit une série de méthodes utilitaires pour la manipulation des collections. Vous pouvez consulter la Javadoc.

Voici les méthodes que la classe fournit :
  • List<T> copyOf(Collection<T> list) : Crée une copie de la collection et la retourne.
  • List<T> emptyList() : Retourne une liste vide. Cette liste est partagée, cela permet de ne pas créér plusieurs instances de listes vides.
  • Collection<T> expand(Collection<S> collection, Expander<S,T> expander) : Etend la liste vers une liste d'autres éléments en utilisant un Expander qui permet de transformer un élément en un autre.
  • void filter(Collection<T> collection, Filter<T> filter) : Filtre la collection en utilisant un Filter.
  • T first(Iterable<T> collection) : Return the first element of the collection.
  • void forAllDo(Iterable<T> collection, Closure<T> closure) : Execute une action pour chaque élément de la collection.
  • void goToFirst(ListIterator<T> iterator) : Déplace l'itérateur jusqu'au premier élément de l'itérateur.
  • void goToLast(Iterator<T> iterator) : Déplace l'itérateur jusqu'au dernier élément de l'itérateur.
  • void reverse(List list) : Inverse l'ordre des éléments de la liste.
  • void reverse(Map<T,K> map) : Inverse l'ordre des éléments du dictionnaire.
  • void sort(List<T> list, Comparator<T> comparator) : Trie la liste en utilisant le Comparator.
  • Collection<T> toCollection(Enumeration<T> enumeration) : Transforme l'Enumeration en Collection.

3. Comptage

3.1. Counter

La classe Counter permet de manipuler un compteur entier.

Voici les méthodes fournies permettant de manipuler la valeur du compteur :
  • void add(int i) : Ajoute i au compteur
  • void clear() : Utilise 0 comme valeur de compteur
  • void decrement() : Soustrait 1 au compteur
  • void increment() : Ajoute 1 au compteur
  • int getValue() : Retourne la valeur du compteur

3.2. Counters

La classe Counters permet de manipuler un ensemble de Counter.

void addCounter(String name) : Ajoute un compteur avec le nom spécifié à la collection
Counter getCounter(String name) : Retourne le compteur avec le nom spécifié
Counter getCounterOrAdd(String name) : Retourne le compteur avec le nom spécifié. Si le compteur n'existe pas, on le crée.
Iterator<Map.Entry<String,Counter>> iterator() : Permet de parcourir tous les compteurs

La classe Counters est Iterable, on peut donc la parcourir avec une boucle foreach.

4. Généraux

4.1. StringUtils

La classe StringUtils permet de manipuler des chaînes de caractères.

  • boolean endsWithOneOf(String value, String... ends) : Teste si la chaîne de caractères se termine avec une des fins spécifiées.
  • boolean isEmpty(CharSequence string) : Teste si la châine de caractères est vide ou null.
  • boolean isEmpty(String[] strings) : Teste si le tableau de chaînes de caractères est vide ou ne contient que des chaînes vides.
  • boolean isNotEmpty(CharSequence string) : Teste si le chaîne de caractère n'est pas vide ou null
  • boolean isNotEmpty(String[] strings) : Teste si le tableau de chaînes de caractères n'est pas vide ou ne contient pas que des chaînes vides.
  • boolean isStringSurroundedWith(CharSequence str, char c) : Teste si la chaîne de caractères est entourée par le caractère spécifié
  • String removeHTMLEntities(String htmlString) : Supprimme toutes les entités HTML de le chaine
  • void removeLastSpace(StringBuilder builder) : Supprimme le dernier espace du StringBuilder.
  • String removeNumbers(CharSequence value) : Supprimme tous les nombres à l'intérieur de la chaîne.
  • String removeSurroundedChars(String str) : Supprimme les caractères entourant la chaîne.
  • String removeUnicode(String value) : Supprimme les caractères unicode de la chaîne et les remplace par leur valeur.
  • String setFirstLetterOnlyUpper(String word) : Met la première lettre de la châine en majuscules.
  • String setFirstLetterUpper(String word) : Met la première lettre de la chaîne en majuscules et toutes les autres en minuscules.

5. Objet de données (bean)

5.1. ReflectionUtils

Le classe ReflectionUtils fournit des méthodes utilitaires pour la réflection.

Voici les méthodes que la classe fournit :

  • String getGetter(String property) : Retourne le nom du getter associé à la propriété spécifiée
  • Method getGetterMethod(Object bean, String property) : Retourne le getter associé à la propriété spécifiée
  • PropertyDescriptor[] getProperties(Object bean) : Retourne toutes les propriétés de la classe
  • Object getProperty(Object bean, PropertyDescriptor property) : Retourne la valeur de la propriété.
  • Object getProperty(Object bean, String property) : Retourne la valeur de la propriété.
  • Object getPropertyValue(Object bean, String property) : Cette méthode n'utilise par le cache de propriété d'Introspector.

5.2 Duration

La classe Duration représente une durée.

Voici ce qu'il est possible de faire avec la classe Duration :

  • Duration(int minutes) : Crée une nouvelle durée en minutes
  • int getHours() : Retourne le nombre d'heures de la durée
  • int getMinutes() : Retourne le nombre de minutes de la durée
  • void setHours(int hours) : Modifie le nombre d'heures de la durée
  • void setMinutes(int minutes) : Modifie le nombre de minutes de la durée

Les méthodes equals(Object o), hashCode() et toString() sont implémentées.

6. Versions

Voici les différentes versions de JTheque Utils :