rocks.frieler.android.beans

Interface BeansProvider

All Known Implementing Classes:

BeanConfigurationsBeansCollector, BeanRegistry

public interface BeansProvider

Interface for classes that provide the beans of an application.

Beans are simple Java objects, that get registered with a name and can be looked up either by their name or type to inject them as dependencies (DI).

Method Summary

Modifier and Type	Method and Description
<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.

Method Detail

lookUpBean

<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.

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

<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.

Type Parameters:

T - the bean-type

Parameters:

type - the type of the desired bean

Returns:

a bean of the given type or null

lookUpBeans

<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.

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