Namespacing Components With Per-Application Mappings In ColdFusion

Application.cfc

component
	output = false
	hint = "I define the application settings and event handlers."
	{

	// Define the application settings.
	this.name = "CompoundPathMappingTest";
	this.applicationTimeout = createTimeSpan( 0, 1, 0, 0 );

	// When referencing ColdFusion components, paths are delimited with "." instead of
	// with "/". However, those paths ultimately map to folder structures. As such, if we
	// want to create a "namespace" (so to speak) for a set of components, we have to
	// create a ColdFusion mapping that lays-out the virtual file-based paths for our
	// namespace.
	// --
	// CAUTION: The mapping keys cannot end in a slash - this will break Adobe ColdFusion.
	// But, appears to work fine in Lucee CFML.
	this.mappings = {
		"/com/bennadel/kablamo": getDirectoryFromPath( getCurrentTemplatePath() )
	};

	// ---
	// PUBLIC METHODS.
	// ---

	/**
	* I handle the execution of the requested script.
	*/
	public void function onRequest() {

		// Our namespace - "com.bennadel.kablamo" - is using the "/com/bennadel/kablamo"
		// per-application custom mapping.
		var self = new com.bennadel.kablamo.lib.SubClass()
			.getSelf()
		;

		writeDump(
			label = "Compound Path Mapping Test",
			var = self
		);

	}

}

SubClass.cfc

/**
* NOTE: Using the namespace in "extends".
*/
component
	extends = "com.bennadel.kablamo.lib.BaseClass"
	{

	this.isSubClass = true;

	/**
	* NOTE: Using the namespace in the return type signature.
	*/
	public com.bennadel.kablamo.lib.SubClass function getSelf() {

		return( this );

	}

}