/
How to Use Infusion IoC

Documentation for a historical release of Infusion: 1.4
Please view the Infusion Documentation site for the latest documentation, or the Infusion 1.3. Documentation for the previous release.
If you're looking for Fluid Project coordination, design, communication, etc, try the Fluid Project Wiki.

How to Use Infusion IoC

Sept 08, 2011

This page provides an overview of the typical way to use the IoC system in a component. There are variations on this theme, but the this overview provides a basic, full-function implementation.

IoC Overview

Infusion components make use of the Framework's IoC system through three main mechanisms which work together:

  • Subcomponents demand what they need of a parent component.

  • A parent component declares what subcomponents it uses.

  • The parent component asks the Framework to create the necessary subcomponents.

Demands

A subcomponent can demand information from any of the parent components in given context using the fluid.demands. The demands specification will be registered with the Framework and referenced when the subcomponent is requested by name.

For detailed information on the format of the demands specification object, please see Demands Specifications.

For more information on the required parameters see the fluid.demands API specification.

Declaring Subcomponents

A parent component declares what subcomponents it requires through the components block of the parent component's default options using fluid.defaults. This list of subcomponents will be examined when the parent component ask the Framework to create subcomponents, as described below in #Creating Subcomponents.

For more information on how components can declare subcomponents, see Subcomponent Declaration. For details on the fluid.defaults() function, please see its API page.

Creating Subcomponents

A component creator function must call fluid.initDependents to instantiate any subcomponents declared in the defaults. The call to fluid.initDependents will create each of the subcomponents using the demands specifications registered using fluid.demands.

Every component of grade "autoInit" will call it's fluid.initDependents function during its lifecycle in order to initialize any of its subcomponents.The call to fluid.initDependents will create each of the subcomponents using the demands specifications registered using fluid.demands.

For more information on the fluid.initDependents() function, please see its API page. For a more detailed overview of this whole process, see IoC Pipeline.