Day 3 of the 12 Days of Christmas: Real-Time Power with BoxLang + SocketBox 🎄

As BoxLang continues evolving into a modern, high-performance, JVM-based runtime, real-time communication becomes essential for the applications we all want to build: dashboards, collaboration tools, notifications, live feeds, multiplayer features, and more.

That’s where SocketBox steps in — the WebSocket upgrade listener built to work seamlessly with CommandBox and the BoxLang MiniServer. ⚡

Today, for Day 3, we’re highlighting how SocketBox supercharges BoxLang development by giving you fast, flexible, and framework-agnostic WebSocket capabilities.

---

🔌 What Is SocketBox?

SocketBox is a lightweight WebSocket listener library that runs inside:

• CommandBox Web Server
• BoxLang MiniServer

It isn't a separate server — instead, it upgrades a request on the same port.

This means:

• No extra infrastructure
• Real-time messages delivered through your existing BoxLang or CFML request pipeline
• Full access to cookies, headers, sessions, hostnames — all available through standard CGI variables 🧩

At the core, your app receives WebSocket messages through an internal request to:

/WebSocket.cfc?method=onProcess

You then build your logic inside a custom WebSocket.cfc (or .bx) by extending SocketBox’s classes.

---

💡 Why SocketBox Matters for BoxLang Developers

SocketBox gives BoxLang apps:

• Real-time capabilities
• Low-level control when needed
• Optional STOMP message routing when you need advanced messaging
• A unified WebSocket experience across Lucee, Adobe CF, and BoxLang

All using the same integration layer — making your WebSocket code portable across engines.

Fewer surprises. More consistency. ✨

---

🧱 Two Ways to Use SocketBox

SocketBox offers two modes depending on how advanced your real-time logic needs to be.

---

1️⃣ Core WebSocket Mode — Simple & Direct

This is the lightweight, low-level mode ideal when you want total control.

You get callbacks for:

onConnect( channel )
onClose( channel )
onMessage( message, channel )

And utilities like:

sendMessage( message, channel )
broadcastMessage( message )
getAllConnections()

Example: Ping-Pong Handler

function onMessage( required message, required channel ) {
    if ( message == "Ping" ) {
        sendMessage( "Pong", channel );
    }
}

Perfect for custom logic, games, live alerts, or when you want to define your own protocol.

No magic — just raw power ⚡.

---

2️⃣ STOMP Broker Mode — Enterprise Messaging

When you need authentication, routing, topics, fanouts, wildcards, heartbeats, and subscriptions —

the STOMP mode is your friend.

Extend:

modules.socketbox.models.WebSocketSTOMP

This unlocks:

• 🔐 Authentication & authorization hooks
• 🧭 Topic routing, exchanges, subscription management
• 🫀 Heartbeats & reconnection logic
• 🧩 Server-side listeners
• 📦 JSON message handling

You can even configure your own message exchanges:

• .direct
• .topic
• .fanout
• .distribution
• Or custom CFC exchanges

The STOMP broker provides message semantics similar to modern messaging platforms but fully embedded inside CommandBox + BoxLang.

---

⚙️ Browser Usage Example

Core WS Example

<script>
  const socket = new WebSocket('ws://localhost/ws');

  socket.onopen = () => socket.send("Hello from the browser!");
  socket.onmessage = e => console.log("Server:", e.data);
</script>

STOMP Example

import { Client } from '@stomp/stompjs';

const client = new Client({
  brokerURL: 'ws://localhost/ws',
  heartbeatIncoming: 10000,
  heartbeatOutgoing: 10000
});

client.activate();
</script>

WebSockets are fully accessible for modern frontend stacks — React, Vue, Svelte, and even Alpine.js.

---

🎯 Why BoxLang + SocketBox is a Big Deal

BoxLang already brings:

• A modern, JVM-powered language
• Multi-runtime support
• Native CFML compatibility
• Fast startup and flexible deployment

Adding SocketBox gives BoxLang real-time superpowers:

✨ Build dashboards

✨ Push notifications

✨ Live collaboration tools

✨ Multiplayer features

✨ Monitoring interfaces

✨ IoT / streaming integrations

With zero extra servers — just CommandBox or the MiniServer.

---

📚 Learn More & Explore

• SocketBox Source: https://github.com/ortus-boxlang/socketbox
• WebSockets in CommandBox Docs
• BoxLang Runtime Docs

---

🎁 Day 3 Summary

BoxLang + SocketBox delivers a modern, flexible, and production-ready WebSocket layer perfect for real-time applications.

Whether you're building small prototype tools or enterprise messaging systems, SocketBox gives you both simplicity and power — all running inside the BoxLang ecosystem.

More Christmas goodies coming tomorrow 🎄😉

---

Want to Join the BoxLang Modern World?

Become a Pioneer

BoxLang is growing fast features are expanding, the ecosystem is thriving, and performance is turning heads. But the most exciting part? You can be part of shaping it from the very beginning.

The Pioneer Program is your gateway to early access, unmatched support, and unbeatable value. Here’s what you get:

1. Everything in BoxLang+, and more:
   • Professional support to get you running smoothly
   • A dedicated Slack channel for direct access to our team, solve issues in seconds
   • Priority handling for your feature requests and bug fixes
2. Migration done with you, not just for you:
   • Our engineers work alongside your team to migrate your apps end-to-end
   • Guaranteed compatibility, we won’t stop until it works perfectly
3. Big savings, no hidden tricks:
   • At least 40% off your current licensing costs, locked in early, no surprise charges as you grow

Contact Us

---

Still Not Convinced?

If you’re unsure how BoxLang will work with your applications, or whether it can truly make a difference, we’ve made it easy to see the value for yourself, risk-free:

1. Free 30-Minute Consultation & App Diagnosis

   We’ll review your applications, identify bottlenecks, and give you a clear modernization plan. You’ll see exactly where you can save time, reduce costs, and unlock new possibilities with BoxLang.

2. 1-Year Free Non-Production License

   Test-drive BoxLang Premium features in your own environment, no rush, no pressure. Explore advanced capabilities, experiment freely, and experience the benefits firsthand before making any commitments.

Request Info

---

Join the BoxLang Community

Stay connected with the latest updates, BoxLang announcements, Into the Box 2026 news, tutorials, tools, and more.

Subscribe to our newsletter for exclusive updates and early access.

Follow Us

• X: https://x.com/ortussolutions
• Facebook: https://www.facebook.com/OrtusSolutions
• LinkedIn: https://www.linkedin.com/company/ortus-solutions-corp
• YouTube: https://www.youtube.com/OrtusSolutions
• GitHub: https://github.com/Ortus-Solutions