AbstractModule (Guice 4.1 API)

java.lang.Object
- com.google.inject.AbstractModule

All Implemented Interfaces:: Module

Direct Known Subclasses:: GraphvizModule, ServletModule

public abstract class AbstractModule
extends java.lang.Object
implements Module

A support class for Modules which reduces repetition and results in a more readable configuration. Simply extend this class, implement configure(), and call the inherited methods which mirror those found in Binder. For example:

 public class MyModule extends AbstractModule {
   protected void configure() {
     bind(Service.class).to(ServiceImpl.class).in(Singleton.class);
     bind(CreditCardPaymentService.class);
     bind(PaymentService.class).to(CreditCardPaymentService.class);
     bindConstant().annotatedWith(Names.named("port")).to(8080);
   }
 }

Constructor Summary

Constructors
Constructor Description

AbstractModule()

Constructors
Constructor	Description
`AbstractModule()`

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method	Description
`protected void`	`addError(Message message)`
`protected void`	`addError(java.lang.String message, java.lang.Object... arguments)`
`protected void`	`addError(java.lang.Throwable t)`
`protected <T> LinkedBindingBuilder<T>`	`bind(Key<T> key)`
`protected <T> AnnotatedBindingBuilder<T>`	`bind(TypeLiteral<T> typeLiteral)`
`protected <T> AnnotatedBindingBuilder<T>`	`bind(java.lang.Class<T> clazz)`
`protected AnnotatedConstantBindingBuilder`	`bindConstant()`
`protected Binder`	`binder()`	Gets direct access to the underlying `Binder`.
`protected void`	`bindInterceptor(Matcher<? super java.lang.Class<?>> classMatcher, Matcher<? super java.lang.reflect.Method> methodMatcher, org.aopalliance.intercept.MethodInterceptor... interceptors)`
`protected void`	`bindListener(Matcher<? super Binding<?>> bindingMatcher, ProvisionListener... listener)`
`protected void`	`bindListener(Matcher<? super TypeLiteral<?>> typeMatcher, TypeListener listener)`
`protected void`	`bindScope(java.lang.Class<? extends java.lang.annotation.Annotation> scopeAnnotation, Scope scope)`
`protected abstract void`	`configure()`	Configures a `Binder` via the exposed methods.
`void`	`configure(Binder builder)`	Contributes bindings and other configurations for this module to `binder`.
`protected void`	`convertToTypes(Matcher<? super TypeLiteral<?>> typeMatcher, TypeConverter converter)`
`protected Stage`	`currentStage()`
`protected <T> MembersInjector<T>`	`getMembersInjector(TypeLiteral<T> type)`
`protected <T> MembersInjector<T>`	`getMembersInjector(java.lang.Class<T> type)`
`protected <T> Provider<T>`	`getProvider(Key<T> key)`
`protected <T> Provider<T>`	`getProvider(java.lang.Class<T> type)`
`protected void`	`install(Module module)`
`protected void`	`requestInjection(java.lang.Object instance)`
`protected void`	`requestStaticInjection(java.lang.Class<?>... types)`
`protected void`	`requireBinding(Key<?> key)`	Adds a dependency from this module to `key`.
`protected void`	`requireBinding(java.lang.Class<?> type)`	Adds a dependency from this module to `type`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - AbstractModule
```
public AbstractModule()
```
- Method Detail
  - configure
```
public final void configure(Binder builder)
```
    Description copied from interface: Module
    
    Contributes bindings and other configurations for this module to binder.
    Do not invoke this method directly to install submodules. Instead use Binder.install(Module), which ensures that provider methods are discovered.
    
    Specified by:
    
    configure in interface Module
  - configure
```
protected abstract void configure()
```
    Configures a Binder via the exposed methods.
  - binder
```
protected Binder binder()
```
    Gets direct access to the underlying Binder.
  - bindScope
```
protected void bindScope(java.lang.Class<? extends java.lang.annotation.Annotation> scopeAnnotation,
                         Scope scope)
```
    See Also:
    
    Binder.bindScope(Class, Scope)
  - bind
```
protected <T> LinkedBindingBuilder<T> bind(Key<T> key)
```
    See Also:
    
    Binder.bind(Key)
  - bind
