tree 7d889baa8a8a3e24c8e1d2a8d736e066d4360fde
parent 97c2271b505bec77f509e1f190695cc6a2997427
author sberlin <sberlin@d779f126-a31b-0410-b53b-1d3aecad763e> 1265926027 +0000
committer sberlin <sberlin@d779f126-a31b-0410-b53b-1d3aecad763e> 1265926027 +0000

fixes issue 342 - ability to disable JIT bindings (require explicit bindings).  this revision creates a new public facing API of:
 * Guice.createInjectorBuilder()
 * Injector.createChildInjectorBuilder()
 * com.google.inject.InjectorBuilder
      .stage(Stage)
      .requireExplicitBindings()
      .addModules(Iterable<? extends Module>)
      .addModules(Module... modules)
      .build()

There are three kinds of bindings Guice can handle: explicit, implicit, and JIT.  Explicit bindings are where there's a bind() call for that type.  Implicit bindings are where there's a bind(A).to(B) call (B is the implicit binding).  JIT bindings are where there's no binding, but the code requests an injection.

 The internals are changed so that if requireExplicitBindings() is called in the InjectorBuilder, then Guice will fail to create an Injector for any injection that is not an explicit binding.  Implicit bindings are allowed to be used in a Module, but unless the implicit binding was also explicitly bound then no class can directly inject the implicit binding.  Injector.get[Instance|Provider] will also fail for JIT or implicit bindings.  Injector.getBinding will succeed if for explicit & implicit bindings (but it won't create new JIT bindings), but Binding.getProvider will fail for implicit bindings.

In a nutshell, if you requireExplicitBindings() is called, then the Module must explicitly bind everything that's injected.  (@ProvidedBy & @ImplementedBy on types are still supported as shortcuts for implicit bindings.)

git-svn-id: https://google-guice.googlecode.com/svn/trunk@1141 d779f126-a31b-0410-b53b-1d3aecad763e