org.spincast.core.guice

Class GuiceModuleUtils

java.lang.Object

org.spincast.core.guice.GuiceModuleUtils

public class GuiceModuleUtils
extends Object

Utilities to inspect/manipulate Guice modules.

Constructor Summary

Constructors

Constructor and Description
GuiceModuleUtils(com.google.inject.Module... modules)
GuiceModuleUtils(com.google.inject.Module module)
GuiceModuleUtils(Set<com.google.inject.Module> modules)

Method Summary

Modifier and Type	Method and Description
static <T> SpincastGuiceModuleBase	createInterceptorModule(Class<T> toIntercept, Class<? extends T> implementationClass) Creates a module that is going to intercept the calls to toIntercept's method and will handle them with the instance of implementationClass.
<T> Class<? extends T>	getBindingTarget(Class<T> specificClass) Returns the target of the binding with the specified class/interface.
<T> Class<? extends T>	getBindingTarget(com.google.inject.Key<T> specificKey) Returns the target of the binding with the specified key.
protected <T> Set<Class<? extends T>>	getBoundClasses(Class<? extends T> parentType, com.google.inject.Key<?> specificKey)
<T> Set<Class<? extends T>>	getBoundClassesExtending(Class<? extends T> parentType) Returns the bound classes that extend or implement the specified parentType.
protected List<com.google.inject.spi.Element>	getElements()
protected com.google.inject.Module	getModule()
boolean	isKeyBound(Class<?> clazz) Checks if a class is bound in the Module
boolean	isKeyBound(com.google.inject.Key<?> keyToCheck) Checks if a key is bound in the Module

Methods inherited from class java.lang.Object

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

Constructor Detail

GuiceModuleUtils

public GuiceModuleUtils(com.google.inject.Module module)

GuiceModuleUtils

public GuiceModuleUtils(Set<com.google.inject.Module> modules)

GuiceModuleUtils

public GuiceModuleUtils(com.google.inject.Module... modules)

Method Detail

getModule

protected com.google.inject.Module getModule()

getElements

protected List<com.google.inject.spi.Element> getElements()

isKeyBound

public boolean isKeyBound(Class<?> clazz)

Checks if a class is bound in the Module

isKeyBound

public boolean isKeyBound(com.google.inject.Key<?> keyToCheck)

Checks if a key is bound in the Module

getBindingTarget

public <T> Class<? extends T> getBindingTarget(com.google.inject.Key<T> specificKey)

Returns the target of the binding with the specified key. This won't work if a Provider is used!

Returns:

the class or null if not found.

getBindingTarget

public <T> Class<? extends T> getBindingTarget(Class<T> specificClass)

Returns the target of the binding with the specified class/interface. This won't work if a Provider is used!

Returns:

the class or null if not found.

getBoundClassesExtending

public <T> Set<Class<? extends T>> getBoundClassesExtending(Class<? extends T> parentType)

Returns the bound classes that extend or implement the specified parentType.

IMPORTANT : This doesn't mean that the parentType is actually used as a key in a binding, but that there is a binding for an class that extends/implements parentType.

This won't work if a Provider is used!

getBoundClasses

protected <T> Set<Class<? extends T>> getBoundClasses(Class<? extends T> parentType,
                                                      com.google.inject.Key<?> specificKey)

createInterceptorModule

public static <T> SpincastGuiceModuleBase createInterceptorModule(Class<T> toIntercept,
                                                                  Class<? extends T> implementationClass)

Creates a module that is going to intercept the calls to toIntercept's method and will handle them with the instance of implementationClass.

This allows you, for example, to use a specific implementation for a toIntercept binding, even if an existing binding is done for a class extending toIntercept. This existing binding will still continue to use its original implementation for the methods that are not defined on toIntercept but will use the implementation speficied here for those that are.

Note that the implementationClass binding must have been done in other module.