We are thrilled to announce the release of BoxLang 1.0.0-Beta 3! This latest beta version is packed with exciting new features and essential bug fixes, including robust encryption functionality, enhanced Java interoperability, and more efficient event handling. Key highlights include the introduction of query caching capabilities, seamless coercion of Java Single Abstract Method (SAM) interfaces from BoxLang functions, and support for virtual thread executors. So, let’s dive into the details of what’s new in BoxLang 1.0.0-Beta 3 and how you can start leveraging these updates today!
What is BoxLang?
BoxLang is a modern dynamic JVM language that can be deployed on multiple runtimes: operating system (Windows/Mac/*nix/Embedded), web server, lambda, iOS, android, web assembly, and more. BoxLang combines many features from different programming languages, including Java, ColdFusion, Python, Ruby, Go, and PHP, to provide developers with a modern and expressive syntax.
How to get started?
Visit our docs at https://boxlang.ortusbooks.com and get coding today. If you want to try it out on the web then go to our online REPL at https://try.boxlang.io
Release Notes
Here are the beta 3 release notes https://boxlang.ortusbooks.com/readme/release-history/1.0.0-beta3.
New Features
BL-256 Implement query cache ability
Thanks to our enterprise cache engine and aggregator built into BoxLang, you can now use it to cache queries via its options
configuration structure using cfquery
or queryExecute
. Here are the query caching properties you can use:
cache:boolean
- To turn on caching, this must betrue
. The default isfalse
cacheTimeout:timespan
- Optional timeout of the query in the cache. By default, is uses whatever the default timeout of items the cache has been configured with.cacheLastAcccessTimeout:timespan
- Optional last access or idle timeout of the query in the cache. By default, is uses whatever the default timeout of items the cache has been configured with. This means that if this query is NOT used or requested in this timespan, it will be marked for eviction.cacheProvider:string
- The name of the cache provider to store the queries. By default, we use theDEFAULT
cache in BoxLang.
queryExecute(
"SELECT * FROM developers WHERE role = ?",
[ "Developer" ],
{ cache: true }
);
By default, queries will use the default Boxlang CacheProvider, which has default timeouts and lastAccessTimeout
values set.
To specify a custom caching provider, you can use the cacheProvider
query option:
queryExecute(
"SELECT * FROM developers WHERE role = ?",
[ "Developer" ],
{ cache: true, cacheProvider : "redis" }
);
To specify custom cache entry timeouts, use cacheTimeout
or cacheLastAccessTimeout
:
queryExecute(
"SELECT * FROM developers WHERE role = ?",
[ "Developer" ],
{
cache: true,
cacheTimeout : createTimespan( 0, 0, 0, 30 ),
cacheLastAccessTimeout : createTimespan( 0, 0, 0, 30 )
}
);
{% hint style="warning" %}
Note that the bx-compat
module will take care of implementing the historical cachedWithin
and cachedAfter
query options.
{% endhint %}
Metadata
All query metadata will also have the cache information available to you as well. So you if get dump the query metadata you will see a ton of debugging information about the query:
writedump( myQuery.$bx.meta )
Interacting With The Cache
Please note that this leverages the BoxLang cache. This means you have full access to the cache provider and you can interrogate it for queries, clear all of them, or clear one of them. The default prefix used for all cached queries is: BL_QUERY
// Clear everything in the default cache
getBoxCache()
.clearAll()
// Clear only the cached queries
getBoxCache()
.clearAll( key-> key.getName().startsWith( "BL_QUERY" ) )
// Get a list of all cached queries
getBoxCache()
.getKeys( key-> key.getName().startsWith( "BL_QUERY" ) )
// Get a stream of all the cached queries
getBoxCache()
.getKeysStream( key-> key.getName().startsWith( "BL_QUERY" ) )
BL-261 coerce java SAMs from BoxLang function interfaces
This is another major milestone in the Java interop features of BoxLang. This allows us to coerce any BoxLang Lambda/Closure/UDF or even Classes to ANY, yes, ANY Java Functional Interface or Java SAM (Single Abstract Method Interface).
// Build your own Java comparators with BoxLang
Collections.sort(
myArray or Java Array,
(s1, s2) -> compareNoCase( s1, s2 )
)
// Create your own threads and completable futures
CompletableFuture.supplyAsync( () -> println( "Running in a thread" ) )
// Java predicates
arrayOfNumbers = [1,22,3,34,34,556]
arrayOfNumbers.stream()
.filter( n -> n % 2 == 0 )
.toList()
BL-281 AsyncService support for Virtual Thread Executors (create/manage)
Virtual Threads are now available to BoxLang via executors. You can choose the new VIRTUAL
executor for schedulers or when creating schedulers via our AsyncService. This will treat all tasks and schedules to use virtual threads.
// Create, register and return
getBoxRuntime().getAsyncService()
.newVirtualExecutor( "MyVirtualExecutor" )
More entry points to access this executor will be provided in the coming betas, alongside our very own runAsync()
and the ability to create virtual threads as well.
BL-284 Bifs for module info: getModuleList() getModuleInfo( module )
As more modules are being developed for BoxLang, you now have the ability to know which modules have been loaded and activated in the language. As well as specific information about a module if needed. This is great for inter-dependencies and checking if modules have loaded from BoxLang.
writedump( getModuleList() )
writeDump( getModuleInfo( "bx-image" ) )
BL-285 Dumping of Java Classes now includes a dump of the `toString()` value to visualize values better
This is a developer eye-candy, so when you dump any Java class, you can actually see the value of the class instance data via the toString()
method.
BL-289 New dump template for BL Functions
The dumping of BoxLang Functions (Closures, Lambdas, UDFs), either standalone or from a class, has great visibility now. You can see even the class used to generate the function, the function annotations, and much more.
BL-292 Allow the createDynamicProxy
bif to support the request class loader so it can load classes from loaded libraries in the application.bx, runtime and more.
If you use createDynamicProxy()
to make a BoxLang class look like a Java class, you can continue to do so now, but it accounts for all class loaders in the application. If you come from a CFML engine, this is impossible and is always a pain and limitation.
In BoxLang, your context matters. So depending on where you create the dynamic proxy, it will account for the surrounding class loaders to be able to create the appropriate Java proxies.
createDynamicProxy( myclass, [ array of interfaces ] )
createDynamicProxy( myclass, interface path )
BL-298 New Script Binaries for bxCFTranspiler
, bxCompiler
, bxFeatureAudit
tools in the distribution bin folder
We have introduced Windows and Mac/Linux binaries for running several CLI tools. You no longer need to refer to the docs with extra-long options. You can now use the provided binaries to call the appropriate CLI tool.
If you use the quick installer, all these binaries will be installed for you.
Improvements
BL-254 Refactor JDBC connection retrieval out of the QueryOptions class
BL-280 Dynamic method matching discovery algorithms updated to do 2 pass algorithm: exact, loose coercion matching
BL-283 Improvement of cache service and cache provider methods for easier boxlang interactions
BL-290 Refactored the dump css to `resources/dump/html/Dump.css`
BL-291 Migrate dynamic proxies to native java implementation from the JDK
BL-296 passing the session id to the onsessionstart listener
BL-297 Give better warnings if the sessionStorage is not a valid string
Bug
BL-198 attributecollection not handled properly on cfthrow
BL-278 Left in system out calls that need to be removed
BL-279 JSR ScriptEngine starting runtime without debug flag if passed
BL-282 Creating a default cache was not setting the right name and a "default" already registered exception was being thrown
BL-286 Default argument values not always checked for type
BL-287 Implements missing from Box Class metadata
BL-288 Static Scope missing from metadata
Add Your Comment