jodd.petite
Class PetiteContainer

java.lang.Object
  jodd.petite.PetiteBeans
      jodd.petite.PetiteRegistry
          jodd.petite.PetiteContainer

Direct Known Subclasses:

ProxettaAwarePetiteContainer

public class PetiteContainer
extends PetiteRegistry

Petite IOC container. Consist of following layers:

• PetiteContainer - top layer that provides business usage methods
• PetiteRegistry - beans storage methods
• PetiteBeans - base layer for storing beans in scopes

  Field Summary

  static String	PETITE_CONTAINER_REF_NAME Petite container reference name.
  protected ScopedProxyManager	scopedProxyManager

  Fields inherited from class jodd.petite.PetiteBeans

  beanCollections, beans, injectionPointFactory, petiteConfig, petiteResolvers, scopes

  Constructor Summary

  PetiteContainer()
  Creates new Petite container using default configuration.

  PetiteContainer(PetiteConfig config)
  Creates new Petite container using provided configuration.

  Method Summary

  void	addBean(String name, Object bean) Adds object instance to the container as singleton bean using default wiring mode and default init method flag.
  void	addBean(String name, 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(String name) Adds self instance to the container so internal beans may fetch container for further usage.
  void	configure(PetiteConfigurator... petiteConfigurators) Configures this instance of container.
  <E> E	createBean(Class<E> type) Creates and wires a bean within the container using default wiring mode and default init methods flag.
  <E> E	createBean(Class<E> type, WiringMode wiringMode) Creates and wires a bean within the container and optionally invokes init methods.
  <T> T	getBean(Class<T> type) Returns Petite bean instance.
  Object	getBean(String name) Returns Petite bean instance.
  protected Object	getBean(String[] names, Map<String,Object> acquiredBeans) Returns Petite bean instance named as one of the provided names.
  protected Object	getBean(String name, Map<String,Object> acquiredBeans) Returns Petite bean instance.
  Object	getBeanProperty(String name) Returns petite bean property value.
  protected void	injectParams(Object bean, BeanDefinition def) Injects all parameters.
  protected void	invokeInitMethods(Object bean, BeanDefinition def, boolean fireFirstOff) Invokes all init methods.
  protected Object	newBeanInstance(BeanDefinition def, Map<String,Object> acquiredBeans) Creates new bean instance and performs constructor injection.
  void	setBeanProperty(String name, Object value) Sets petite bean property.
  void	wire(Object bean) Wires provided bean with the container using default wiring mode.
  void	wire(Object bean, WiringMode wiringMode) Wires provided bean with the container and optionally invokes init methods.
  protected void	wireBean(Object bean, BeanDefinition def, Map<String,Object> acquiredBeans) Wires beans.
  protected void	wireBeanInjectParamsAndInvokeInitMethods(BeanDefinition def, Object bean, Map<String,Object> acquiredBeans) Wires bean, injects parameters and invokes init methods.
  protected void	wireFields(Object bean, BeanDefinition def, Map<String,Object> acquiredBeans) Wires fields.
  protected void	wireMethods(Object bean, BeanDefinition def, Map<String,Object> acquiredBeans) Wires methods.

  Methods inherited from class jodd.petite.PetiteRegistry

  defineBean, defineBean, defineBean, defineBean, defineBean, defineBean, defineParameters, defineParameters, registerBean, registerBean, registerBean, registerBean, registerBean, registerBean, registerCtorInjectionPoint, registerCtorInjectionPoint, registerCtorInjectionPoint, registerCtorInjectionPoint, registerInitMethods, registerInitMethods, registerMethodInjectionPoint, registerMethodInjectionPoint, registerMethodInjectionPoint, registerMethodInjectionPoint, registerPropertyInjectionPoint, registerPropertyInjectionPoint, registerSetInjectionPoint, removeBean, removeBean

  Methods inherited from class jodd.petite.PetiteBeans

  beansIterator, defineParameter, definePetiteBean, getConfig, getParameter, getResolvers, getTotalBeans, getTotalScopes, isBeanNameRegistered, lookupBeanDefinition, lookupBeanDefinition, lookupExistingBeanDefinition, registerPetiteBean, registerPetiteCtorInjectionPoint, registerPetiteInitMethods, registerPetiteMethodInjectionPoint, registerPetitePropertyInjectionPoint, registerPetiteSetInjectionPoint, registerScope, removeBeanDefinition, resolveBeanName, resolveBeanNamesForType, resolveBeanParams, resolveCollectionInjectionPoint, resolveCtorInjectionPoint, resolveDefaultCtorInjectionPoint, resolveInitMethods, resolveMethodInjectionPoint, resolvePropertyInjectionPoint, resolveScope

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

  configure

  public void configure(PetiteConfigurator... petiteConfigurators)

  Configures this instance of container.

  newBeanInstance

  protected Object newBeanInstance(BeanDefinition def,
                                   Map<String,Object> acquiredBeans)

  Creates new bean instance and performs constructor injection.

  wireBean

  protected void wireBean(Object bean,
                          BeanDefinition def,
                          Map<String,Object> acquiredBeans)

  Wires beans.

  Parameters:

  bean - target bean

  def - bean definition

  acquiredBeans - set of acquired beans

  wireFields

  protected void wireFields(Object bean,
                            BeanDefinition def,
                            Map<String,Object> acquiredBeans)

  Wires fields.

  wireMethods

  protected void wireMethods(Object bean,
                             BeanDefinition def,
                             Map<String,Object> acquiredBeans)

  Wires methods.

  invokeInitMethods

  protected void invokeInitMethods(Object bean,
                                   BeanDefinition def,
                                   boolean fireFirstOff)

  Invokes all init methods.

  injectParams

  protected void injectParams(Object bean,
                              BeanDefinition def)

  Injects all parameters.

  getBean

  public <T> T getBean(Class<T> type)

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

  getBean

  public Object getBean(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)

  getBean

  protected Object getBean(String[] names,
                           Map<String,Object> acquiredBeans)

  Returns Petite bean instance named as one of the provided names.

  getBean

  protected Object getBean(String name,
                           Map<String,Object> acquiredBeans)

  Returns Petite bean instance.

  See Also:

  createBean(Class)

  wireBeanInjectParamsAndInvokeInitMethods

  protected void wireBeanInjectParamsAndInvokeInitMethods(BeanDefinition def,
                                                          Object bean,
                                                          Map<String,Object> acquiredBeans)

  Wires bean, injects parameters and invokes init methods.

  wire

  public void wire(Object bean)

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

  wire

  public void wire(Object bean,
                   WiringMode wiringMode)

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

  createBean

  public <E> E createBean(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(Class<E> type,
                          WiringMode wiringMode)

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

  addBean

  public void addBean(String name,
                      Object bean)

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

  addBean

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

  Adds object instance to the container as singleton bean.

  addSelf

  public void addSelf(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(String name,
                              Object value)

  Sets petite bean property.

  getBeanProperty

  public Object getBeanProperty(String name)

  Returns petite bean property value.