cbjavaloader

Load Java JAR libraries at runtime in ColdBox applications.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/ColdBox/skills --skill cbjavaloader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cbjavaloader
Source: https://github.com/ColdBox/skills/tree/main/modules/cbjavaloader
Command: npx skills add https://github.com/ColdBox/skills --skill cbjavaloader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Dynamically load and manage Java JAR libraries in a running ColdBox application so developers can instantiate Java classes and use Java libraries without restarting the CFML server, while controlling reload behavior between development and production.

Core Features & Use Cases

  • Dynamic JAR loading with configurable load paths to keep libraries organized and versioned.
  • Classloader management and reloadOnEveryRequest toggling to enable fast development loops and safe production behavior.
  • WireBox-compatible injection for a singleton javaloader and simple creation/initialization of Java objects for common tasks.
  • Typical use cases include PDF processing with iText/OpenPDF, spreadsheet handling with Apache POI, image manipulation via Java imaging APIs, and using Apache HttpClient for advanced HTTP interactions.

Quick Start

Use cbjavaloader to load JARs from your project's lib folder, set reloadOnEveryRequest for development, inject the javaloader, and instantiate the Java class you need to perform processing.

Frequently Asked Questions about cbjavaloader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I load Java JAR libraries in a ColdBox application without restarting the server?

To load Java JAR libraries without restarting the server, use cbjavaloader to dynamically add JARs from configurable load paths at runtime. This allows your ColdBox application to instantiate Java classes immediately without requiring a CFML server restart.

Can I use Apache POI and iText for PDF and Excel processing in ColdBox?

Yes, you can use Apache POI and iText for PDF and Excel processing in ColdBox. The cbjavaloader dynamically loads these Java libraries at runtime, allowing you to instantiate their classes for spreadsheet handling and PDF processing without server restarts.

How do I configure dynamic classloader reloads during ColdBox development?

To configure dynamic classloader reloads during development, toggle the reloadOnEveryRequest setting in cbjavaloader. This enables fast development loops by automatically reloading Java libraries on each request, while ensuring safe production behavior when disabled.

What is the best way to inject a Java classloader as a singleton in WireBox?

The best way to inject a Java classloader as a singleton in WireBox is using cbjavaloader's WireBox-compatible injection. This provides a singleton javaloader instance for safe reuse, allowing simple creation and initialization of Java objects across your ColdBox application.

Does cbjavaloader support including the server classpath when loading JAR files?

Yes, cbjavaloader supports optional inclusion of the server classpath when loading JAR files. This feature allows you to combine dynamically loaded libraries with existing server classpath resources, providing flexible class resolution within your ColdBox application.