NuoDB Hibernate Driver
Overview
NuoDB provides explicit support for Java applications using Hibernate object-relational mapping:
-
A NuoDB specific dialect for mapping to NuoDB specific SQL.
-
Custom
Driver
andConnection
classes, specifically designed for Hibernate.-
Allow NuoDB to throw appropriate Hibernate exceptions related to connection errors.
-
-
Packaged in
nuodb-hibernate-XXX.jar
.
However, we recommend that your applications use JPA (the Jakarta Persistence API, formerly Java Persistence API) rather than Hibernate directly.
Our Hibernate 5 drivers released before Jan 2021 had a direct dependency on Hibernate in order to throw the appropriate Hibernate exceptions.
From |
This documentation is not meant to be a full Reference or Programming manual for Hibernate. It helps you get started with Hibernate and NuoDB.
Requirements
NuoDB supports both Hibernate 5 and Hibernate 6 but, because JPA 3 is a breaking change, requires different JARs to do so — see versions below.
- Hibernate 5 JAR
-
Requires Java 11 or 17, NuoDB 4.2 or later, and is compatible with JPA 2.1, JEE 7 or 8, Spring 5 and Spring Boot 2.
- Hibernate 6 JAR
-
Requires Java 11 or 17, NuoDB 5.0.2 or later, and is compatible with JPA 3.1, JEE 9+, Spring 6 and Spring Boot 3.
To use Spring with Hibernate 6 you need Spring 6 and/or Spring Boot 3 which, in turn, require Java 17.
For more on Java requirements, see System Requirements.
A NuoDB JDBC driver must be installed in addition to the NuoDB Hibernate JAR.
Installation and Versions
The Hibernate and JDBC JARs are published via Sonatype to Maven Central so that you can declare a dependency in your Gradle, Ivy or Maven build files. For the Maven URL required to download JAR files, see NuoDB Drivers Available at Other Public Sites.
-
NuoDB Hibernate JAR
20.0.2-hib5
supports Hibernate 5.3 and JPA 2.1 -
NuoDB Hibernate JAR
21.0.0-hib5
supports Hibernate from 5.3 or 5.4 and JPA 2.1. -
NuoDB Hibernate JAR
22.0.0-hib5
and later supports Hibernate from 5.3 to 5.6. Hibernate 5.5 and later supports JPA 2.2. -
None of the above NuoDB Hibernate JARs work with Hibernate 6.x due to all the JPA 3 package changes.
-
NuoDB Hibernate JAR
23.0.0-hib6
and later supports Hibernate 6.1 and JPA 3.1
|
Hibernate Dependencies
<!-- Maven POM -->
<dependency>
<groupId>com.nuodb.hibernate</groupId>
<artifactId>nuodb-hibernate</artifactId>
<version>xxx-hib5</version>
</dependency>
<dependency>
<groupId>com.nuodb.jdbc</groupId>
<artifactId>nuodb-jdbc</artifactId>
<version>yyy</version>
</dependency>
<!-- Gradle Build -->
compile group: 'com.nuodb.hibernate', name: 'nuodb-hibernate', version: 'xxx-hib5'
compile group: 'com.nuodb.jdbc', name: 'nuodb-jdbc', version: 'yyy'
<!-- Ivy XML -->
<dependency org="com.nuodb.hibernate" name="nuodb-hibernate" rev="xxx-hib5"/>
<dependency org="com.nuodb.jdbc" name="nuodb-jdbc" rev="yyy"/>
where:
-
xxx-hib5
is the NuoDB Hibernate 5 JAR version andyyy
is the NuoDB JDBC JAR version. -
For the Hibernate 6 JAR, replace
-hib5
with-hib6
. -
The version numbers
xxx-hib5
andxxx-hib6
are subject to change.-
For all releases of our Hibernate JAR, visit our Maven Repository.
-