diff --git a/docs/mp/persistence.adoc b/docs/mp/persistence.adoc index 705c62f995b..44a8dffb954 100644 --- a/docs/mp/persistence.adoc +++ b/docs/mp/persistence.adoc @@ -94,8 +94,8 @@ How you set up Helidon MP's named data source integration differs depending on which of these two connection pools, which JDBC driver, and which relational database product you use. -Representative setups are described below. The list of such setups is -not exhaustive. +Representative setups are described below. This list of setups is not +exhaustive. === Project Setup [[DS-Setup]] @@ -171,10 +171,10 @@ managed] ===== Overview -Regardless of which connection pool you use, at the lowest level JDBC -database driver classes are responsible for making any connections to -a relational database. JDBC database driver classes are -database-product-specific. +Regardless of which connection pool you use, at the lowest level, JDBC +database driver classes are what is ultimately responsible for making +any connections to a relational database. JDBC database driver +classes are database-product-specific. Once you have decided upon a relational database product to use, and JDBC driver classes to use to connect to it, @@ -187,8 +187,8 @@ See the link:{jdk-javadoc-url}/java.sql/java/sql/package-summary.html[JDBC 4.3 Specification] for more information about JDBC. -Representative setups are described below. The list of such setups is -not exhaustive. +Representative setups are described below. This list of setups is not +exhaustive. ===== Setting Up H2 [[DS-H2-Driver-Project-Setup]] @@ -296,8 +296,8 @@ typically supply: * Information required for the vendor-supplied `DataSource` to authenticate to the database and otherwise tailor itself to it -Some examples for representative configurations follow. The list of -such configurations is not exhaustive. +Some examples for representative configurations follow. This list of +configurations is not exhaustive. ==== Configuration Prefixes [[DS-Configuration-Prefixes]] @@ -857,8 +857,9 @@ details below for the JPA provider you have chosen to use. To generate and compile the Jakarta Persistence static metamodel for your application, regardless of whether you are using Hibernate ORM or -Eclipselink, make sure the `` element in the following code -snippet is present as a child element of the +Eclipselink, xref:../about/managing-dependencies.adoc[ensure your +dependencies are managed], and then make sure the `` element +in the following code snippet is present as a child element of the `` element sequence as shown below: [source,xml] @@ -878,7 +879,7 @@ snippet is present as a child element of the org.hibernate.orm hibernate-jpamodelgen - 6.1.1.Final + ${version.lib.hibernate} @@ -896,10 +897,9 @@ snippet is present as a child element of the annotation processor that generates the static metamodel source code], to the Java compiler's annotation processor path so that it is active at compile time. -<2> Always check - https://search.maven.org/artifact/org.hibernate.orm/hibernate-jpamodelgen[Maven - Central] for up to date versions and make sure the version used is - that of Hibernate ORM itself. +<2> Because your xref:../about/managing-dependencies.adoc[dependencies + are managed], this will resolve to the currently supported version + of Hibernate ORM. For more on the Hibernate ORM `hibernate-jpamodelgen` annotation processor, see @@ -959,7 +959,7 @@ project's `pom.xml` file's `` element: for up-to-date versions, and make sure the version is the same as that of Hibernate ORM itself. --> - + Statically enhance JPA entities for Hibernate @@ -977,20 +977,6 @@ project's `pom.xml` file's `` element: ---- -You must also -https://docs.jboss.org/hibernate/orm/6.1/userguide/html_single/Hibernate_User_Guide.html#appendix-legacy-bootstrap:~:text=Place%20a%20file%20named%20hibernate.properties%20in%20a%20root%20directory%20of%20the%20classpath[add -a file named `src/main/resources/META-INF/hibernate.properties`] with -the following line as its sole contents: - -.`src/main/resources/META-INF/hibernate.properties` -[source,properties] ----- -hibernate.bytecode.provider=none # <1> ----- -<1> The value of `none` instructs Hibernate ORM to - link:{hibernate-javadoc-base-url}/org/hibernate/cfg/Environment.html#BYTECODE_PROVIDER_NAME_NONE[not - attempt to perform weaving at runtime]. - For more on the `hibernate-enhance-maven-plugin` in particular, see link:{hibernate-doc-jboss-url}/userguide/html_single/Hibernate_User_Guide.html#tooling-maven[its documentation]. @@ -1144,8 +1130,8 @@ Your `META-INF/persistence.xml` file must begin + https://jakarta.ee/xml/ns/persistence/persistence_3_1.xsd" + version="3.1"> @@ -1153,7 +1139,7 @@ Your `META-INF/persistence.xml` file must begin ---- <1> Helidon MP's Jakarta Persistence integration supports link:{jakarta-persistence-base-url}/[Jakarta Persistence version - 3.0]. + 3.1]. <2> ` elements are listed here. ==== Persistence Unit @@ -1363,7 +1349,8 @@ Property Extensions Reference] in the Eclipselink documentation. To use Helidon MP's Jakarta Persistence integration, once you have <> and <> your project, you use the Jakarta Persistence APIs in almost the same -manner as if your project were deployed to a Jakarta EE server. +manner as if your project were deployed to a Jakarta EE application +server. Specifically, you: