Blog

Brad Wood

July 05, 2013

Spread the word


Share your thoughts

If you're using external Jar files in your project, you may be loading them at run time with Mark Mandel's JavaLoader project.  (CF10 allows for dynamic loading of Jar files, but for people still on CF8, or 9, JavaLoader is the defacto method)
If you're manually creating and using the JavaLoader CFC, please remember that WireBox has a dedicated "JavaLoader" namespace in its mapping DSL to handle this for you using ColdBox's JavaLoader Plugin.  Here all you have to do:

Put a javaloader_libpath setting in your config file that tells ColdBox where the your Jars are:

ColdBox.cfc
// custom settings
settings = {
    javaloader_libpath = "/includes/jars/"
};

If you have more than one Jar directory, simply pass in a comma-delimited list, OR an array of paths.  Your choice.

Now you can inject that class into your components by using the "javaloader" namespace and following it by the Java classpath:

component {
    property name="UASparser" inject="javaLoader:cz.mallat.uasparser.UASparser";
}

That will inject the Java Class definition (which is fine for static classes).  If you need an instance, you'll want to call the init() method to actually instantiate it.

function onDIComplete() {
    oUASparser = UASparser.init(ExpandPath("/includes/uas.ini"));
}

That's not the only way-- this one-liner accomplishes the same thing:

oUASparser = getModel(dsl="javaloader:cz.mallat.uasparser.UASparser").init(ExpandPath("/includes/uas.ini"));

More info here: http://wiki.coldbox.org/wiki/Plugins:JavaLoader.cfm
And here: http://wiki.coldbox.org/wiki/WireBox.cfm#ColdBox_Namespace

Add Your Comment

(2)

Dec 09, 2014 10:39:20 UTC

by Daniel

How to add javaloader_libpath in wirebox standalone..?

Dec 09, 2014 12:11:15 UTC

by Brad Wood

The javaloader DSL namespace is only available in WireBox when it is linked to ColdBox. That's because it depends on the JavaLoader Plugin which is part of ColdBox. Note: in ColdBox 4, JavaLoader has been removed from the ColdBox core and is an optional module called cbjavaloader.

So you can't use the DSL I showed in this post by default, HOWEVER you can add this into WireBox standalone if you wish. Look at how the cbjavaloader module works-- it registers the javaloader DSL on the fly. <a href=https://github.com/ColdBox/cbox-javaloader/blob/master/modules/cbjavaloader/ModuleConfig.cfc#L26">https://github.com/ColdBox/cbox-javaloader/blob/master/modules/cbjavaloader/ModuleConfig.cfc#L26</a> You could probably make a standalone version of cbjavaloader that reused the same loader object and registered the DSL.

Honestly though, i would save my time and just start using ColdBox :) Using JavaLoader in ColdBox 4 is as simple as this: CommandBox> install cbjavaloader Done!

Recent Entries

TestBox 7 : Real-Time Streaming, a Browser IDE, and a Major Leap for BoxLang

TestBox 7 : Real-Time Streaming, a Browser IDE, and a Major Leap for BoxLang

TestBox 7.x series continues our mission to be the best testing framework for BoxLang and CFML. This release is focused heavily on BoxLang CLI runner enhancements, real-time streaming test execution via SSE, a powerful dry run capability, the brand-new TestBox RUN web IDE, and significant quality-of-life improvements for developers working in both BoxLang and CFML environments.

Luis Majano
Luis Majano
March 17, 2026
From Legacy Risk to Modern Agility: A Phased Modernization Roadmap for CFML Teams

From Legacy Risk to Modern Agility: A Phased Modernization Roadmap for CFML Teams

Many organizations running CFML applications today face the same challenge.

Their systems still work.

They support core business processes.

They generate revenue.

But at the same time, those platforms are increasingly exposed to risk.

Unsupported runtimes, operational fragility, security exposure, and difficulty integrating with modern systems are becoming more common in environments still running older versions of Adobe ColdFusion or Lucee.

The quest...

Cristobal Escobar
Cristobal Escobar
March 16, 2026
Introducing the BoxLang Spring Boot Starter: Dynamic JVM Templating for Spring

Introducing the BoxLang Spring Boot Starter: Dynamic JVM Templating for Spring

Spring Boot developers know the pain of evaluating view technologies. Thymeleaf is great — until you need more expressiveness. FreeMarker is powerful — until the syntax fights you. What if you could write templates in a dynamic JVM language that gives you the full power of the platform, feels natural, and requires zero setup to integrate?

Meet the BoxLang Spring Boot Starter.

Luis Majano
Luis Majano
March 13, 2026