org.springframework.beans.factory

Interface ObjectProvider<T>

All Superinterfaces:

ObjectFactory<T>

public interface ObjectProvider<T>
extends ObjectFactory<T>

A variant of ObjectFactory designed specifically for injection points, allowing for programmatic optionality and lenient not-unique handling.

Since:

4.3

Author:

Juergen Hoeller

Method Summary

Modifier and Type	Method and Description
T	getIfAvailable() Return an instance (possibly shared or independent) of the object managed by this factory.
default T	getIfAvailable(java.util.function.Supplier<T> defaultSupplier) Return an instance (possibly shared or independent) of the object managed by this factory.
T	getIfUnique() Return an instance (possibly shared or independent) of the object managed by this factory.
default T	getIfUnique(java.util.function.Supplier<T> defaultSupplier) Return an instance (possibly shared or independent) of the object managed by this factory.
T	getObject(java.lang.Object... args) Return an instance (possibly shared or independent) of the object managed by this factory.
default void	ifAvailable(java.util.function.Consumer<T> dependencyConsumer) Consume an instance (possibly shared or independent) of the object managed by this factory, if available.
default void	ifUnique(java.util.function.Consumer<T> dependencyConsumer) Consume an instance (possibly shared or independent) of the object managed by this factory, if unique.

Methods inherited from interface org.springframework.beans.factory.ObjectFactory

getObject

Method Detail

getObject

T getObject(java.lang.Object... args)
     throws BeansException

Return an instance (possibly shared or independent) of the object managed by this factory.

Allows for specifying explicit construction arguments, along the lines of BeanFactory.getBean(String, Object...).

Parameters:

args - arguments to use when creating a corresponding instance

Returns:

an instance of the bean

Throws:

BeansException - in case of creation errors

See Also:

ObjectFactory.getObject()

getIfAvailable

@Nullable
T getIfAvailable()
                    throws BeansException

Return an instance (possibly shared or independent) of the object managed by this factory.

Returns:

an instance of the bean, or null if not available

Throws:

BeansException - in case of creation errors

See Also:

ObjectFactory.getObject()

getIfAvailable

default T getIfAvailable(java.util.function.Supplier<T> defaultSupplier)
                  throws BeansException

Return an instance (possibly shared or independent) of the object managed by this factory.

Parameters:

defaultSupplier - a callback for supplying a default object if none is present in the factory

Returns:

an instance of the bean, or the supplied default object if no such bean is available

Throws:

BeansException - in case of creation errors

Since:

5.0

See Also:

getIfAvailable()

ifAvailable

default void ifAvailable(java.util.function.Consumer<T> dependencyConsumer)
                  throws BeansException

Consume an instance (possibly shared or independent) of the object managed by this factory, if available.

Parameters:

dependencyConsumer - a callback for processing the target object if available (not called otherwise)

Throws:

BeansException - in case of creation errors

Since:

5.0

See Also:

getIfAvailable()

getIfUnique

@Nullable
T getIfUnique()
                 throws BeansException

Return an instance (possibly shared or independent) of the object managed by this factory.

Returns:

an instance of the bean, or null if not available or not unique (i.e. multiple candidates found with none marked as primary)

Throws:

BeansException - in case of creation errors

See Also:

ObjectFactory.getObject()

getIfUnique

default T getIfUnique(java.util.function.Supplier<T> defaultSupplier)
               throws BeansException

Return an instance (possibly shared or independent) of the object managed by this factory.

Parameters:

defaultSupplier - a callback for supplying a default object if no unique candidate is present in the factory

Returns:

an instance of the bean, or the supplied default object if no such bean is available or if it is not unique in the factory (i.e. multiple candidates found with none marked as primary)

Throws:

BeansException - in case of creation errors

Since:

5.0

See Also:

getIfUnique()

ifUnique

default void ifUnique(java.util.function.Consumer<T> dependencyConsumer)
               throws BeansException

Consume an instance (possibly shared or independent) of the object managed by this factory, if unique.

Parameters:

dependencyConsumer - a callback for processing the target object if unique (not called otherwise)

Throws:

BeansException - in case of creation errors

Since:

5.0

See Also:

getIfAvailable()