As of Lucee 18.104.22.168, new Lucee builds will no longer bundle the (Lucee) Hibernate extension. This means that if you rely on Hibernate ORM in your CFML application, you will need to manually bundle the Hibernate extension into your Lucee server. Let's read on for more info.
First, let's start with the official note from the Lucee 22.214.171.124 Stable Release notes (courtesy of Zac Spitzer):
Lucee ORM is no longer being developed or bundled by the Lucee Team, Ortus have forked and taken over the development of ORM for Lucee, see Introducing: The Ortus ORM Extension.
It seems that Lucee has made the decision to 1) trim the Lucee installation size by no longer bundling the Hibernate extension with new Lucee installations, and to 2) halt further development on the Lucee Hibernate extension. It is unclear whether "no longer being developed" is referring to new features only, or whether that includes bug fixes and security patches as well.
This news means that Micha and the LAS team can focus on the Lucee server platform, bringing you speed and stability, while Ortus provides the Hibernate integration for a powerful database ORM layer.
Since Ortus Solutions has committed to ongoing support of the Hibernate extension, there is no concern for the future of Hibernate ORM on Lucee. The Ortus-maintained extension (termed "Ortus ORM extension") has had over 500 commits and 9 releases since forking, and the upcoming
7.0.0 release will upgrade to Hibernate 5.6. We're not going away!
While it is possible to continue using the Lucee Hibernate extension, we highly recommend switching to the Ortus ORM extension for speed improvements, security patches, and ongoing support.
As a quick example, take a look at the ORMReload times across the Lucee Hibernate and the Ortus ORM Extension. On the left are several versions of the Lucee Hibernate extension (
126.96.36.199-BETA), and on the right is the Ortus ORM Extension (version
6.1.0). You can see that the ORMReload time is over 50% faster using the Ortus ORM extension!
To install the Ortus ORM extension with CommandBox at
server start time, pass the
-Dlucee-extensions environment variable containing a list of extension IDs to install:
box server start email@example.com -Dlucee-extensions='D062D72F-F8A2-46F0-8CBC91325B2F067B;version=6.1.0'
Running this command
server start in CommandBox will start the Lucee server using the
lucee-extensions environment variable to configure any additional extensions beyond the default bundled ones. This environment variable will instruct Lucee to install the Ortus ORM extension v6.1.0 at startup. By the time your CFML code is executing, the extension will be fully installed and ready to go.
For a pre-built Lucee server isntance, you can opt to install the extension without restarting the server using CommandBox's
box install D062D72F-F8A2-46F0-8CBC91325B2F067B@6.1.0
This will install the extension to the Lucee server's
deploy/ directory, where it will be picked up (usually within 30 seconds) and installed into the running Lucee server.
To install the extension without assistance from CommandBox, append the extension ID (
D062D72F-F8A2-46F0-8CBC91325B2F067B ) to the
LUCEE_EXTENSIONS environment variable before starting the Lucee server. Exactly how you do these two steps will depend on your operating system and on the method you used to install Lucee server in the first place.
Alternately, you can browse to the Extension>Applications page in the Lucee Server Admin and click on the "Ortus ORM Extension" under "Not Installated". From there, you can choose and install versions at will.
See Lucee's "Extension Installation" documentation for more info.
The LAS team has long "carried the baton" in regards to Hibernate ORM. With that baton now passed firmly to Ortus Solutions, Hibernate in CFML is entering a new age of speed, stability, and ongoing support. For more information, you can check out the documentation, or our support page if you are looking for additional capabilities.