guava

Guava est un ensemble de bibliothèques Java essentielles développé par Google. Il propose de nouveaux types de collections tels que Multimap et Multiset, des collections immuables, une bibliothèque de graphes, ainsi que des utilitaires pour la concurrence, l'entrée/sortie, le hachage, les types primitifs, les chaînes et bien plus encore. Selon le fichier README, Guava est largement utilisé dans la plupart des projets Java de Google, ainsi que par de nombreuses autres entreprises. Guava est disponible en deux variantes. La version JRE requiert le JDK 1.8 ou une version ultérieure. Pour le support Android, une variante Android est disponible, avec le code source situé dans le répertoire android du dépôt. Pour intégrer Guava dans un projet, l'identifiant de groupe Maven est com.google.guava et l'identifiant d'artefact est guava. Les deux variantes sont spécifiées dans le champ de version Maven sous forme de 33.7.1-jre ou 33.7.1-android. Le README fournit des extraits de dépendance pour Maven et Gradle, y compris des conseils sur l'utilisation de api versus implementation dans Gradle. Les snapshots construits à partir de la branche master sont accessibles via Maven avec la version 999.0.0-HEAD-jre-SNAPSHOT, ou 999.0.0-HEAD-android-SNAPSHOT pour la variante Android. Les javadoc et les diffs d'API des snapshots sont également disponibles. La javadoc peut être consultée à l'adresse guava.dev/api, et une classe spécifique peut être ouverte en ajoutant son nom à guava.dev. Les ressources d'apprentissage incluent le guide utilisateur, Guava Explained, ainsi qu'une collection d'autres liens utiles. Le projet renvoie vers son dépôt GitHub, son suivi d'incidents, sa balise StackOverflow et les groupes Google guava-announce et guava-discuss. Le README liste des avertissements importants. Les APIs marquées avec l'annotation @Beta au niveau de la classe ou de la méthode sont sujettes à changement et peuvent être modifiées ou supprimées à tout moment ; il est conseillé aux auteurs de bibliothèques de ne pas utiliser les APIs beta sauf s'ils les repackagent, et l'utilisation d'un Guava Beta Checker est recommandée. Les APIs sans annotation @Beta resteront compatibles binaire indéfiniment, et même les APIs @Deprecated seront maintenues à moins qu'elles ne soient @Beta. Guava a une dépendance nécessaire pour la liaison à l'exécution, com.google.guava:failureaccess:1.0.3, ainsi que quelques dépendances purement annotations. Les formes sérialisées de tous les objets peuvent évoluer, sauf indication contraire ; elles ne doivent donc pas être persistées avec l'hypothèse qu'une version future pourra les lire. Ces classes ne sont pas conçues pour se protéger contre un appelant malveillant et ne doivent pas être utilisées pour des communications entre code de confiance et code non fiable. Pour la version principale, les bibliothèques sont testées avec plusieurs versions d'OpenJDK sous Linux et Windows, et certaines fonctionnalités, en particulier dans com.google.common.io, peuvent ne pas fonctionner correctement dans des environnements non-Linux. Pour la variante Android, les tests unitaires s'exécutent également sur le niveau d'API 24 (Nougat).