com.google.inject.throwingproviders

Class ThrowingProviderBinder

java.lang.Object

com.google.inject.throwingproviders.ThrowingProviderBinder

public class ThrowingProviderBinder
extends Object

Builds a binding for a CheckedProvider.

You can use a fluent API and custom providers:

ThrowingProviderBinder.create(binder())
    .bind(RemoteProvider.class, Customer.class)
    .to(RemoteCustomerProvider.class)
    .in(RequestScope.class);
 

or, you can use throwing provider methods:

class MyModule extends AbstractModule {
   configure() {
     ThrowingProviderBinder.install(this, binder());
   }
   
   @CheckedProvides(RemoteProvider.class)
   @RequestScope
   Customer provideCustomer(FlakyCustomerCreator creator) throws RemoteException {
     return creator.getCustomerOrThrow();
   }
 }
 

You also can declare that a CheckedProvider construct a particular class whose constructor throws an exception:

ThrowingProviderBinder.create(binder())
    .bind(RemoteProvider.class, Customer.class)
    .providing(CustomerImpl.class)
    .in(RequestScope.class);
 

Author:

jmourits@google.com (Jerome Mourits), jessewilson@google.com (Jesse Wilson), sameb@google.com (Sam Berlin)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ThrowingProviderBinder.SecondaryBinder<P extends CheckedProvider,T>

Method Summary

Methods

Modifier and Type	Method and Description
<P extends CheckedProvider,T> ThrowingProviderBinder.SecondaryBinder<P,T>	bind(Class<P> interfaceType, Class<T> clazz)
<P extends CheckedProvider> ThrowingProviderBinder.SecondaryBinder<P,?>	bind(Class<P> interfaceType, Type clazz) Deprecated. Use bind(Class, Class) or bind(Class, TypeLiteral) instead.
<P extends CheckedProvider,T> ThrowingProviderBinder.SecondaryBinder<P,T>	bind(Class<P> interfaceType, TypeLiteral<T> typeLiteral)
static ThrowingProviderBinder	create(Binder binder)
static Module	forModule(Module module) Returns a module that installs @CheckedProvides methods.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

public static ThrowingProviderBinder create(Binder binder)

forModule

public static Module forModule(Module module)

Returns a module that installs @CheckedProvides methods.

Since:

3.0

bind

@Deprecated
public <P extends CheckedProvider> ThrowingProviderBinder.SecondaryBinder<P,?> bind(Class<P> interfaceType,
                                                                                      Type clazz)

Deprecated. Use bind(Class, Class) or bind(Class, TypeLiteral) instead.

bind

public <P extends CheckedProvider,T> ThrowingProviderBinder.SecondaryBinder<P,T> bind(Class<P> interfaceType,
                                                                             Class<T> clazz)

Since:

4.0

bind

public <P extends CheckedProvider,T> ThrowingProviderBinder.SecondaryBinder<P,T> bind(Class<P> interfaceType,
                                                                             TypeLiteral<T> typeLiteral)

Since:

4.0