What's New in 5.3.1

Updated bundled Java libraries

  • JLine - 3.19.0
  • jGit - 5.11.0.202103091610-r
  • Launch4j - 3.14
  • JANSI - 2.3.2

Recursive jar scanning libDirs

When you configure libDirs for a server, CommandBox used to only load jar files found in the root. Now it will include sub directories which gives you more flexibility around how to install your jars.
1
# Jar installs to lib/jline-3.0.0.M1/jline-3.0.0.M1.jar
2
install "jar:https://search.maven.org/remotecontent?filepath=jline/jline/3.0.0.M1/jline-3.0.0.M1.jar"
3
4
# Load up the jar when the server starts
5
server set app.libDirs=lib
Copied!

New printTable Command

In the previous release, we introduced a new helper for printing ASCII Art tables in your custom commands and task runners. We've taken this a step further and wrapped the table printer utiilty in a new command so you can use it from the CLI directly. We've also expanded its functionality to accept ANY data in as JSON and it will marshall it into a query for you. This means it can be a query, an array of structs, an array or arrays, and more. You can now get quick and easy visualization of any data right from the CLI or in builds.
1
# array of structs
2
printTable [{a:1,b:2},{a:3,b:4},{a:5,b:6}]
3
4
╔═══╤═══╗
5
║ a │ b ║
6
╠═══╪═══╣
7
12
8
╟───┼───╢
9
34
10
╟───┼───╢
11
56
12
╚═══╧═══╝
13
14
# array of arrays
15
printTable data=[[1,2],[3,4],[5,6]] headerNames=foo,bar
16
17
╔═════╤═════╗
18
║ foo │ bar ║
19
╠═════╪═════╣
20
12
21
╟─────┼─────╢
22
34
23
╟─────┼─────╢
24
56
25
╚═════╧═════╝
26
27
# Query object
28
#extensionlist | printTable name,version
29
30
╔═════════════════════════════════════════╤═══════════════════╗
31
║ name │ version ║
32
╠═════════════════════════════════════════╪═══════════════════╣
33
║ MySQL │ 8.0.19 ║
34
╟─────────────────────────────────────────┼───────────────────╢
35
║ Microsoft SQL Server (Vendor Microsoft)6.5.4 ║
36
╟─────────────────────────────────────────┼───────────────────╢
37
║ PostgreSQL │ 9.4.1212 ║
38
╟─────────────────────────────────────────┼───────────────────╢
39
║ Ajax Extension │ 1.0.0.3 ║
40
╚═════════════════════════════════════════╧═══════════════════╝
41
42
# JSON list of all servers
43
server list --json | printTable name,host,port,status
44
45
╔══════════════════════════════╤═════════════════════════════╤═══════╤═════════╗
46
║ name │ host │ port │ status ║
47
╠══════════════════════════════╪═════════════════════════════╪═══════╪═════════╣
48
║ servicetest │ 127.0.0.1 │ 54427 │ stopped ║
49
╟──────────────────────────────┼─────────────────────────────┼───────┼─────────╢
50
║ servicetest2 │ 127.0.0.1 │ 52919 │ stopped ║
51
╟──────────────────────────────┼─────────────────────────────┼───────┼─────────╢
52
║ FRDemos │ 127.0.0.1 │ 50458 │ stopped ║
53
╚══════════════════════════════╧═════════════════════════════╧═══════╧═════════╝
Copied!

New sql command for on-the-fly manipulation of data

As if the previous command isn't cool enough, we've also added a new "sql" command which will also accept any sort of data as JSON, marshall it into a query object and allow you to alias, filter, order, and limit the rows on the fly using CFML's query of queries!
1
# filter, sort, limit, and select extensions installed into the CLI (output as table)
2
#extensionlist | sql select=id,name where="name like '%sql%'" orderby=name limit=3 | printTable
3
4
# order and select JSON data from a file (output as JSON)
5
cat myfile.json | sql select=col1,col2 orderby=col2
6
7
# limit JSON (output as table)
8
sql data=[{a:1,b:2},{a:3,b:4},{a:5,b:6}] where="a > 1" | printTable
9
Copied!
The sql command works very nicely with the new tablePrinter command, and truly makes JSON a first class citizen of the CommandBox CLI.

Small change to print.table() helper

We've made a small adjustment to the print.table() helper that was introduced in CommandBox 5.3.1 as follows. The old method signature is
1
public string function print(
2
required any headers,
3
array data=[],
4
string includeHeaders
5
) {
Copied!
And the new method signature is:
1
public string function print(
2
required any data=[],
3
any includedHeaders="",
4
any headerNames="",
5
boolean debug=false
6
) {
Copied!
The parameters to the new printTable command matches the NEW method signature of the print.table() helper as well.

Format XML in REPL

When working with XML in the REPL, formatting is now applied when the XML is printed out to the console, making it easier to read (same as JSON)
1
❯ repl "XMLParse( '<root><brad>wood</brad></root>' )"
2
3
<?xml version="1.0" encoding="utf-8"?><root>
4
<brad>wood</brad>
5
</root>
Copied!

Release Notes

Bug

COMMANDBOX-1320 Server stop doesn't message user when it fails
COMMANDBOX-1319 Stop loading cfusion/lib in system class loader
COMMANDBOX-1318 5.3.0 errors with commandbox-dotenv 1.x versions due to WireBox change
COMMANDBOX-1314 When building Lucee war from local jars, seeded web.xml file is ignored
COMMANDBOX-1311 Table printer error with no rows
COMMANDBOX-1310 update '{slug}' fails as it is trying to print the package version and its dependencies.
COMMANDBOX-1308 Relative Web Alias Behavior (regression)
COMMANDBOX-1307 jq doesn't resolve file paths to current working directory
COMMANDBOX-1303 CFEngine adobe - Could not initialize class coldfusion.vfs.VFile when using s3 protocol

Improvement

COMMANDBOX-1328 Improve performance of piping large strings to "cfml" command
COMMANDBOX-1317 Format XML in REPL
COMMANDBOX-1316 Change default CLI JSON representation of query to array of structs
COMMANDBOX-1306 Allow upgrade command to pull stable versions when CLI is a prerelease version
COMMANDBOX-1305 Update bundled java libraries
COMMANDBOX-1302 app.libDirs does not load jars/classes recursively from sub folders
COMMANDBOX-1210 Allow for relative URLs when defining trayoption elements
COMMANDBOX-1194 Add Libraries To Runwar Necessary For URLRewrite Proxy

New Feature

COMMANDBOX-1324 New "printTable" command to add CLI usage of table printer
COMMANDBOX-1323 New "sql" command to filter tabular data with SQL
COMMANDBOX-1321 Add --verbose to 'server stop' to see raw output
COMMANDBOX-1309 Add printTable command that proxies to print.table() helper