Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / guice / 6c56943a3c554b86b83cb82ec787e43b4c1892d8
commit6c56943a3c554b86b83cb82ec787e43b4c1892d8[log] [tgz]
authorXin Li <delphij@google.com>Sat Feb 20 12:06:13 2021 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Sat Feb 20 12:06:13 2021 +0000
tree8615c70e58321176ed9a352581f81eef2e900df7
parentaf1429b654fc6bff4497185c78d237ba83f35019 [diff]
parentc00ff406b49c3a482547314cd19f8f1940807f38 [diff]
[automerger skipped] Mark ab/7061308 as merged in stage. am: 8a4c87a309 -s ours am: c00ff406b4 -s ours

am skip reason: Change-Id Ie73488f7da50d4301d4718f57891b6fc3590d28c with SHA-1 b8d30fba19 is in history

Original change: undetermined

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: If96421533e59798a8d1af9fce984b53732365b22
tree: 8615c70e58321176ed9a352581f81eef2e900df7
  1. bom/
  2. core/
  3. examples/
  4. extensions/
  5. jdk8-tests/
  6. latest-api-diffs/
  7. lib/
  8. util/
  9. .gitattributes
  10. .gitignore
  11. .travis.yml
  12. Android.bp
  13. build.properties
  14. build.xml
  15. CleanSpec.mk
  16. common.xml
  17. CONTRIBUTING.md
  18. COPYING
  19. METADATA
  20. MODULE_LICENSE_APACHE2
  21. NOTICE
  22. OWNERS
  23. pom.xml
  24. README.md
README.md

Guice

Latest release: 4.1

Documentation: User Guide, 4.1 javadocs, Latest javadocs
Continuous Integration: Build Status
Mailing Lists: User Mailing List
License: Apache 2.0

Put simply, Guice alleviates the need for factories and the use of new in your Java code. Think of Guice's @Inject as the new new. You will still need to write factories in some cases, but your code will not depend directly on them. Your code will be easier to change, unit test and reuse in other contexts.

Guice embraces Java's type safe nature, especially when it comes to features introduced in Java 5 such as generics and annotations. You might think of Guice as filling in missing features for core Java. Ideally, the language itself would provide most of the same features, but until such a language comes along, we have Guice.

Guice helps you design better APIs, and the Guice API itself sets a good example. Guice is not a kitchen sink. We justify each feature with at least three use cases. When in doubt, we leave it out. We build general functionality which enables you to extend Guice rather than adding every feature to the core framework.

Guice aims to make development and debugging easier and faster, not harder and slower. In that vein, Guice steers clear of surprises and magic. You should be able to understand code with or without tools, though tools can make things even easier. When errors do occur, Guice goes the extra mile to generate helpful messages.

For an introduction to Guice and a comparison to new and the factory pattern, see Bob Lee's video presentation. After that, check out our user's guide.

We've been running Guice in mission critical applications since 2006, and now you can, too. We hope you enjoy it as much as we do.

jolt award