rocks.frieler.android.beans

Class BeanConfigurationsBeansCollector

java.lang.Object

rocks.frieler.android.beans.BeanConfigurationsBeansCollector

All Implemented Interfaces:

BeansCollector, BeansProvider

public class BeanConfigurationsBeansCollector
extends java.lang.Object
implements BeansCollector, BeansProvider

The BeanConfigurationsBeansCollector collects the beans defined by BeanConfigurations in a BeanRegistry.

The BeanConfigurationsBeansCollector also implements the BeansProvider-interface by providing the beans that are already registered in the BeanRegistry. In addition the BeanConfigurationsBeansCollector may process further BeanConfigurations to fulfill bean-lookups for beans that are not present yet.

Method Summary

Modifier and Type	Method and Description
void	defineBean(java.lang.Object bean) Callback-method for BeanConfigurations to define their beans.
void	defineBean(java.lang.String name, java.lang.Object bean) Callback-method for BeanConfigurations to define their beans with an explicit name.
<T> T	lookUpBean(java.lang.Class<T> type) Looks up a bean of the given type.
<T> T	lookUpBean(java.lang.String name, java.lang.Class<T> type) Looks up the bean with the given name and type.
<T> java.util.List<T>	lookUpBeans(java.lang.Class<T> type) Looks up all beans of the given type in the BeanRegistry of this application.
void	registerBeanPostProcessor(BeanPostProcessor beanPostProcessor) Registers the given BeanPostProcessor at the underlying BeanRegistry.

Methods inherited from class java.lang.Object

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

Method Detail

defineBean

public void defineBean(java.lang.Object bean)

Callback-method for BeanConfigurations to define their beans.

Specified by:

defineBean in interface BeansCollector

Parameters:

bean - the bean

defineBean

public void defineBean(java.lang.String name,
                       java.lang.Object bean)

Callback-method for BeanConfigurations to define their beans with an explicit name.

Defining a bean with an explicit name allows to override a bean with the same name. Additionally defining an explicit name can speed-up the lookup of the bean if the lookup is done by name.

Specified by:

defineBean in interface BeansCollector

Parameters:

name - the name of the bean

bean - the bean

registerBeanPostProcessor

public void registerBeanPostProcessor(BeanPostProcessor beanPostProcessor)

Registers the given BeanPostProcessor at the underlying BeanRegistry.

Specified by:

registerBeanPostProcessor in interface BeansCollector

Parameters:

beanPostProcessor - the new BeanPostProcessor

See Also:

BeanRegistry.registerBeanPostProcessor(BeanPostProcessor)

lookUpBean

public <T> T lookUpBean(java.lang.String name,
                        java.lang.Class<T> type)

Looks up the bean with the given name and type.

If no bean with that name is registered or the registered bean is not assignable to the required type, null is returned.

In order to find the bean, the BeanConfigurationsBeansCollector will attempt to collect more beans from remaining ready BeanConfigurations first.

Specified by:

lookUpBean in interface BeansProvider

Type Parameters:

T - the bean-type

Parameters:

name - the name of the desired bean

type - the type of the desired bean

Returns:

the named bean or null

lookUpBean

public <T> T lookUpBean(java.lang.Class<T> type)

Looks up a bean of the given type.

If no bean is assignable to the required type, null is returned. If multiple beans are assignable to the required type, the first match is returned.

In order to find the bean, the BeanConfigurationsBeansCollector will attempt to collect more beans from remaining ready BeanConfigurations first.

Specified by:

lookUpBean in interface BeansProvider

Type Parameters:

T - the bean-type

Parameters:

type - the type of the desired bean

Returns:

a bean of the given type or null

lookUpBeans

public <T> java.util.List<T> lookUpBeans(java.lang.Class<T> type)

Looks up all beans of the given type in the BeanRegistry of this application.

In order to find all beans, the BeanConfigurationsBeansCollector will attempt to collect more beans from remaining ready BeanConfigurations first.

Specified by:

lookUpBeans in interface BeansProvider

Type Parameters:

T - the bean-type

Parameters:

type - the type of the desired beans

Returns:

the beans of the given type or an empty list