jodd.petite

Class PetiteContainer

java.lang.Object

jodd.petite.PetiteBeans

jodd.petite.PetiteContainer

Direct Known Subclasses:

ProxettaAwarePetiteContainer

public class PetiteContainer
extends PetiteBeans

Petite IOC container.

See Also:

for fluent java registration of Petite beans.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PETITE_CONTAINER_REF_NAME Petite container reference name.
protected ScopedProxyManager	scopedProxyManager

Fields inherited from class jodd.petite.PetiteBeans

annotationResolver, beanCollections, beans, beansAlt, paramManager, petiteConfig, petiteResolvers, providers, referencesResolver, scopes

Constructor Summary

Constructors

Constructor and Description
PetiteContainer() Creates new Petite container using default configuration.
PetiteContainer(PetiteConfig config) Creates new Petite container using provided configuration.

Method Summary

Modifier and Type	Method and Description
void	addBean(java.lang.String name, java.lang.Object bean) Adds object instance to the container as singleton bean using default wiring mode and default init method flag.
void	addBean(java.lang.String name, java.lang.Object bean, WiringMode wiringMode) Adds object instance to the container as singleton bean.
void	addSelf() Adds self instance to the container so internal beans may fetch container for further usage.
void	addSelf(java.lang.String name) Adds self instance to the container so internal beans may fetch container for further usage.
<E> E	createBean(java.lang.Class<E> type) Creates and wires a bean within the container using default wiring mode and default init methods flag.
<E> E	createBean(java.lang.Class<E> type, WiringMode wiringMode) Creates and wires a bean within the container and optionally invokes init methods.
PetiteRegistry	createContainerRegistry() Creates PetiteRegistry helper tool for this container.
protected java.lang.Object	getBean(BeanReferences beanReferences) Returns Petite bean instance named as one of the provided names.
<T> T	getBean(java.lang.Class<T> type) Returns Petite bean instance.
<T> T	getBean(java.lang.String name) Returns Petite bean instance.
java.lang.Object	getBeanProperty(java.lang.String name) Returns petite bean property value.
protected void	injectParams(java.lang.Object bean, BeanDefinition def) Injects all parameters.
protected <T> void	invokeConsumerIfRegistered(T bean, BeanDefinition<T> def)
protected void	invokeInitMethods(java.lang.Object bean, BeanDefinition def, InitMethodInvocationStrategy invocationStrategy) Invokes all init methods, if they exist.
protected java.lang.Object	invokeProvider(ProviderDefinition provider) Invokes provider to get a bean.
protected java.lang.Object	newBeanInstance(BeanDefinition def) Creates new bean instance and performs constructor injection.
protected void	registerBeanAndWireAndInjectParamsAndInvokeInitMethods(BeanDefinition def, java.lang.Object bean) Wires bean, injects parameters and invokes init methods.
protected void	resolveInitAndDestroyMethods(java.lang.Object bean, BeanDefinition def)
void	setBeanProperty(java.lang.String name, java.lang.Object value) Sets petite bean property.
void	shutdown() Shutdowns container.
void	wire(java.lang.Object bean) Wires provided bean with the container using default wiring mode.
void	wire(java.lang.Object bean, WiringMode wiringMode) Wires provided bean with the container and optionally invokes init methods.
protected void	wireBean(java.lang.Object bean, BeanDefinition def) Wires beans.
protected void	wireMethods(java.lang.Object bean, BeanDefinition def) Wires methods.
protected void	wireProperties(java.lang.Object bean, BeanDefinition def) Wires properties.

Methods inherited from class jodd.petite.PetiteBeans

beanNames, beansCount, config, createBeanDefinitionForRegistration, defineParameter, defineParameters, defineParameters, forEachBean, forEachBeanType, getParameter, isBeanNameRegistered, lookupBeanDefinition, lookupBeanDefinitions, lookupExistingBeanDefinition, paramManager, registerBean, registerPetiteBean, registerPetiteBean, registerPetiteBean, registerPetiteCtorInjectionPoint, registerPetiteDestroyMethods, registerPetiteInitMethods, registerPetiteMethodInjectionPoint, registerPetitePropertyInjectionPoint, registerPetiteProvider, registerPetiteProvider, registerPetiteSetInjectionPoint, registerScope, removeBean, removeBean, resolveBeanName, resolveBeanNamesForType, resolveBeanParams, resolveScope, scopesCount

