Difference between revisions of "Add ADF Library Components into App"

From ADF Docs
Jump to: navigation, search
(Add ADF Library Components into an Application)
Line 1: Line 1:
== Add ADF Library Components into an Application ==
+
== Overview ==
Following are instructions for adding an ADF library component into an ADF Application:  
+
ADF Library Components are CFC's loaded into the core ADF.  The components are typically located in the /ADF/lib/ directory and are sectioned into "Classes" of sorts.  By adding or "injecting" ADF Library Components into your applications, it will make it easier for you to:
 +
* Program against particular versions of ADF Library Components
 +
* Upgrade your applications
 +
 
 +
== Instructions ==
 +
Here are some instructions for adding an ADF Library Component into an ADF Application:  
  
 
# Open the ''AppBeanConfig.cfm'' file in your applications directory.  See the [[App Bean Config|App Bean Config]] wiki page for more details.
 
# Open the ''AppBeanConfig.cfm'' file in your applications directory.  See the [[App Bean Config|App Bean Config]] wiki page for more details.
Line 13: Line 18:
 
   addConstructorDependency(appBeanName, "scripts_1_0", "scripts");
 
   addConstructorDependency(appBeanName, "scripts_1_0", "scripts");
 
# Where ''scripts_1_0'' is the ADF Library component and the property name will be ''scripts'' when referenced within the apps application scope (i.e. Application.MYAPP.scripts).
 
# Where ''scripts_1_0'' is the ADF Library component and the property name will be ''scripts'' when referenced within the apps application scope (i.e. Application.MYAPP.scripts).
 +
 +
== Using ADF Library Components in your App ==
 +
Now that you have loaded the ADF Library Component into your application you can now write code similar to this in your applications render handlers, custom scripts and custom field types:
 +
 +
<pre>
 +
<cfscript>
 +
  application.myApp.scripts.loadJQuery();
 +
  application.myApp.scripts.loadJQueryUI();
 +
</cfscript>
 +
</pre>
  
 
[[Category: How-to Guide]]
 
[[Category: How-to Guide]]

Revision as of 20:22, 7 March 2010

Overview

ADF Library Components are CFC's loaded into the core ADF. The components are typically located in the /ADF/lib/ directory and are sectioned into "Classes" of sorts. By adding or "injecting" ADF Library Components into your applications, it will make it easier for you to:

  • Program against particular versions of ADF Library Components
  • Upgrade your applications

Instructions

Here are some instructions for adding an ADF Library Component into an ADF Application:

  1. Open the AppBeanConfig.cfm file in your applications directory. See the App Bean Config wiki page for more details.
  2. Identify what ADF Library components and version you want added to your application.
  3. Add the 'addConstructorDependency' command into the App Bean Config.
 addConstructorDependency(BeanName, InjectedBeanName, PropertyName);
  1. The parameters for the 'addConstructorDependency' command are as follows:
    1. BeanName:string:required - The name of the bean (Singleton or Transient) to add the Dependency to.
    2. InjectedBeanName:string:required - The name of the bean to inject.
    3. PropertyName:string:optional - The optional property name to pass the bean into. Defaults to the bean name if not provided.
  2. The following is an example of adding a dependency for the Scripts_1_0 ADF library component to your application.
  addConstructorDependency(appBeanName, "scripts_1_0", "scripts");
  1. Where scripts_1_0 is the ADF Library component and the property name will be scripts when referenced within the apps application scope (i.e. Application.MYAPP.scripts).

Using ADF Library Components in your App

Now that you have loaded the ADF Library Component into your application you can now write code similar to this in your applications render handlers, custom scripts and custom field types:

<cfscript>
  application.myApp.scripts.loadJQuery();
  application.myApp.scripts.loadJQueryUI();
</cfscript>