Correct example Application.cfc files

Author: seancorfield

Application.cfc

@@ -1,35 +1,61 @@
 component {
+    // copy this to your application root to use as your Application.cfc
+    // or incorporate the logic below into your existing Application.cfc
+
     // you can provide a specific application name if you want:
     this.name = hash( getBaseTemplatePath() );
+
     // any other application settings:
     this.sessionManagement = true;
-    this.mappings[ '/framework' ] =
-        getDirectoryFromPath( getBaseTemplatePath() ) & 'framework';
 
-    // create your FW/1 application:
-    request._framework_one = new framework.one( {
-        trace = true,
-		base = getDirectoryFromPath( CGI.SCRIPT_NAME )
-            .replaceFirst( getContextRoot(), '' ) & 'introduction'
-    } );
+    // set up per-application mappings as needed:
+    this.mappings[ '/framework' ] = getDirectoryFromPath( getBaseTemplatePath() ) & 'framework';
+    // this.mappings[ '/app' ] expandPath( '../path/to/app' );
+
+    function _get_framework_one() {
+        if ( !structKeyExists( request, '_framework_one' ) ) {
+
+            // create your FW/1 application:
+            request._framework_one = new framework.one( {
+                trace = true,
+		        base = getDirectoryFromPath( CGI.SCRIPT_NAME )
+                    .replaceFirst( getContextRoot(), '' ) & 'introduction'
+            } );
+
+            // you can specify FW/1 configuration as an argument:
+            // request._framework_one = new framework.one({
+            //     base : '/app',
+            //     trace : true
+            // });
+
+            // if you need to override extension points, use
+            // MyApplication.cfc for those and then do:
+            // request._framework_one = new MyApplication({
+            //     base : '/app',
+            //     trace : true
+            // });
+
+        }
+        return request._framework_one;
+    }
 
     // delegation of lifecycle methods to FW/1:
     function onApplicationStart() {
-        return request._framework_one.onApplicationStart();
+        return _get_framework_one().onApplicationStart();
     }
     function onError( exception, event ) {
-        return request._framework_one.onError( exception, event );
+        return _get_framework_one().onError( exception, event );
     }
     function onRequest( targetPath ) {
-        return request._framework_one.onRequest( targetPath );
+        return _get_framework_one().onRequest( targetPath );
     }
     function onRequestEnd() {
-        return request._framework_one.onRequestEnd();
+        return _get_framework_one().onRequestEnd();
     }
     function onRequestStart( targetPath ) {
-        return request._framework_one.onRequestStart( targetPath );
+        return _get_framework_one().onRequestStart( targetPath );
     }
     function onSessionStart() {
-        return request._framework_one.onSessionStart();
+        return _get_framework_one().onSessionStart();
     }
 }

examples/Application.cfc

@@ -1,35 +1,62 @@
 component {
+    // copy this to your application root to use as your Application.cfc
+    // or incorporate the logic below into your existing Application.cfc
+
     // you can provide a specific application name if you want:
-	this.name = 'fw1-examples';
+    this.name = 'fw1-examples';
+
     // any other application settings:
     this.sessionManagement = true;
+
+    // set up per-application mappings as needed:
     this.mappings[ '/framework' ] = expandPath( '../framework' );
+    // this.mappings[ '/app' ] expandPath( '../path/to/app' );
+
+    function _get_framework_one() {
+        if ( !structKeyExists( request, '_framework_one' ) ) {
 
-    // create your FW/1 application:
-    request._framework_one = new framework.one( {
-		SESOmitIndex = true,
-        diLocations = "model, controllers, beans, services", // to account for the variety of D/I locations in our examples
-        // that allows all our subsystems to automatically have their own bean factory with the base factory as parent
-        trace = true
-    } );
+            // create your FW/1 application:
+            request._framework_one = new framework.one( {
+		        SESOmitIndex = true,
+                diLocations = "model, controllers, beans, services", // to account for the variety of D/I locations in our examples
+                // that allows all our subsystems to automatically have their own bean factory with the base factory as parent
+                trace = true
+            } );
+
+            // you can specify FW/1 configuration as an argument:
+            // request._framework_one = new framework.one({
+            //     base : '/app',
+            //     trace : true
+            // });
+
+            // if you need to override extension points, use
+            // MyApplication.cfc for those and then do:
+            // request._framework_one = new MyApplication({
+            //     base : '/app',
+            //     trace : true
+            // });
+
+        }
+        return request._framework_one;
+    }
 
     // delegation of lifecycle methods to FW/1:
     function onApplicationStart() {
-        return request._framework_one.onApplicationStart();
+        return _get_framework_one().onApplicationStart();
     }
     function onError( exception, event ) {
-        return request._framework_one.onError( exception, event );
+        return _get_framework_one().onError( exception, event );
     }
     function onRequest( targetPath ) {
-        return request._framework_one.onRequest( targetPath );
+        return _get_framework_one().onRequest( targetPath );
     }
     function onRequestEnd() {
-        return request._framework_one.onRequestEnd();
+        return _get_framework_one().onRequestEnd();
     }
     function onRequestStart( targetPath ) {
-        return request._framework_one.onRequestStart( targetPath );
+        return _get_framework_one().onRequestStart( targetPath );
     }
     function onSessionStart() {
-        return request._framework_one.onSessionStart();
+        return _get_framework_one().onSessionStart();
     }
 }