```
protected <T> AnnotatedBindingBuilder<T> bind(TypeLiteral<T> typeLiteral)
```
    See Also:
    
    Binder.bind(TypeLiteral)
  - bind
```
protected <T> AnnotatedBindingBuilder<T> bind(java.lang.Class<T> clazz)
```
    See Also:
    
    Binder.bind(Class)
  - bindConstant
```
protected AnnotatedConstantBindingBuilder bindConstant()
```
    See Also:
    
    Binder.bindConstant()
  - install
```
protected void install(Module module)
```
    See Also:
    
    Binder.install(Module)
  - addError
```
protected void addError(java.lang.String message,
                        java.lang.Object... arguments)
```
    See Also:
    
    Binder.addError(String, Object[])
  - addError
```
protected void addError(java.lang.Throwable t)
```
    See Also:
    
    Binder.addError(Throwable)
  - addError
```
protected void addError(Message message)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.addError(Message)
  - requestInjection
```
protected void requestInjection(java.lang.Object instance)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.requestInjection(Object)
  - requestStaticInjection
```
protected void requestStaticInjection(java.lang.Class<?>... types)
```
    See Also:
    
    Binder.requestStaticInjection(Class[])
  - bindInterceptor
```
protected void bindInterceptor(Matcher<? super java.lang.Class<?>> classMatcher,
                               Matcher<? super java.lang.reflect.Method> methodMatcher,
                               org.aopalliance.intercept.MethodInterceptor... interceptors)
```
    See Also:
    
    Binder.bindInterceptor(com.google.inject.matcher.Matcher, com.google.inject.matcher.Matcher, org.aopalliance.intercept.MethodInterceptor[])
  - requireBinding
```
protected void requireBinding(Key<?> key)
```
    Adds a dependency from this module to key. When the injector is created, Guice will report an error if key cannot be injected. Note that this requirement may be satisfied by implicit binding, such as a public no-arguments constructor.
    
    Since:
    
    2.0
  - requireBinding
```
protected void requireBinding(java.lang.Class<?> type)
```
    Adds a dependency from this module to type. When the injector is created, Guice will report an error if type cannot be injected. Note that this requirement may be satisfied by implicit binding, such as a public no-arguments constructor.
    
    Since:
    
    2.0
  - getProvider
```
protected <T> Provider<T> getProvider(Key<T> key)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.getProvider(Key)
  - getProvider
```
protected <T> Provider<T> getProvider(java.lang.Class<T> type)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.getProvider(Class)
  - convertToTypes
```
protected void convertToTypes(Matcher<? super TypeLiteral<?>> typeMatcher,
                              TypeConverter converter)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.convertToTypes(com.google.inject.matcher.Matcher<? super com.google.inject.TypeLiteral<?>>, com.google.inject.spi.TypeConverter)
  - currentStage
```
protected Stage currentStage()
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.currentStage()
  - getMembersInjector
```
protected <T> MembersInjector<T> getMembersInjector(java.lang.Class<T> type)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.getMembersInjector(Class)
  - getMembersInjector
```
protected <T> MembersInjector<T> getMembersInjector(TypeLiteral<T> type)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.getMembersInjector(TypeLiteral)
  - bindListener
```
protected void bindListener(Matcher<? super TypeLiteral<?>> typeMatcher,
                            TypeListener listener)
```
    Since:
    
    2.0
    
    See Also:
    
    Binder.bindListener(com.google.inject.matcher.Matcher, com.google.inject.spi.TypeListener)
  - bindListener
```
protected void bindListener(Matcher<? super Binding<?>> bindingMatcher,
                            ProvisionListener... listener)
```
    Since:
    
    4.0
    
    See Also:
    
    Binder.bindListener(Matcher, ProvisionListener...)

Class AbstractModule

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

AbstractModule

Method Detail

configure

configure

binder

bindScope

bind

bind

bind

bindConstant

install

addError

addError

addError

requestInjection

requestStaticInjection

bindInterceptor

requireBinding

requireBinding

getProvider

getProvider

convertToTypes

currentStage

getMembersInjector

getMembersInjector

bindListener

bindListener