Blog

Brad Wood

September 28, 2012

Spread the word


Share your thoughts

By default, WireBox will look for your CFCs using the "models" convention (scan location). So, if you ask WireBox to get you "Services.Security.PadLockService", WireBox will look for that path and component name in the root of the models directory and create a WireBox mapping for you.

If you want to reference that CFC as just "PadLockService" or an alias such as "MyReallySecureService", you can create an explicit mapping like so in your WireBox config:

map("PadLockService").to("models.Services.Security.PadLockService");
or
map("MyReallySecureService").to("models.Services.Security.PadLockService");

What if you have a ton of CFCs scattered about a bunch of sub-directories and you don't want to type out the DSL for all of them? Enter map Directory()! This handy function can be placed right in your config and it will instruct WireBox to recursively search through the directory you specify and create a mapping for every CFC it finds.

The following DSL will create a mapping for every component in "/models/Services" and all of its sub directories.

mapDirectory("models.Services");

WireBox gives you a lot of flexibility to get your components mapped, and mapDirectory() is a very handle tool to keep in your bag of tricks.

More info here: http://wiki.coldbox.org/wiki/WireBox.cfm#Mapping_Initiators

P.S. When using mapDirectory(), the mapping ID (what you use to auto wire that component later when you need to use it) will default to the name of the CFC. You can override that as well as other settings with annotations in the component declaration.

component name="PadLockService" alias="MyReallySecureService" {}

Add Your Comment

Recent Entries

MatchBox and WebAssembly: Running BoxLang in the Browser and at the Edge

MatchBox and WebAssembly: Running BoxLang in the Browser and at the Edge

The MatchBox open beta is live at https://boxlang.ortusbooks.com/boxlang-framework/matchbox, and it brings something genuinely new to the BoxLang ecosystem: a path into WebAssembly.

That means BoxLang code can now move into browser applications, static-site deployments, edge runtimes, and WASI-style containers - without requiring a JVM. The feature is still beta, but the core direction is already useful: write BoxLang, compile it with MatchBox, and ship the generated WASM artifact to wherever a small portable runtime makes sense.

Jacob Beers
Jacob Beers
June 04, 2026