Support rewriting bindings (change annotations, scopes)

_From [sberlin](https://code.google.com/u/sberlin/) on January 17, 2010 12:37:12_

See thread http://groups.google.com/group/google-guice/browse_thread/thread/6045a424b1873f62?hl=en for background.

The premise behind this patch is to give people a way to programatically
alter bindings in a module.  An example of needing to do this could be if
you have a Module supplied from a 3rd party vendor, or legacy code, and it
uses an out-of-date scope that you would like to upgrade to a newer scope,
or it expects a certain annotation that your code doesn't use.

The patch exposes a new 'rewrite' method in Modules that allows the user to
chain combinations of Matcher<? super Binding<?>> and either a Scope or
Annotation.  If the matcher returns true, the rewritten module will update
the binding in question to use the new scope or annotation.

Example:

Module newModule = Modules.rewrite(Modules.replace(new LegacyModule())
  .withAnnotation(new DeprecatedAnnotationMatcher(), NewAnnotation.class)
  .build());

Or to upgrade no-scope bindings to a Singleton (as the thread on the
mailing list asked for) --

Module newModule = Modules.rewrite(Modules.replace(new MyModule())
  .withScope(new NoScopeMatcher(), Scopes.SINGLETON)
  .build());

where NoScopeMatcher is something as simple as:
   private static class NoScopeMatcher extends AbstractMatcher<Binding<?>>
implements BindingScopingVisitor<Boolean> {
    public Boolean visitEagerSingleton() { return false; };
    public Boolean visitNoScoping() { return true; };
    public Boolean visitScope(Scope scope) { return scope == null; };
    public Boolean visitScopeAnnotation(java.lang.Class<? extends
java.lang.annotation.Annotation> scopeAnnotation) { return false; };
    public boolean matches(Binding<?> t) {
      return t.acceptScopingVisitor(this);
    }
  }

This needs to be applied to core guice (and not be an extension) because of
the BindingRewriter class that must be in the internal package, as it uses
package-private methods to upgrade the bindings.

New tests are in the ModulesTest class.

_Original issue: http://code.google.com/p/google-guice/issues/detail?id=460_