HHH-17775 Standardize spelling of "round-trip" and "roundtrip" to "round

trip"
This commit is contained in:
Jeff Maxwell 2024-02-23 13:22:05 -06:00 committed by Christian Beikov
parent c1746f5f82
commit 12a93ce328
7 changed files with 9 additions and 9 deletions

View File

@ -59,7 +59,7 @@ While simple statement logging is fine, using https://github.com/ttddyy/datasour
=== JDBC batching === JDBC batching
JDBC allows us to batch multiple SQL statements and to send them to the database server into a single request. JDBC allows us to batch multiple SQL statements and to send them to the database server into a single request.
This saves database roundtrips, and so it https://leanpub.com/high-performance-java-persistence/read#jdbc-batch-updates[reduces response time significantly]. This saves database round trips, and so it https://leanpub.com/high-performance-java-persistence/read#jdbc-batch-updates[reduces response time significantly].
Not only `INSERT` and `UPDATE` statements, but even `DELETE` statements can be batched as well. Not only `INSERT` and `UPDATE` statements, but even `DELETE` statements can be batched as well.
For `INSERT` and `UPDATE` statements, make sure that you have all the right configuration properties in place, like ordering inserts and updates and activating batching for versioned data. For `INSERT` and `UPDATE` statements, make sure that you have all the right configuration properties in place, like ordering inserts and updates and activating batching for versioned data.
@ -101,7 +101,7 @@ However, you should keep in mind that the `IDENTITY` generators disables JDBC ba
==== ====
If you're using the `SEQUENCE` generator, then you should be using the enhanced identifier generators that were enabled by default in Hibernate 5. If you're using the `SEQUENCE` generator, then you should be using the enhanced identifier generators that were enabled by default in Hibernate 5.
The *pooled* and the *pooled-lo* optimizers are very useful to reduce the number of database roundtrips when writing multiple entities per database transaction. The *pooled* and the *pooled-lo* optimizers are very useful to reduce the number of database round trips when writing multiple entities per database transaction.
[[best-practices-mapping-associations]] [[best-practices-mapping-associations]]
==== Associations ==== Associations

View File

@ -72,7 +72,7 @@ There are several problems associated with this example:
If the maximum memory allocated to the JVM is rather low, this example could fail with an `OutOfMemoryException`. If the maximum memory allocated to the JVM is rather low, this example could fail with an `OutOfMemoryException`.
The Java 1.8 JVM allocated either 1/4 of available RAM or 1Gb, which can easily accommodate 100 000 objects on the heap. The Java 1.8 JVM allocated either 1/4 of available RAM or 1Gb, which can easily accommodate 100 000 objects on the heap.
. long-running transactions can deplete a connection pool so other transactions don't get a chance to proceed. . long-running transactions can deplete a connection pool so other transactions don't get a chance to proceed.
. JDBC batching is not enabled by default, so every insert statement requires a database roundtrip. . JDBC batching is not enabled by default, so every insert statement requires a database round trip.
To enable JDBC batching, set the `hibernate.jdbc.batch_size` property to an integer between 10 and 50. To enable JDBC batching, set the `hibernate.jdbc.batch_size` property to an integer between 10 and 50.
[IMPORTANT] [IMPORTANT]

View File

@ -635,7 +635,7 @@ include::{extrasdir}/id/identifiers-generators-pooled-lo-optimizer-persist-examp
==== ====
As you can see from the list of generated SQL statements, you can insert 3 entities with just one database sequence call. As you can see from the list of generated SQL statements, you can insert 3 entities with just one database sequence call.
This way, the pooled and the pooled-lo optimizers allow you to reduce the number of database roundtrips, therefore reducing the overall transaction response time. This way, the pooled and the pooled-lo optimizers allow you to reduce the number of database round trips, therefore reducing the overall transaction response time.
[[identifiers-derived]] [[identifiers-derived]]
==== Derived Identifiers ==== Derived Identifiers

View File

@ -427,7 +427,7 @@ include::{example-dir-fetching}/BatchFetchingTest.java[tags=fetching-batch-mappi
Considering that we have previously fetched several `Department` entities, Considering that we have previously fetched several `Department` entities,
and now we need to initialize the `employees` entity collection for each particular `Department`, and now we need to initialize the `employees` entity collection for each particular `Department`,
the `@BatchSize` annotations allows us to load multiple `Employee` entities in a single database roundtrip. the `@BatchSize` annotations allows us to load multiple `Employee` entities in a single database round trip.
[[fetching-batch-fetching-example]] [[fetching-batch-fetching-example]]
.`@BatchSize` fetching example .`@BatchSize` fetching example

View File

@ -164,7 +164,7 @@ include::{doc-emeddable-example-dir}/SQLTest.java[tags=sql-hibernate-entity-asso
This will allow the `Phone#person` to function properly since the `many-to-one` or `one-to-one` This will allow the `Phone#person` to function properly since the `many-to-one` or `one-to-one`
association is going to use a proxy that will be initialized when being navigated for the first time. association is going to use a proxy that will be initialized when being navigated for the first time.
It is possible to eagerly join the `Phone` and the `Person` entities to avoid the possible extra roundtrip for initializing the `many-to-one` association. It is possible to eagerly join the `Phone` and the `Person` entities to avoid the possible extra round trip for initializing the `many-to-one` association.
[[sql-hibernate-entity-associations-query-many-to-one-join-example]] [[sql-hibernate-entity-associations-query-many-to-one-join-example]]
.Hibernate native query selecting entities with joined many-to-one association .Hibernate native query selecting entities with joined many-to-one association
@ -182,7 +182,7 @@ include::{extrasdir}/sql-hibernate-entity-associations-query-many-to-one-join-ex
[NOTE] [NOTE]
==== ====
As seen in the associated SQL query, Hibernate manages to construct the entity hierarchy without requiring any extra database roundtrip. As seen in the associated SQL query, Hibernate manages to construct the entity hierarchy without requiring any extra database round trips.
==== ====
Even when using the `addJoin()` method, the result list will only contain the root entity. Even when using the `addJoin()` method, the result list will only contain the root entity.

View File

@ -19,7 +19,7 @@ import static java.lang.annotation.RetentionPolicy.RUNTIME;
* entity or collection. * entity or collection.
* <p> * <p>
* When batch fetching is enabled, Hibernate is able to fetch multiple * When batch fetching is enabled, Hibernate is able to fetch multiple
* instances of an entity or collection in a single round-trip to the * instances of an entity or collection in a single round trip to the
* database. Instead of a SQL {@code select} with just one primary key * database. Instead of a SQL {@code select} with just one primary key
* value in the {@code where} clause, the {@code where} clause contains * value in the {@code where} clause, the {@code where} clause contains
* a list of primary keys inside a SQL {@code in} condition. The primary * a list of primary keys inside a SQL {@code in} condition. The primary

View File

@ -11,7 +11,7 @@ import java.io.Serializable;
import org.hibernate.id.IntegralDataTypeHolder; import org.hibernate.id.IntegralDataTypeHolder;
/** /**
* An optimizer that performs no optimization. A round-trip to * An optimizer that performs no optimization. A round trip to
* the database is required for each new id. * the database is required for each new id.
* <p> * <p>
* This implementation is not the most efficient one. * This implementation is not the most efficient one.