Tutoriel d'introduction et d'installation de Guava

Cet article est le premier d'une série consacrée à la bibliothèque Guava :

• introduction et installation ;
• collections ;
• programmation fonctionnelle ;
• utilitaires ;
• cache et concurrence ;
• tout pour vos Strings et primitifs ;
• un peu de math ;
• hash et I/O.

I-A. Versions des logiciels et bibliothèques utilisés▲

I-B. Mises à jour▲

La bibliothèque Guava a été créée chez Google pour répondre aux besoins fréquemment rencontrés par les équipes Java du géant, et ainsi avoir des réponses standardisées et performantes sur l'ensemble des projets.

Guava est issue d'un autre projet de Google, à savoir « Google-Collection », pour lequel j'avais déjà écrit un article nommé« Àla découverte du framework Google Collections » il y a quelque temps. Quand je remonte l'historique des versions, je retrouve des traces de la bibliothèque jusqu'à l'été 2007. Quant à Guava, qui en est à la version « 14.0 » au moment où j'écris ces lignes, sa version « 1.0 Final » date de la fin 2009, soit un an et demi plus tard.

Pour faire simple, le projet « Google-Collection » a été abandonné au profit de Guava et ses fonctionnalités ont été intégrées dans Guava.

Pour que l'ensemble de cet article soit cohérent et pour ne pas avoir à décrire des cas d'usage complexes à chaque exemple, j'ai utilisé des objets simples pour illustrer les fonctionnalités.

C'est là qu'intervient Milou le chien, un bean très simple qui ressemble au code Java suivant :

public class Chien {

    private Integer id;

    private String name;
    private String fullName;

    private SexeEnum sex;
    private Date birthday;

    private String race;
    private Boolean lof;

    private Double weight;
    private Double size;
    private List<String> colors;

    ...

Il y a plusieurs manières d'ajouter Guava à un projet, la plus simple étant de prendre directement le fichier JAR sur le site de la bibliothèque chez Google. Pour ma part, je préfère utiliser un outil comme Maven ou Gradle. Voici comment cela doit être fait.

Dans tous les cas, je vous invite à lire la documentation spécifique avec les conseils destinés à chaque solution sur le Wiki de Guava.

IV-A. Maven▲

...

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>14.0</version>
</dependency>

...

IV-B. Gradle▲

...

repositories {
  mavenCentral()
}

dependencies {
  compile group: 'com.google.guava', name: 'guava', version: '14.0'
}

...

IV-C. Ivy▲

...

<dependency org="com.google.guava" name="guava" rev="14.0" />

...

IV-D. Buildr▲

compile.with 'com.google.guava:guava:jar:14.0'

Pour le moment, nous n'avons vu que comment ajouter Guava à vos projets. N'hésitez pas à consulter les autres épisodes de cette série pour découvrir les fonctionnalités fantastiques de la bibliothèque.

Vos retours nous aident à améliorer nos publications. N'hésitez donc pas à commenter cet article sur le forum : Commentez

D'abord j'adresse mes remerciements à l'équipe Guava, chez Google, pour avoir développé une bibliothèque aussi utile et pour la maintenir. Je n'oublie pas tous les contributeurs qui participent notamment sur le forum Guava.

Plus spécifiquement en ce qui concerne cet article, je tiens à remercier l'équipe de Developpez.com et plus particulièrement Bernard Le Roux, Ricky81, Mickael Baron, Yann Caron, Logan, et Claude Leloup.

VII-A. Liens▲

VII-B. Liens personnels▲

VII-C. À propos▲