From 8240b434a5922173fb53e5946cabc54e55512798 Mon Sep 17 00:00:00 2001 From: Christian Edward Gruber Date: Thu, 20 Mar 2014 19:47:34 -0700 Subject: Added updated 4.0 api diffs. --- latest-api-diffs/4.0.xml | 15801 +++++++++++++++++++++++---------------------- 1 file changed, 7946 insertions(+), 7855 deletions(-) (limited to 'latest-api-diffs/4.0.xml') diff --git a/latest-api-diffs/4.0.xml b/latest-api-diffs/4.0.xml index a73941be..96564826 100644 --- a/latest-api-diffs/4.0.xml +++ b/latest-api-diffs/4.0.xml @@ -1,275 +1,275 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + - - - - - + org.aopalliance.intercept.MethodInterceptor[])]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - + @since 2.0]]> + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - + @since 4.0]]> + + + - @author crazybob@google.com (Bob Lee)]]> - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + are given.]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - - - - - - - - - - - - - + @param types for which static members will be injected]]> + + + + + + + + + + + + + + + + + - - - - - + message.]]> + + + + + - - - - - + catch the exception and pass it into this.]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - - + @since 4.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - + @since 2.0]]> + + + + - - - - + @since 2.0]]> + + + + - - - - + @since 3.0]]> + + + + @@ -660,14 +660,14 @@ does, the behavior is limited only to that child or any grandchildren. No siblings of the child will disable circular proxies. - @since 3.0]]> - - - - + @since 3.0]]> + + + + - - - - + @since 4.0]]> + + + + {@literal @}Named Foo when attempting to inject {@literal @}Named("foo") Foo. - @since 4.0]]> - - - + @since 4.0]]> + + + bindings) which will be used to create an {@link Injector}. Guice provides this object to your application's {@link Module} implementors so they may each contribute @@ -862,61 +862,61 @@ @author crazybob@google.com (Bob Lee) @author jessewilson@google.com (Jesse Wilson) - @author kevinb@google.com (Kevin Bourrillion)]]> - - - - - - - - - - - - - + @author kevinb@google.com (Kevin Bourrillion)]]> + + + + + + + + + + + + + - - - - - + method is only supported on {@link Binding}s returned from an injector.]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - + @since 2.0]]> + + + the bound type. The injected is always assignable to this type. @author crazybob@google.com (Bob Lee) - @author jessewilson@google.com (Jesse Wilson)]]> - - - - - - - + @author jessewilson@google.com (Jesse Wilson)]]> + + + + + + + - @author crazybob@google.com (Bob Lee)]]> - - - - - - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + + + + + + - - - - - + specified by the throwing method.]]> + + + + + - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + - - - - - - - - + @since 2.0]]> + + + + + + + + - - - - - + construction]]> + + + + + - - - - - - + creation]]> + + + + + + - - - - - - + creation.]]> + + + + + + - - - + construction]]> + + + ]]> - - - - - - - + ]]> + + + + + + + - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + Pre-constructed instances passed to {@link Injector#injectMembers}, {@link com.google.inject.binder.LinkedBindingBuilder#toInstance(Object)} and - {@link com.google.inject.binder.LinkedBindingBuilder#toProvider(Provider)}. + {@link com.google.inject.binder.LinkedBindingBuilder#toProvider(javax.inject.Provider)}. In this case all constructors are, of course, ignored.
  • Static fields and methods of classes which any {@link Module} has @@ -1207,20 +1207,20 @@ In all cases, a member can be injected regardless of its Java access specifier (private, default, protected, public). - @author crazybob@google.com (Bob Lee)]]> - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + - - - - - + run time]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - + @since 2.0]]> + + + + explicit bindings.

    The returned map does not include bindings inherited from a {@link #getParent() parent @@ -1277,14 +1277,14 @@ its {@link Map#entrySet()} iterator) in the order of insertion. In other words, the order in which bindings appear in user Modules. -

    This method is part of the Guice SPI and is intended for use by tools and extensions.]]> - - - - +

    This method is part of the Guice SPI and is intended for use by tools and extensions.]]> + + + + both explicit and just-in-time. The returned map is immutable; it contains only the bindings that were present when {@code getAllBindings()} was invoked. Subsequent calls may return a map with @@ -1295,30 +1295,30 @@

    This method is part of the Guice SPI and is intended for use by tools and extensions. - @since 3.0]]> - - - - - + @since 3.0]]> + + + + + This method is part of the Guice SPI and is intended for use by tools and extensions. - @throws ConfigurationException if this injector cannot find or create the binding.]]> - - - - - + @throws ConfigurationException if this injector cannot find or create the binding.]]> + + + + + This method is part of the Guice SPI and is intended for use by tools and extensions. @throws ConfigurationException if this injector cannot find or create the binding. - @since 2.0]]> - - - - - + @since 2.0]]> + + + + + This method is part of the Guice SPI and is intended for use by tools and extensions. - @since 3.0]]> - - - - - + @since 3.0]]> + + + + + This method is part of the Guice SPI and is intended for use by tools and extensions.]]> - - - - - +

    This method is part of the Guice SPI and is intended for use by tools and extensions.]]> + + + + + - - - - - + @see Binder#getProvider(Key) for an alternative that offers up front error detection]]> + + + + + - - - - - + @see Binder#getProvider(Class) for an alternative that offers up front error detection]]> + + + + + - - - - - + @throws ProvisionException if there was a runtime failure while providing an instance.]]> + + + + + - - - - + @throws ProvisionException if there was a runtime failure while providing an instance.]]> + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - + @since 2.0]]> + + + + This method is part of the Guice SPI and is intended for use by tools and extensions. - @since 3.0]]> - - - - + @since 3.0]]> + + + + This method is part of the Guice SPI and is intended for use by tools and extensions. - @since 3.0]]> - - - + @since 3.0]]> + + + - - - - - - - + @author jessewilson@google.com (Jesse Wilson)]]> + + + + + + + Clients create an empty anonymous subclass. Doing so embeds the type @@ -1540,13 +1540,13 @@

    Example usage for a binding of type {@code Foo} annotated with {@code @Bar}: -

    {@code new Key(Bar.class) {}}.]]> - - - - +

    {@code new Key(Bar.class) {}}.]]> + + + + Clients create an empty anonymous subclass. Doing so embeds the type @@ -1556,13 +1556,13 @@

    Example usage for a binding of type {@code Foo} annotated with {@code @Bar}: -

    {@code new Key(new Bar()) {}}.]]> - - - - +

    {@code new Key(new Bar()) {}}.]]> + + + + Clients create an empty anonymous subclass. Doing so embeds the type @@ -1571,194 +1571,194 @@

    Example usage for a binding of type {@code Foo}: -

    {@code new Key() {}}.]]> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +

    {@code new Key() {}}.]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + @since 3.0]]> + + + + + - - - - - + @since 3.0]]> + + + + + - - - - + @since 3.0]]> + + + + - - - - + @since 3.0]]> + + + + - - - + @since 3.0]]> + + + - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + - - - + @param instance to inject members on. May be {@code null}.]]> + + + - - - - - - - - + @since 2.0]]> + + + + + + + + Do not invoke this method directly to install submodules. Instead use {@link Binder#install(Module)}, which ensures that {@link Provides provider methods} are - discovered.]]> - - - + discovered.]]> + + + In addition to the bindings configured via {@link #configure}, bindings will be created for all methods annotated with {@literal @}{@link Provides}. Use scope and binding annotations on these methods to configure the - bindings.]]> - - - - - - - - - - - - + bindings.]]> + + + + + + + + + + + + - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + - - - - - + binding annotation.]]> + + + + + - - - - - - - - - + binding annotation.]]> + + + + + + + + + - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + - - - - - - - - - - - + expose()} to make the bindings in this module available externally.]]> + + + + + + + + + + + - - - - - + binding annotation.]]> + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + binding annotation.]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - + @since 2.0]]> + + + + + + + - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + - - - + and throwables to describe why provision failed.]]> + + + the type of object this provides - @author crazybob@google.com (Bob Lee)]]> - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - + @since 2.0]]> + + + + + + + + + - - - - + scope]]> + + + + - - - + {@code "ServletScopes.REQUEST"}.]]> + + + no scope, meaning it has no state from the framework's perspective -- the @@ -2418,16 +2418,16 @@

    An example of a scope is {@link Scopes#SINGLETON}. - @author crazybob@google.com (Bob Lee)]]> - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + - @author crazybob@google.com (Bob Lee)]]> - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + - - - - - - - + @since 3.0]]> + + + + + + + - - - - - + @param scopeAnnotation scope annotation class]]> + + + + + not cache circular proxies, because the proxies are not intended for general purpose use. (They are designed just to fulfill the immediate injection, not all injections. - Caching them can lead to IllegalArgumentExceptions or ClassCastExceptions.)]]> - - - - - - - - - + Caching them can lead to IllegalArgumentExceptions or ClassCastExceptions.)]]> + + + + + + + + + - - - + @since 2.0]]> + + + - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + Clients create an empty anonymous subclass. Doing so embeds the type parameter in the anonymous class's type hierarchy so we can reconstitute it - at runtime despite erasure.]]> - - - - + at runtime despite erasure.]]> + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + }, this returns {@code Iterable} given the input {@code Iterable.class}. @param supertype a superclass of, or interface implemented by, this. - @since 2.0]]> - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - - - + @since 2.0]]> + + + + + - - - + @since 2.0]]> + + + "} @author crazybob@google.com (Bob Lee) - @author jessewilson@google.com (Jesse Wilson)]]> - - - - - - - - - + @author jessewilson@google.com (Jesse Wilson)]]> + + + + + + + + + - - - - - - - + @author jessewilson@google.com (Jesse Wilson)]]> + + + + + + + When used in tandem with {@link FactoryModuleBuilder}, constructors annotated with {@code @AssistedInject} indicate that multiple constructors can be injected, each with different @@ -2763,294 +2763,294 @@ @Assisted, or they must be injectable. @author jmourits@google.com (Jerome Mourits) - @author jessewilson@google.com (Jesse Wilson)]]> - - - - - - - - - - - - - - - - + @author jessewilson@google.com (Jesse Wilson)]]> + + + + + + + + + + + + + + + + The fully qualified type of the factory. @since 3.0 - @author ramakrishna@google.com (Ramakrishna Rajanna)]]> - - - - - - - - - - - - - + @author ramakrishna@google.com (Ramakrishna Rajanna)]]> + + + + + + + + + + + + + If your {@link BindingTargetVisitor} implements this interface, bindings created by using {@link FactoryModuleBuilder} will be visited through this interface. @since 3.0 - @author ramakrishna@google.com (Ramakrishna Rajanna)]]> - - - - - - - - - - - - + @author ramakrishna@google.com (Ramakrishna Rajanna)]]> + + + + + + + + + + + + - - - - + used.]]> + + + + - - - - + implementation.]]> + + + + - - - + the implementation.]]> + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author ramakrishna@google.com (Ramakrishna Rajanna)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + @author schmitt@google.com (Peter Schmitt)]]> + + + + + + + + + + + + + + + + + + + + Obsolete. Prefer {@link FactoryModuleBuilder} for its more concise API and additional capability. @@ -3361,2160 +3361,2171 @@ @author jessewilson@google.com (Jesse Wilson) @author dtm@google.com (Daniel Martin) - @deprecated use {@link FactoryModuleBuilder} instead.]]> - - - - - - - - - - - - - - - - - - - - - + @deprecated use {@link FactoryModuleBuilder} instead.]]> + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + @see com.google.inject.Injector#injectMembers]]> + + + + + - - - - - - - - - - - - - - - - - - - - - - - + @see com.google.inject.Injector#injectMembers]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - + @since 3.0]]> + + + + + + - - - + @since 3.0]]> + + + - - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + + - - - + {@link com.google.inject.Binder}.]]> + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + - - - + @return aliases that should be applied on the graph]]> + + + - - - - - - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + - - - + @return copy of the edge with the new node IDs]]> + + + - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + - - - + their transitive dependencies.]]> + + + - - - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + - - - + @return copy of the node with a new ID]]> + + + - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + + + + + + } and an instance node with the same {@link Key} and value of 42. - @author bojand@google.com (Bojan Djordjevic)]]> - - - - - - - - - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - + @author bojand@google.com (Bojan Djordjevic)]]> + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - + or a {@link Method} when a provider method is used.]]> + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + See: http://www.graphviz.org/doc/info/arrows.html - @author phopkins@gmail.com (Pete Hopkins)]]> - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + See: http://www.graphviz.org/doc/info/attrs.html#k:portPos - @author phopkins@gmail.com (Pete Hopkins)]]> - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + See: http://www.graphviz.org/doc/info/attrs.html#k:style - @author phopkins@gmail.com (Pete Hopkins)]]> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - + {@link ImplementationNode}s) rows for each of the member fields.]]> + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + them.]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Specify the {@link PrintWriter} to output to with {@link #setOut(PrintWriter)}. - @author phopkins@gmail.com (Pete Hopkins)]]> - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + See: http://www.graphviz.org/doc/info/shapes.html - @author phopkins@gmail.com (Pete Hopkins)]]> - - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + + See: http://www.graphviz.org/doc/info/attrs.html#k:style - @author phopkins@gmail.com (Pete Hopkins)]]> - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + - - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + + - - - - - - - - - - - + @author phopkins@gmail.com (Pete Hopkins)]]> + + + + + + + + + + + bind(DataSource.class).toProvider(fromJndi(DataSource.class, "java:...")); - ]]> - - - + ]]> + + + - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + - - - - - + given matcher return {@code true}.]]> + + + + + - - - + given matcher return {@code true}.]]> + + + - - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + + - - - - - + with a given annotation.]]> + + + + + - - - - - + with a given annotation.]]> + + + + + - - - - - - - - - - - - - - - - - + the given type).]]> + + + + + + + + + + + + + + + + + - - - - - + classloader, so classes with the same package name may not have the same package at runtime.]]> + + + + + - - - - - - - - - + @since 2.0]]> + + + + + + + + + - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + - - - - - - - + {@link Map} that is itself bound with no binding annotation.]]> + + + + + + + - - - - - - - - + {@link Map} that is itself bound with no binding annotation.]]> + + + + + + + + - - - - - - - - + {@link Map} that is itself bound with {@code annotation}.]]> + + + + + + + + - - - - - - - - + {@link Map} that is itself bound with {@code annotation}.]]> + + + + + + + + - - - - - - - - + {@link Map} that is itself bound with {@code annotationType}.]]> + + + + + + + + - - - - + {@link Map} that is itself bound with {@code annotationType}.]]> + + + + When multiple equal keys are bound, the value that gets included in the map is arbitrary. @@ -5527,15 +5538,15 @@ option impacts all of them. @return this map binder - @since 3.0]]> - - - - - + @since 3.0]]> + + + + + Scoping elements independently is supported. Use the {@code in} method - to specify a binding scope.]]> - - - + to specify a binding scope.]]> + + + @@ -5611,51 +5622,51 @@ value is null, map injection will fail (although injecting a map of providers will not). - @author dpb@google.com (David P. Baker)]]> - - - - - - - - - - - - + @author dpb@google.com (David P. Baker)]]> + + + + + + + + + + + + The TypeLiteral will always match the type Map's generic type. For example, if getMapKey returns a key of Map<String, Snack>, then this will always return a - TypeLiteral<String>.]]> - - - - + TypeLiteral<String>.]]> + + + + The TypeLiteral will always match the type Map's generic type. For example, if getMapKey returns a key of Map<String, Snack>, then this will always return a - TypeLiteral<Snack>.]]> - - - - + TypeLiteral<Snack>.]]> + + + + The elements will always match the type Map's generic type. For example, if getMapKey returns a key of Map<String, Snack>, then this will always return a list of type - List<Map.Entry<String, Binding<Snack>>>.]]> - - - - + List<Map.Entry<String, Binding<Snack>>>.]]> + + + + - - - - - + MapBinderBinding retrieved from {@link Elements#getElements}.]]> + + + + + If you need to introspect the details of the map, such as the keys, values or if it permits duplicates, it is necessary to pass the elements through an Injector and use - {@link #getEntries()} and {@link #permitsDuplicates()}.]]> - - - + {@link #getEntries()} and {@link #permitsDuplicates()}.]]> + + + Although MapBinders may be injected through a variety of generic types (Map<K, V>, Map @@ -5708,103 +5719,103 @@ MapBinderBinding<Map<String, Snack>> @since 3.0 - @author sameb@google.com (Sam Berlin)]]> - - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + - - - - - - + itself bound with no binding annotation.]]> + + + + + + - - - - - - - + itself bound with no binding annotation.]]> + + + + + + + - - - - - - - + itself bound with {@code annotation}.]]> + + + + + + + - - - - - - - + itself bound with {@code annotation}.]]> + + + + + + + - - - - - - - + itself bound with {@code annotationType}.]]> + + + + + + + - - - - + itself bound with {@code annotationType}.]]> + + + + - - - - + @since 3.0]]> + + + + Scoping elements independently is supported. Use the {@code in} method - to specify a binding scope.]]> - - - + to specify a binding scope.]]> + + + }, and to each contribute bindings to the set of snacks. When that set is injected, it will contain elements from both modules. - +

    The set's iteration order is consistent with the binding order. This is convenient when multiple elements are contributed by the same module because that module can order its bindings appropriately. Avoid relying on the iteration order of elements contributed by different modules, since there is no equivalent mechanism to order modules. - +

    The set is unmodifiable. Elements can only be added to the set by configuring the multibinder. Elements can never be removed from the set. @@ -5867,64 +5878,64 @@

    Elements must be non-null. If any set element is null, set injection will fail. - @author jessewilson@google.com (Jesse Wilson)]]> - - - - - - - - - - - - + @author jessewilson@google.com (Jesse Wilson)]]> + + + + + + + + + + + + The elements will always match the type Set's generic type. For example, if getSetKey returns a key of Set<String>, then this will always return a - TypeLiteral<String>.]]> - - - - + TypeLiteral<String>.]]> + + + + The elements will always match the type Set's generic type. For example, if getSetKey returns a key of Set<String>, then this will always return a list of type - List<Binding<String>>.]]> - - - - + List<Binding<String>>.]]> + + + + - - - - - + MultibinderBinding retrieved from {@link Elements#getElements}.]]> + + + + + If you need to introspect the details of the set, such as the values or if it permits duplicates, it is necessary to pass the elements through an Injector and use - {@link #getElements()} and {@link #permitsDuplicates()}.]]> - - - + {@link #getElements()} and {@link #permitsDuplicates()}.]]> + + + The fully qualified type of the set, including Set. For example: MultibinderBinding<Set<Boolean>> @since 3.0 - @author sameb@google.com (Sam Berlin)]]> - - - - - - - - - - - - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + + + + + + + + + + + If your {@link BindingTargetVisitor} implements this interface, bindings created by using {@link Multibinder} or {@link MapBinder} will be visited through this interface. @since 3.0 - @author sameb@google.com (Sam Berlin)]]> - - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + - - - - - - + {@code properties}.]]> + + + + + + - - - + {@link Properties#defaults defaults}.]]> + + + - - - - - - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + + + + + + This filter requires the Guice Servlet extension. - @author Dhanji R. Prasanna (dhanji@gmail.com)]]> - - - - - - - - - - - - - - + @author Dhanji R. Prasanna (dhanji@gmail.com)]]> + + + + + + + + + + + + + + - - - - - - - + @author dhanji@gmail.com (Dhanji R. Prasanna)]]> + + + + + + + - - - - + nothing.]]> + + + + - - - + method does nothing. If not yet started, it also does nothing.]]> + + + - - - - - - - + @author dhanji@gmail.com (Dhanji R. Prasanna)]]> + + + + + + + Any method or class marked with this annotation will be considered for transactionality. Consult the documentation on http://code.google.com/p/google-guice for detailed semantics. Marking a method {@code @Transactional} will start a new transaction before the method @@ -6197,39 +6208,39 @@ the {@link #rollbackOn()} clause. By default, only unchecked exceptions trigger a rollback. - @author Dhanji R. Prasanna (dhanji@gmail.com)]]> - - - - - - - + @author Dhanji R. Prasanna (dhanji@gmail.com)]]> + + + + + + + - - - - + Transaction semantics are not affected.]]> + + + + - Transaction semantics are not affected.]]> - - - + Transaction semantics are not affected.]]> + + + - @author Dhanji R. Prasanna (dhanji@gmail com)]]> - - - - - - - - - - - - + @author Dhanji R. Prasanna (dhanji@gmail com)]]> + + + + + + + + + + + + - - - - - + @param method a method you want to test as a dynamic finder]]> + + + + + - - - - - - - + @author dhanji@gmail.com (Dhanji R. Prasanna)]]> + + + + + + + - - - - - - - + @author Dhanji R. Prasanna (dhanji@gmail.com)]]> + + + + + + + - - - - - - - + @author Dhanji R. Prasanna (dhanji@gmail.com)]]> + + + + + + + - - - - - - - - - - - - - - - - + @author Dhanji R. Prasanna (dhanji@gmail.com)]]> + + + + + + + + + + + + + + + + - - - - - + provider as per the specification.]]> + + + + + - - - + @param iface Any interface type whose methods are all dynamic finders.]]> + + + - - - - - - - - - - - - - - - - - - - - - - - + @author dhanji@gmail.com (Dhanji R. Prasanna)]]> + + + + + + + + + + + + + + + + + + + + + + + Apply this filter in web.xml above all other filters (typically), to all requests where you plan to use servlet scopes. This is also needed in order to dispatch requests to injectable filters @@ -6431,207 +6442,207 @@ any other filters (and servlets) using a {@link ServletModule}. @author crazybob@google.com (Bob Lee) - @author dhanji@gmail.com (Dhanji R. Prasanna)]]> - - - - - - - - - - - - - - - + @author dhanji@gmail.com (Dhanji R. Prasanna)]]> + + + + + + + + + + + + + + + - - - + injector.]]> + + + - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + - - - - - - - + @since 3.0]]> + + + + + + + } when you want the HTTP request parameter map to be injected. - @author crazybob@google.com (Bob Lee)]]> - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + - - - - - - - + @author Chris Nokleberg]]> + + + + + + + - - - - - - - - - - - + @author iqshum@google.com (Isaac Shum)]]> + + + + + + + + + + + Servlet Mapping EDSL

    Part of the EDSL builder language for configuring servlets @@ -6796,65 +6807,65 @@ In the case shown above {@code WebServiceFilter} will run first. - @since 2.0]]> - - - - - - + @since 2.0]]> + + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - - - + @since 2.0]]> + + + + + + - - - - + @since 2.0]]> + + + + - - - + @since 3.0]]> + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author dhanji@gmail.com (Dhanji R. Prasanna)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - + @since 3.0]]> + + + + + + + + + - - - - - + If multiple patterns were specified, this will be called multiple times.]]> + + + + + - - - - - + If multiple patterns were specified, this will be called multiple times.]]> + + + + + - - - - - + If multiple patterns were specified, this will be called multiple times.]]> + + + + + - - - + If multiple patterns were specified, this will be called multiple times.]]> + + + - - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + - - - - - + @since 3.0]]> + + + + + - - - - - + thread, or if the request has completed.]]> + + + + + - - - - - - + also return true if the target binding is request-scoped.]]> + + + + + + - - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + + - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + - - - - - - - - - + @since 3.0]]> + + + + + + + + + - - - - - - - - - - - + injector bindings.]]> + + + + + + + + + + + - - - - + Scope) Binder.bindScope()}.]]> + + + + - - - + is linked to a scoped binding.]]> + + + any type to be returned by the visit method. Use {@link Void} with {@code return null} if no return type is needed. - @since 2.0]]> - - - - - - - - + @since 2.0]]> + + + + + + + + - - - - - + found in both module and injector bindings.]]> + + + + + - - - - - + injections. This target is found in both module and injector bindings.]]> + + + + + - - - - - + bindings.]]> + + + + + - - - - - + target is found in both module and injector bindings.]]> + + + + + - - - - - + found in injector bindings.]]> + + + + + - - - - - + that the injector should use its implicit binding strategies to resolve injections.]]> + + + + + - - - - - + {@code constructor}. This target is found only on injector bindings.]]> + + + + + - - - - - + bindings.]]> + + + + + - - - + provided type. This target is found only on injector bindings.]]> + + + any type to be returned by the visit method. Use {@link Void} with {@code return null} if no return type is needed. - @since 2.0]]> - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + - - - - + before subtype fields. Similarly, supertype methods are returned before subtype methods.]]> + + + + - - - + @return a possibly empty map]]> + + + - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + - - - - + @since 3.0]]> + + + + - - - - - - - - + {@link com.google.inject.Injector#getBinding(Key) Injector.getBinding(key)}.]]> + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - + @since 2.0]]> + + + + + + + + - - - - - - - - - - - - - - - - - - - - + nullable.]]> + + + + + + + + + + + + + + + + + + + + - - - - + attached to a particular injection point.]]> + + + + - - - - - - - - - - + are elements in a parameter list.]]> + + + + + + + + + + Use {@link #get} to build a freestanding dependency, or {@link InjectionPoint} to build one @@ -7865,128 +7876,128 @@ @author crazybob@google.com (Bob Lee) @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - - - + @since 2.0]]> + + + + + + + + + - - - - + LinkedBindingBuilder#toProvider(Provider).]]> + + + + - - - - - + class in question.]]> + + + + + - - - - - - - - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + + + + + + + - - - - - - - + @since 3.0]]> + + + + + + + Tools might specially handle types they know about; {@code StackTraceElement} is a good example. Tools should simply call {@code toString()} on the source object if the type is - unfamiliar.]]> - - - - - + unfamiliar.]]> + + + + + - - - - - + @param visitor to call back on]]> + + + + + - - - + element.]]> + + + The elements of a module can be inspected, validated and rewritten. Use {@link @@ -7999,115 +8010,115 @@ @author jessewilson@google.com (Jesse Wilson) @author crazybob@google.com (Bob Lee) - @since 2.0]]> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - + @since 2.0]]> + + + + + + + - - - - + not created or copied from another element, returns {@code null}.]]> + + + + - - - - + declaring source of element would be the method itself.]]> + + + + - - - - + is the class name of root module.]]> + + + + In the cases where stack trace is not available (i.e., the stack trace was not collected), - it returns -1 for all module positions.]]> - - - - + it returns -1 for all module positions.]]> + + + + - - - - - - - - + empty array.]]> + + + + + + + + The {@link #getDeclaringSource() declaring source} refers to a location in source code that @@ -8170,399 +8181,399 @@

    In order to support the cases where a Guice {@link Element element} is created from another Guice {@link Element element} (original) (e.g., by {@link Element#applyTo()}), it also - provides a reference to the original element source ({@link #getOriginalElementSource()}).]]> - - - - - - - - + provides a reference to the original element source ({@link #getOriginalElementSource()}).]]> + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + instances of the type.]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - + private binder}.]]> + + + + + + + + + + + + + + + + + - - - - - + @since 3.0]]> + + + + + - - - - - + @since 3.0]]> + + + + + - - - - - + @since 4.0]]> + + + + + - - - + @since 4.0]]> + + + any type to be returned by the visit method. Use {@link Void} with {@code return null} if no return type is needed. - @since 2.0]]> - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + - - - - - - - + @since 2.0]]> + + + + + + + - - - + @return a possibly empty set]]> + + + - - - - - - - - + @since 2.0]]> + + + + + + + + - - - + @param injectee instance that Guice injected dependencies into]]> + + + - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + - - - - + @return a possibly-empty list]]> + + + + - - - - + constructors etc.) may be used to satisfy optional injection points.]]> + + + + - - - - + @since 3.0]]> + + + + - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + }), prefer the overload that includes a type literal. @param constructor any single constructor present on {@code type}. - @since 3.0]]> - - - - - - + @since 3.0]]> + + + + + + - - - - - + @since 3.0]]> + + + + + - - - - - + parameter with multiple binding annotations.]]> + + + + + - - - - - + parameter with multiple binding annotations.]]> + + + + + } - of the valid injection points.]]> - - - - - + of the valid injection points.]]> + + + + + } - of the valid injection points.]]> - - - - - + of the valid injection points.]]> + + + + + } - of the valid injection points.]]> - - - - - + of the valid injection points.]]> + + + + + } - of the valid injection points.]]> - - - + of the valid injection points.]]> + + + - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + } - of the valid injection points.]]> - - - - - - - - - + of the valid injection points.]]> + + + + + + + + + @author mikeward@google.com (Mike Ward) - @since 2.0]]> - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + - - - + @return a possibly empty set]]> + + + - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + - - - - - - - - + @since 2.0]]> + + + + + + + + - - - + injector using {@link com.google.inject.Injector#getBinding(Key) Injector.getBinding(key)}.]]> + + + - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + - - - - - - - + @throws IllegalStateException if the delegate is already set]]> + + + + + + + - - - - + an injector.]]> + + + + - - - + throw an {@code IllegalStateException} if you try to use it beforehand.]]> + + + @@ -8886,99 +8897,106 @@ = getMembersInjector(PaymentService.class); @author crazybob@google.com (Bob Lee) - @since 2.0]]> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + - @author crazybob@google.com (Bob Lee)]]> - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + - - - - - - - - - - + been used to create an injector.]]> + + + + + + + + + + - - - + @param key one of the keys exposed by this module.]]> + + + - - - - - - - - + @since 2.0]]> + + + + + + + + - - - + Injector.getBinding(providedKey)}]]> + + + } is injected (as opposed to injecting {@code T} directly). @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + - - - + @return a possibly empty set]]> + + + - - - - - - - - + @since 2.0]]> + + + + + + + + - - - + Injector.getBinding(providerKey)}]]> + + + - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + - - - - - - - + @throws IllegalStateException if the delegate is already set]]> + + + + + + + - - - - + will be initialized when this element is processed, or otherwise used to create an injector.]]> + + + + - - - + IllegalStateException} if you try to use it beforehand.]]> + + + @@ -9200,36 +9229,36 @@ = getProvider(PaymentService.class); @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - - + @since 2.0]]> + + + + + + + + - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + MUST @@ -9237,10 +9266,10 @@

    Due to issues with generics, the type parameters of this method do not relate to the type of the provider. In practice, the 'B' type will always - be a supertype of 'T'.]]> - - - + be a supertype of 'T'.]]> + + + @@ -9263,20 +9292,82 @@ BindingTargetVisitor. @since 3.0 - @author sameb@google.com (Sam Berlin)]]> - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + If your {@link BindingTargetVisitor} implements this interface, bindings created by using + {@code @Provides} will be visited through this interface. + + @since 4.0 + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + To perform the provision, call {@link ProvisionInvocation#provision()}. If you do not explicitly call provision, it will be automatically done after - this method returns. It is an error to call provision more than once.]]> - - - + this method returns. It is an error to call provision more than once.]]> + + + - - - - - - - - - + @since 4.0]]> + + + + + + + + + You must not call {@link Provider#get()} on the provider returned by - {@link Binding#getProvider}, otherwise you will get confusing error messages.]]> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + {@link Binding#getProvider}, otherwise you will get confusing error messages.]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + @since 4.0]]> + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + @since 4.0]]> + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - + @since 4.0]]> + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + + + + + + + + @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + } - of the valid injection points.]]> - - - - - - - - - + of the valid injection points.]]> + + + + + + + + + @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - + @since 2.0]]> + + + + + + + - - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - - - + @since 2.0]]> + + + + + + + + + - - - - - + into the message.]]> + + + + + - - - - - - - - - - - + something that you worry may fail, you should catch the exception and pass it to this method.]]> + + + + + + + + + + + - - - - - + {@code IllegalStateException} if you try to use it beforehand.]]> + + + + + - - - - - + {@code IllegalStateException} if you try to use it beforehand.]]> + + + + + - - - - - + @param typeLiteral type to get members injector for]]> + + + + + - - - - - + @param type type to get members injector for]]> + + + + + - - - - - + performed its own injections on an instance of {@code I}.]]> + + + + + - - - - - - + injections have been performed on an instance of {@code I}.]]> + + + + + + - - - + @param interceptors to bind]]> + + + the injectable type encountered - @since 2.0]]> - - - - - - - - - + @since 2.0]]> + + + + + + + + + the injectable type]]> - - - + @param the injectable type]]> + + + - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + >() {}), listener); @author jessewilson@google.com (Jesse Wilson) - @since 2.0]]> - - - - - - - + @since 2.0]]> + + + + + + + - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + bind(DataSource.class) .toProvider(fromSpring(DataSource.class, "dataSource")); - ]]> - - - - - - + ]]> + + + + + + - - - + @see com.google.inject.name.Names#named(String)]]> + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - + @author benmccann.com]]> + + + + + + + + + + - - - - - - - - - - - + @author benmccann.com]]> + + + + + + + + + + + - - - - - - - + @since 3.0]]> + + + + + + + - - - - - - - + @since 3.0]]> + + + + + + + ThrowingProviderBinder.create(binder()) .bind(RemoteProvider.class, Customer.class) @@ -10147,22 +10238,22 @@ where CustomerImpl has a constructor annotated with ThrowingInject. - @author sameb@google.com (Sam Berlin)]]> - - - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + + - - - - - - - - - - - + @deprecated use {@link CheckedProvider} instead.]]> + + + + + + + + + + + - - - - - - - - - - - - - - - - - - + @since 3.0]]> + + + + + + + + + + + + + + + + + + Builds a binding for a {@link CheckedProvider}.

    You can use a fluent API and custom providers: @@ -10260,162 +10351,162 @@ @author jmourits@google.com (Jerome Mourits) @author jessewilson@google.com (Jesse Wilson) - @author sameb@google.com (Sam Berlin)]]> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @author sameb@google.com (Sam Berlin)]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + + - - - - - - - + Consider using the name of your root {@link Module} class as the domain.]]> + + + + + + + - - - - - - - - - - + Consider using the name of your root {@link Module} class as the domain.]]> + + + + + + + + + + - - - - - - - - - - + @author crazybob@google.com (Bob Lee)]]> + + + + + + + + + + Prefer to write smaller modules that can be reused and tested without overrides. - @param modules the modules whose bindings are open to be overridden]]> - - - - - + @param modules the modules whose bindings are open to be overridden]]> + + + + + Prefer to write smaller modules that can be reused and tested without overrides. - @param modules the modules whose bindings are open to be overridden]]> - - - - - - - - - - - - - - - - - + @param modules the modules whose bindings are open to be overridden]]> + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - - - - - - - - - - - - + @since 2.0]]> + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - + life a Guice-supplied Provider will never return null.]]> + + + + + - - - + @since 3.0]]> + + + - - - - - - - - - + @since 2.0]]> + + + + + + + + + - - - - - - - + @return a {@link java.io.Serializable serializable} parameterized type.]]> + + + + + + + - - - - - + @return a {@link java.io.Serializable serializable} parameterized type.]]> + + + + + - - - - - + @return a {@link java.io.Serializable serializable} generic array type.]]> + + + + + - - - - - + this returns {@code ?}, which is shorthand for {@code ? extends Object}.]]> + + + + + - - - - - + super String}.]]> + + + + + - - - - - + @return a {@link java.io.Serializable serializable} parameterized type.]]> + + + + + - - - - - - + @return a {@link java.io.Serializable serializable} parameterized type.]]> + + + + + + - - - - - + @return a {@link java.io.Serializable serializable} parameterized type.]]> + + + + + - - - + @return a {@link java.io.Serializable serializable} parameterized type.]]> + + + - - - - - - + @since 2.0]]> + + + + + + -- cgit v1.2.3