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

Building Native CLI Apps with MatchBox & Native Fusion

Building Native CLI Apps with MatchBox & Native Fusion

MatchBox makes BoxLang practical for a classic deployment target: the single-file command-line application.

The MatchBox open beta is available at https://github.com/ortus-boxlang/matchbox.

With the MatchBox native target, you can compile a .bxs script into a standalone executable for macOS, Linux, or Windows. The generated binary includes the MatchBox VM core and your compiled BoxLang bytecode. It does not require a JVM, a separate MatchBox install, or any runtime on the target machine.

Jacob Beers
Jacob Beers
July 14, 2026