F
- The factory interfaceFactoryModuleBuilder
instead.@Deprecated public class FactoryProvider<F> extends Object implements Provider<F>, HasDependencies
FactoryModuleBuilder
for its more concise API and
additional capability.
Provides a factory that combines the caller's arguments with injector-supplied values to construct objects.
public interface PaymentFactory { Payment create(Date startDate, Money amount); }You can name your factory methods whatever you like, such as create, createPayment or newPayment.
constructedType
is a concrete class with an @Inject
-annotated
constructor. In addition to injector-supplied parameters, the constructor should have parameters
that match each of the factory method's parameters. Each factory-supplied parameter requires an
@Assisted
annotation. This serves to document that the parameter is not bound
by your application's modules.
public class RealPayment implements Payment { @Inject public RealPayment( CreditService creditService, AuthService authService, @Assisted Date startDate, @Assisted Money amount) { ... } }Any parameter that permits a null value should also be annotated
@Nullable
.
module
, bind the factory interface to the returned
factory:
bind(PaymentFactory.class).toProvider( FactoryProvider.newFactory(PaymentFactory.class, RealPayment.class));As a side-effect of this binding, Guice will inject the factory to initialize it for use. The factory cannot be used until the injector has been initialized.
public class PaymentAction { @Inject private PaymentFactory paymentFactory; public void doPayment(Money amount) { Payment payment = paymentFactory.create(new Date(), amount); payment.apply(); } }
Assisted
annotation to disambiguate the parameters.
The names must be applied to the factory method's parameters:
public interface PaymentFactory { Payment create( @Assisted("startDate") Date startDate, @Assisted("dueDate") Date dueDate, Money amount); }...and to the concrete type's constructor parameters:
public class RealPayment implements Payment { @Inject public RealPayment( CreditService creditService, AuthService authService, @Assisted("startDate") Date startDate, @Assisted("dueDate") Date dueDate, @Assisted Money amount) { ... } }
AssistedInject
. This triggers a limited backwards-compatability mode.
Instead of matching factory method arguments to constructor parameters using their names, the parameters are matched by their order. The first factory method argument is used for the first @Assisted constructor parameter, etc.. Annotation names have no effect.
Returned values are not created by Guice. These types are not eligible for method interception. They do receive post-construction member injection.
Modifier and Type | Method and Description |
---|---|
boolean |
equals(Object obj)
Deprecated.
|
F |
get()
Deprecated.
|
Set<Dependency<?>> |
getDependencies()
Deprecated.
|
int |
hashCode()
Deprecated.
|
static <F> Provider<F> |
newFactory(Class<F> factoryType,
Class<?> implementationType)
Deprecated.
|
static <F> Provider<F> |
newFactory(TypeLiteral<F> factoryType,
TypeLiteral<?> implementationType)
Deprecated.
|
public static <F> Provider<F> newFactory(Class<F> factoryType, Class<?> implementationType)
public static <F> Provider<F> newFactory(TypeLiteral<F> factoryType, TypeLiteral<?> implementationType)
public Set<Dependency<?>> getDependencies()
getDependencies
in interface HasDependencies
Copyright © 2006–2020 Google, Inc.. All rights reserved.