Methods inherited from class java.lang.Object

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

Field Detail

PETITE_CONTAINER_REF_NAME

public static final java.lang.String PETITE_CONTAINER_REF_NAME

Petite container reference name. Used when container itself is added as its bean.

See Also:

addSelf(), addSelf(String), Constant Field Values

scopedProxyManager

protected final ScopedProxyManager scopedProxyManager

Constructor Detail

PetiteContainer

public PetiteContainer()

Creates new Petite container using default configuration.

PetiteContainer

public PetiteContainer(PetiteConfig config)

Creates new Petite container using provided configuration.

Method Detail

newBeanInstance

protected java.lang.Object newBeanInstance(BeanDefinition def)

Creates new bean instance and performs constructor injection.

wireBean

protected void wireBean(java.lang.Object bean,
                        BeanDefinition def)

Wires beans.

Parameters:

bean - target bean

def - bean definition

wireProperties

protected void wireProperties(java.lang.Object bean,
                              BeanDefinition def)

Wires properties.

wireMethods

protected void wireMethods(java.lang.Object bean,
                           BeanDefinition def)

Wires methods.

resolveInitAndDestroyMethods

protected void resolveInitAndDestroyMethods(java.lang.Object bean,
                                            BeanDefinition def)

invokeInitMethods

protected void invokeInitMethods(java.lang.Object bean,
                                 BeanDefinition def,
                                 InitMethodInvocationStrategy invocationStrategy)

Invokes all init methods, if they exist. Also resolves destroy methods.

injectParams

protected void injectParams(java.lang.Object bean,
                            BeanDefinition def)

Injects all parameters.

invokeConsumerIfRegistered

protected <T> void invokeConsumerIfRegistered(T bean,
                                              BeanDefinition<T> def)

getBean

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

Returns Petite bean instance. Bean name will be resolved from provided type.

getBean

protected java.lang.Object getBean(BeanReferences beanReferences)

Returns Petite bean instance named as one of the provided names. Returns null if bean is not found.

getBean

public <T> T getBean(java.lang.String name)

Returns Petite bean instance. Petite container will find the bean in corresponding scope and all its dependencies, either by constructor or property injection. When using constructor injection, cyclic dependencies can not be prevented, but at least they are detected.

See Also:

createBean(Class)

registerBeanAndWireAndInjectParamsAndInvokeInitMethods

protected void registerBeanAndWireAndInjectParamsAndInvokeInitMethods(BeanDefinition def,
                                                                      java.lang.Object bean)

Wires bean, injects parameters and invokes init methods. Such a loooong name :)

wire

public void wire(java.lang.Object bean)

Wires provided bean with the container using default wiring mode. Bean is not registered withing container.

wire

public void wire(java.lang.Object bean,
                 WiringMode wiringMode)

Wires provided bean with the container and optionally invokes init methods. Bean is not registered withing container.

createBean

public <E> E createBean(java.lang.Class<E> type)

Creates and wires a bean within the container using default wiring mode and default init methods flag. Bean is not registered.

createBean

public <E> E createBean(java.lang.Class<E> type,
                        WiringMode wiringMode)

Creates and wires a bean within the container and optionally invokes init methods. However, bean is not registered.

invokeProvider

protected java.lang.Object invokeProvider(ProviderDefinition provider)

Invokes provider to get a bean.

addBean

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

Adds object instance to the container as singleton bean using default wiring mode and default init method flag.

addBean

public void addBean(java.lang.String name,
                    java.lang.Object bean,
                    WiringMode wiringMode)

Adds object instance to the container as singleton bean.

addSelf

public void addSelf(java.lang.String name)

Adds self instance to the container so internal beans may fetch container for further usage. No wiring is used and no init methods are invoked.

addSelf

public void addSelf()

Adds self instance to the container so internal beans may fetch container for further usage. No wiring is used and no init methods are invoked.

setBeanProperty

public void setBeanProperty(java.lang.String name,
                            java.lang.Object value)

Sets petite bean property.

getBeanProperty

public java.lang.Object getBeanProperty(java.lang.String name)

Returns petite bean property value.

createContainerRegistry

public PetiteRegistry createContainerRegistry()

Creates PetiteRegistry helper tool for this container.

shutdown

public void shutdown()

Shutdowns container. After container is down, it can't be used anymore.