From e4a7d04befe9af3cd1a753ce774f8a23f3a2e1ff Mon Sep 17 00:00:00 2001 From: Tran Ngoc Nhan Date: Sun, 11 Jan 2026 18:50:08 +0700 Subject: [PATCH] Fix a/an in Javadoc Signed-off-by: Tran Ngoc Nhan --- .../data/jdbc/core/convert/FunctionCollector.java | 2 +- .../data/r2dbc/core/ReactiveSelectOperation.java | 4 ++-- .../org/springframework/data/r2dbc/core/StatementMapper.java | 4 ++-- .../data/relational/core/conversion/DbAction.java | 4 ++-- .../springframework/data/relational/core/sql/Comparison.java | 2 +- .../springframework/data/relational/core/sql/InlineQuery.java | 2 +- .../data/relational/core/sql/render/NamingStrategies.java | 2 +- src/main/antora/modules/ROOT/pages/jdbc/events.adoc | 4 ++-- 8 files changed, 12 insertions(+), 12 deletions(-) diff --git a/spring-data-jdbc/src/main/java/org/springframework/data/jdbc/core/convert/FunctionCollector.java b/spring-data-jdbc/src/main/java/org/springframework/data/jdbc/core/convert/FunctionCollector.java index 86ae14d82..6a5cc7146 100644 --- a/spring-data-jdbc/src/main/java/org/springframework/data/jdbc/core/convert/FunctionCollector.java +++ b/spring-data-jdbc/src/main/java/org/springframework/data/jdbc/core/convert/FunctionCollector.java @@ -92,7 +92,7 @@ class FunctionCollector implements Collector { diff --git a/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/ReactiveSelectOperation.java b/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/ReactiveSelectOperation.java index ea9d3045f..fbcec239a 100644 --- a/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/ReactiveSelectOperation.java +++ b/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/ReactiveSelectOperation.java @@ -27,7 +27,7 @@ import org.springframework.data.relational.core.sql.SqlIdentifier; *

* The starting {@literal domainType} is used for mapping the {@link Query} provided via {@code matching}. By default, * the originating {@literal domainType} is also used for mapping back the result from the {@link io.r2dbc.spi.Row}. - * However, it is possible to define an different {@literal returnType} via {@code as} to mapping the result. + * However, it is possible to define a different {@literal returnType} via {@code as} to mapping the result. *

* By default, the table to operate on is derived from the initial {@literal domainType} and can be defined there via * the {@link org.springframework.data.relational.core.mapping.Table} annotation. Using {@code inTable} allows to @@ -120,7 +120,7 @@ public interface ReactiveSelectOperation { /** * Specifies the fetch size for this query. * - * @param fetchSize + * @param fetchSize the fetch size * @return new instance of {@link SelectWithQuery}. * @since 3.4 * @see io.r2dbc.spi.Statement#fetchSize(int) diff --git a/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/StatementMapper.java b/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/StatementMapper.java index 714999a49..9e9861f9b 100644 --- a/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/StatementMapper.java +++ b/spring-data-r2dbc/src/main/java/org/springframework/data/r2dbc/core/StatementMapper.java @@ -92,7 +92,7 @@ public interface StatementMapper { PreparedOperation getMappedObject(SelectSpec selectSpec); /** - * Map a insert specification to a {@link PreparedOperation}. + * Map an insert specification to a {@link PreparedOperation}. * * @param insertSpec the insert operation definition, must not be {@literal null}. * @return the {@link PreparedOperation} for {@link InsertSpec}. @@ -100,7 +100,7 @@ public interface StatementMapper { PreparedOperation getMappedObject(InsertSpec insertSpec); /** - * Map a update specification to a {@link PreparedOperation}. + * Map an update specification to a {@link PreparedOperation}. * * @param updateSpec the update operation definition, must not be {@literal null}. * @return the {@link PreparedOperation} for {@link UpdateSpec}. diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/conversion/DbAction.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/conversion/DbAction.java index aa50eb78f..3aa67cf7e 100644 --- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/conversion/DbAction.java +++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/conversion/DbAction.java @@ -169,7 +169,7 @@ public interface DbAction { } /** - * Represents a delete statement for a aggregate root when only the ID is known. + * Represents a delete statement for an aggregate root when only the ID is known. *

* Note that deletes for contained entities that reference the root are to be represented by separate * {@link DbAction}s. @@ -220,7 +220,7 @@ public interface DbAction { } /** - * Represents an acquire lock statement for a aggregate root when only the ID is known. + * Represents an acquire lock statement for an aggregate root when only the ID is known. * * @param type of the entity for which this represents a database interaction. */ diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/Comparison.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/Comparison.java index 04383eb9e..217db37d1 100644 --- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/Comparison.java +++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/Comparison.java @@ -64,7 +64,7 @@ public class Comparison extends AbstractSegment implements Condition { * Creates a new {@link Comparison} from simple {@literal StringP} arguments * * @param unqualifiedColumnName gets turned in a {@link Expressions#just(String)} and is expected to be an unqualified - * unique column name but also could be an verbatim expression. Must not be {@literal null}. + * unique column name but also could be a verbatim expression. Must not be {@literal null}. * @param comparator must not be {@literal null}. * @param rightValue is considered a {@link Literal}. Must not be {@literal null}. * @return a new {@literal Comparison} of the first with the third argument using the second argument as comparison diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/InlineQuery.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/InlineQuery.java index 3c3c5e730..e0450c1a2 100644 --- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/InlineQuery.java +++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/InlineQuery.java @@ -18,7 +18,7 @@ package org.springframework.data.relational.core.sql; import org.springframework.util.Assert; /** - * Represents a inline query within a SQL statement. Typically, used in {@code FROM} or {@code JOIN} clauses. + * Represents an inline query within a SQL statement. Typically, used in {@code FROM} or {@code JOIN} clauses. *

* Renders to: {@code (>SELECT<) AS >ALIAS<} in a from or join clause, and to {@code >ALIAS<} when * used in an expression. diff --git a/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/render/NamingStrategies.java b/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/render/NamingStrategies.java index 9676b4d95..89814ecab 100644 --- a/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/render/NamingStrategies.java +++ b/spring-data-relational/src/main/java/org/springframework/data/relational/core/sql/render/NamingStrategies.java @@ -35,7 +35,7 @@ public abstract class NamingStrategies { private NamingStrategies() {} /** - * Creates a as-is {@link RenderNamingStrategy} that preserves {@link Column} and {@link Table} names as they were + * Creates an as-is {@link RenderNamingStrategy} that preserves {@link Column} and {@link Table} names as they were * expressed during their declaration. * * @return as-is {@link RenderNamingStrategy}. diff --git a/src/main/antora/modules/ROOT/pages/jdbc/events.adoc b/src/main/antora/modules/ROOT/pages/jdbc/events.adoc index a97d6a9e2..3dded6e99 100644 --- a/src/main/antora/modules/ROOT/pages/jdbc/events.adoc +++ b/src/main/antora/modules/ROOT/pages/jdbc/events.adoc @@ -88,9 +88,9 @@ Spring Data JDBC uses the xref:commons/entity-callbacks.adoc[`EntityCallback` AP .6+| Save 2+| Determine if an insert or an update of the aggregate is to be performed dependent on if it is new or not. | javadoc:org.springframework.data.relational.core.mapping.event.BeforeConvertCallback[] -| This is the correct callback if you want to set an id programmatically. In the previous step new aggregates got detected as such and a Id generated in this step would be used in the following step. +| This is the correct callback if you want to set an id programmatically. In the previous step new aggregates got detected as such and an Id generated in this step would be used in the following step. -2+| Convert the aggregate to a aggregate change, it is a sequence of SQL statements to be executed against the database. In this step the decision is made if an Id is provided by the aggregate or if the Id is still empty and is expected to be generated by the database. +2+| Convert the aggregate to an aggregate change, it is a sequence of SQL statements to be executed against the database. In this step the decision is made if an Id is provided by the aggregate or if the Id is still empty and is expected to be generated by the database. | javadoc:org.springframework.data.relational.core.mapping.event.BeforeSaveCallback[] | Changes made to the aggregate root may get considered, but the decision if an id value will be sent to the database is already made in the previous step.