Cbjavaloader

Core API

Injection

property name="javaloader" inject="loader@cbjavaloader";

Create Java Objects

// Create instance (calls default constructor)
var obj = javaloader.create( "com.example.MyClass" )

// Create and initialize with arguments
var reader = javaloader.create( "com.lowagie.text.pdf.PdfReader" )
    .init( expandPath( "/documents/file.pdf" ) )

// Get a static value / utility class
var constants = javaloader.create( "org.apache.poi.ss.usermodel.CellType" )

Common Use Cases

PDF Processing (iText / OpenPDF)

var pdfReader = javaloader.create( "com.lowagie.text.pdf.PdfReader" )
    .init( expandPath( "/documents/report.pdf" ) )
var pages = pdfReader.getNumberOfPages()

Excel Processing (Apache POI)

var workbook = javaloader.create( "org.apache.poi.xssf.usermodel.XSSFWorkbook" )
    .init( fileReadBinary( expandPath( "/data/data.xlsx" ) ) )
var sheet = workbook.getSheetAt( 0 )

Image Manipulation

var bufferedImage = javaloader.create( "java.awt.image.BufferedImage" )
var imageIO       = javaloader.create( "javax.imageio.ImageIO" )
var img = imageIO.read( createObject( "java", "java.io.File" ).init( imagePath ) )

HTTP Client (Apache HttpClient)

var client   = javaloader.create( "org.apache.http.impl.client.CloseableHttpClient" )
var request  = javaloader.create( "org.apache.http.client.methods.HttpGet" ).init( url )
var response = client.execute( request )

Best Practices

• Never set reloadOnEveryRequest = true in production — it destroys a new classloader each request
• Use BoxLang's this.javaSettings for Java libraries where possible — it's native and faster
• Keep JARs in a dedicated folder (/lib/ or /jars/) tracked in source control or installed via a build step
• Singleton the javaloader — it is already a singleton by default via WireBox; don't re-create it
• Prefer cbfs or native server APIs for file-system operations rather than Java java.io.File directly

Documentation

• cbjavaloader: https://github.com/coldbox-modules/cbjavaloader