Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
The Guava project contains several of Google's core libraries that we rely on in our Java-based projects: collections, caching, primitives support, concurrency libraries, common annotations, string processing, I/O, and so forth. Each of these tools really do get used every day by Googlers, in production services.
But trawling through Javadoc isn't always the most effective way to learn how to make best use of a library. Here, we try to provide readable and pleasant explanations of some of the most popular and most powerful features of Guava.
This wiki is a work in progress, and parts of it may still be under construction.
- Basic utilities: Make using the Java language more pleasant.
Using and avoiding null:
nullcan be ambiguous, can cause confusing errors, and is sometimes just plain unpleasant. Many Guava utilities reject and fail fast on nulls, rather than accepting them blindly.
- Preconditions: Test preconditions for your methods more easily.
Common object methods: Simplify implementing
Ordering: Guava's powerful "fluent
- Throwables: Simplify propagating and examining exceptions and errors.
- Using and avoiding null:
- Collections: Guava's extensions to the JDK collections ecosystem. These are some of the most mature and popular parts of Guava.
- Immutable collections, for defensive programming, constant collections, and improved efficiency.
- New collection types, for use cases that the JDK collections don't address as well as they could: multisets, multimaps, tables, bidirectional maps, and more.
Powerful collection utilities, for common operations not provided in
Extension utilities: writing a
Iterator? We can make that easier.
Graphs: a library for modeling
data, that is, entities and the relationships between them. Key features include:
- Graph: a graph whose edges are anonymous entities with no identity or information of their own.
- ValueGraph: a graph whose edges have associated non-unique values.
- Network: a graph whose edges are unique objects.
- Support for graphs that are mutable and immutable, directed and undirected, and several other properties.
- Caches: Local caching, done right, and supporting a wide variety of expiration behaviors.
- Functional idioms: Used sparingly, Guava's functional idioms can significantly simplify code.
- Concurrency: Powerful, simple abstractions to make it easier to write correct concurrent code.
- Strings: A few extremely useful string utilities: splitting, joining, padding, and more.
Primitives: operations on primitive types, like
char, not provided by the JDK, including unsigned variants for some types.
Ranges: Guava's powerful API for dealing with ranges on
Comparabletypes, both continuous and discrete.
- I/O: Simplified I/O operations, especially on whole I/O streams and files, for Java 5 and 6.
Hashing: Tools for more sophisticated hashes than what's provided by
Object.hashCode(), including Bloom filters.
- EventBus: Publish-subscribe-style communication between components without requiring the components to explicitly register with one another.
- Math: Optimized, thoroughly tested math utilities not provided by the JDK.
- Reflection: Guava utilities for Java's reflective capabilities.
- Tips: Getting your application working the way you want it to with Guava.
- Philosophy: what Guava is and isn't, and our goals.
- Using Guava in your build, with build systems including Maven, Gradle, and more.
- Using ProGuard to avoid bundling parts of Guava you don't use with your JAR.
- Apache Commons equivalents, helping you translate code from using Apache Commons Collections.
- Compatibility, details between Guava versions.
- Idea Graveyard, feature requests that have been conclusively rejected.
- Friends, open-source projects we like and admire.
- HowToContribute, how to contribute to Guava.
NOTE: To discuss the contents of this wiki, please just use the guava-discuss mailing list.