diff --git a/src/main/java/org/springframework/data/r2dbc/config/AbstractR2dbcConfiguration.java b/src/main/java/org/springframework/data/r2dbc/config/AbstractR2dbcConfiguration.java index 3e12275..a6d293d 100644 --- a/src/main/java/org/springframework/data/r2dbc/config/AbstractR2dbcConfiguration.java +++ b/src/main/java/org/springframework/data/r2dbc/config/AbstractR2dbcConfiguration.java @@ -148,7 +148,7 @@ public abstract class AbstractR2dbcConfiguration implements ApplicationContextAw /** * Creates a {@link ReactiveDataAccessStrategy} using the configured - * {@link #r2dbcConverter(Optional, R2dbcCustomConversions)} R2dbcConverter}. + * {@link #r2dbcConverter(R2dbcMappingContext, R2dbcCustomConversions) R2dbcConverter}. * * @param converter the configured {@link R2dbcConverter}. * @return must not be {@literal null}. diff --git a/src/main/java/org/springframework/data/r2dbc/connectionfactory/ConnectionProxy.java b/src/main/java/org/springframework/data/r2dbc/connectionfactory/ConnectionProxy.java index 3807fc7..badec65 100644 --- a/src/main/java/org/springframework/data/r2dbc/connectionfactory/ConnectionProxy.java +++ b/src/main/java/org/springframework/data/r2dbc/connectionfactory/ConnectionProxy.java @@ -21,7 +21,7 @@ import io.r2dbc.spi.Wrapped; /** * Sub interface of {@link Connection} to be implemented by Connection proxies. Allows access to the underlying target * Connection. - *

+ *

* This interface can be checked when there is a need to cast to a native R2DBC {@link Connection}. * * @author Mark Paluch @@ -33,7 +33,7 @@ public interface ConnectionProxy extends Connection, Wrapped { /** * Return the target {@link Connection} of this proxy. - *

+ *

* This will typically be the native driver {@link Connection} or a wrapper from a connection pool. * * @return the underlying Connection (never {@literal null}) diff --git a/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ConnectionFactoryInitializer.java b/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ConnectionFactoryInitializer.java index 747d387..6aef6bd 100644 --- a/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ConnectionFactoryInitializer.java +++ b/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ConnectionFactoryInitializer.java @@ -45,7 +45,7 @@ public class ConnectionFactoryInitializer implements InitializingBean, Disposabl /** * The {@link ConnectionFactory} for the database to populate when this component is initialized and to clean up when * this component is shut down. - *

+ *

* This property is mandatory with no default provided. * * @param connectionFactory the R2DBC {@link ConnectionFactory}. diff --git a/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ResourceDatabasePopulator.java b/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ResourceDatabasePopulator.java index cc4f5bb..9947bbf 100644 --- a/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ResourceDatabasePopulator.java +++ b/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ResourceDatabasePopulator.java @@ -160,7 +160,7 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Specify the statement separator, if a custom one. - *

+ *

* Defaults to {@code ";"} if not specified and falls back to {@code "\n"} as a last resort; may be set to * {@link ScriptUtils#EOF_STATEMENT_SEPARATOR} to signal that each script contains a single statement without a * separator. @@ -173,7 +173,7 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Set the prefix that identifies single-line comments within the SQL scripts. - *

+ *

* Defaults to {@code "--"}. * * @param commentPrefix the prefix for single-line comments @@ -184,7 +184,7 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Set the start delimiter that identifies block comments within the SQL scripts. - *

+ *

* Defaults to {@code "/*"}. * * @param blockCommentStartDelimiter the start delimiter for block comments (never {@literal null} or empty). @@ -199,7 +199,7 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Set the end delimiter that identifies block comments within the SQL scripts. - *

+ *

* Defaults to {@code "*/"}. * * @param blockCommentEndDelimiter the end delimiter for block comments (never {@literal null} or empty) @@ -214,7 +214,7 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Flag to indicate that all failures in SQL should be logged but not cause a failure. - *

+ *

* Defaults to {@literal false}. * * @param continueOnError {@literal true} if script execution should continue on error. @@ -225,10 +225,10 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Flag to indicate that a failed SQL {@code DROP} statement can be ignored. - *

+ *

* This is useful for a non-embedded database whose SQL dialect does not support an {@code IF EXISTS} clause in a * {@code DROP} statement. - *

+ *

* The default is {@literal false} so that if the populator runs accidentally, it will fail fast if a script starts * with a {@code DROP} statement. * @@ -240,7 +240,7 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Set the {@link DataBufferFactory} to use for {@link Resource} loading. - *

+ *

* Defaults to {@link DefaultDataBufferFactory}. * * @param dataBufferFactory the {@link DataBufferFactory} to use, must not be {@literal null}. @@ -269,7 +269,7 @@ public class ResourceDatabasePopulator implements DatabasePopulator { /** * Execute this {@link ResourceDatabasePopulator} against the given {@link ConnectionFactory}. - *

+ *

* Delegates to {@link DatabasePopulatorUtils#execute}. * * @param connectionFactory the {@link ConnectionFactory} to execute against, must not be {@literal null}.. diff --git a/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ScriptUtils.java b/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ScriptUtils.java index 979a232..5bb07bf 100644 --- a/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ScriptUtils.java +++ b/src/main/java/org/springframework/data/r2dbc/connectionfactory/init/ScriptUtils.java @@ -44,7 +44,7 @@ import org.springframework.util.StringUtils; /** * Generic utility methods for working with SQL scripts. - *

+ *

* Mainly for internal use within the framework. * * @author Mark Paluch @@ -61,14 +61,14 @@ public abstract class ScriptUtils { /** * Fallback statement separator within SQL scripts: {@code "\n"}. - *

+ *

* Used if neither a custom separator nor the {@link #DEFAULT_STATEMENT_SEPARATOR} is present in a given script. */ public static final String FALLBACK_STATEMENT_SEPARATOR = "\n"; /** * End of file (EOF) SQL statement separator: {@code "^^^ END OF SCRIPT ^^^"}. - *

+ *

* This value may be supplied as the {@code separator} to * {@link #executeSqlScript(Connection, EncodedResource, DataBufferFactory, boolean, boolean, String, String, String, String)} * to denote that an SQL script contains a single statement (potentially spanning multiple lines) with no explicit @@ -100,7 +100,7 @@ public abstract class ScriptUtils { /** * Split an SQL script into separate statements delimited by the provided separator character. Each individual * statement will be added to the provided {@link List}. - *

+ *

* Within the script, {@value #DEFAULT_COMMENT_PREFIX} will be used as the comment prefix; any text beginning with the * comment prefix and extending to the end of the line will be omitted from the output. Similarly, * {@value #DEFAULT_BLOCK_COMMENT_START_DELIMITER} and {@value #DEFAULT_BLOCK_COMMENT_END_DELIMITER} will be used as @@ -121,7 +121,7 @@ public abstract class ScriptUtils { /** * Split an SQL script into separate statements delimited by the provided separator string. Each individual statement * will be added to the provided {@link List}. - *

+ *

* Within the script, {@value #DEFAULT_COMMENT_PREFIX} will be used as the comment prefix; any text beginning with the * comment prefix and extending to the end of the line will be omitted from the output. Similarly, * {@value #DEFAULT_BLOCK_COMMENT_START_DELIMITER} and {@value #DEFAULT_BLOCK_COMMENT_END_DELIMITER} will be used as @@ -143,7 +143,7 @@ public abstract class ScriptUtils { /** * Split an SQL script into separate statements delimited by the provided separator string. Each individual statement * will be added to the provided {@link List}. - *

+ *

* Within the script, the provided {@code commentPrefix} will be honored: any text beginning with the comment prefix * and extending to the end of the line will be omitted from the output. Similarly, the provided * {@code blockCommentStartDelimiter} and {@code blockCommentEndDelimiter} delimiters will be honored: any text @@ -255,7 +255,7 @@ public abstract class ScriptUtils { /** * Read a script without blocking from the provided resource, using the supplied comment prefix and statement * separator, and build a {@link String} and build a String containing the lines. - *

+ *

* Lines beginning with the comment prefix are excluded from the results; however, line comments anywhere * else — for example, within a statement — will be included in the results. * @@ -291,7 +291,7 @@ public abstract class ScriptUtils { /** * Read a script from the provided {@link LineNumberReader}, using the supplied comment prefix and statement * separator, and build a {@link String} containing the lines. - *

+ *

* Lines beginning with the comment prefix are excluded from the results; however, line comments anywhere * else — for example, within a statement — will be included in the results. * @@ -372,10 +372,10 @@ public abstract class ScriptUtils { /** * Execute the given SQL script using default settings for statement separators, comment delimiters, and exception * handling flags. - *

+ *

* Statement separators and comments will be removed before executing individual statements within the supplied * script. - *

+ *

* Warning: this method does not release the provided {@link Connection}. * * @param connection the R2DBC connection to use to execute the script; already configured and ready to use. @@ -398,10 +398,10 @@ public abstract class ScriptUtils { /** * Execute the given SQL script using default settings for statement separators, comment delimiters, and exception * handling flags. - *

+ *

* Statement separators and comments will be removed before executing individual statements within the supplied * script. - *

+ *

* Warning: this method does not release the provided {@link Connection}. * * @param connection the R2DBC connection to use to execute the script; already configured and ready to use. @@ -424,10 +424,10 @@ public abstract class ScriptUtils { /** * Execute the given SQL script. - *

+ *

* Statement separators and comments will be removed before executing individual statements within the supplied * script. - *

+ *

* Warning: this method does not release the provided {@link Connection}. * * @param connection the R2DBC connection to use to execute the script; already configured and ready to use. diff --git a/src/main/java/org/springframework/data/r2dbc/convert/R2dbcConverter.java b/src/main/java/org/springframework/data/r2dbc/convert/R2dbcConverter.java index f190bd4..610a520 100644 --- a/src/main/java/org/springframework/data/r2dbc/convert/R2dbcConverter.java +++ b/src/main/java/org/springframework/data/r2dbc/convert/R2dbcConverter.java @@ -76,7 +76,7 @@ public interface R2dbcConverter * Return whether the {@code type} is a simple type. Simple types are database primitives or types with a custom * mapping strategy. * - * @param valueType the type to inspect, must not be {@literal null}. + * @param type the type to inspect, must not be {@literal null}. * @return {@literal true} if the type is a simple one. * @see org.springframework.data.mapping.model.SimpleTypeHolder * @since 1.2 diff --git a/src/main/java/org/springframework/data/r2dbc/core/ConnectionAccessor.java b/src/main/java/org/springframework/data/r2dbc/core/ConnectionAccessor.java index 2267c33..faa758c 100644 --- a/src/main/java/org/springframework/data/r2dbc/core/ConnectionAccessor.java +++ b/src/main/java/org/springframework/data/r2dbc/core/ConnectionAccessor.java @@ -27,7 +27,7 @@ import org.springframework.dao.DataAccessException; * Interface declaring methods that accept callback {@link Function} to operate within the scope of a * {@link Connection}. Callback functions operate on a provided connection and must not close the connection as the * connections may be pooled or be subject to other kinds of resource management. - *

+ *

* Callback functions are responsible for creating a {@link org.reactivestreams.Publisher} that defines the scope of how * long the allocated {@link Connection} is valid. Connections are released after the publisher terminates. * diff --git a/src/main/java/org/springframework/data/r2dbc/core/R2dbcEntityTemplate.java b/src/main/java/org/springframework/data/r2dbc/core/R2dbcEntityTemplate.java index d93112c..6e6fcdb 100644 --- a/src/main/java/org/springframework/data/r2dbc/core/R2dbcEntityTemplate.java +++ b/src/main/java/org/springframework/data/r2dbc/core/R2dbcEntityTemplate.java @@ -243,7 +243,7 @@ public class R2dbcEntityTemplate implements R2dbcEntityOperations, BeanFactoryAw * Set the {@link ReactiveEntityCallbacks} instance to use when invoking * {@link org.springframework.data.mapping.callback.ReactiveEntityCallbacks callbacks} like the * {@link BeforeSaveCallback}. - *

+ *

* Overrides potentially existing {@link ReactiveEntityCallbacks}. * * @param entityCallbacks must not be {@literal null}. diff --git a/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkers.java b/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkers.java index 262e162..c2e3ed3 100644 --- a/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkers.java +++ b/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkers.java @@ -4,7 +4,7 @@ package org.springframework.data.r2dbc.dialect; * Bind markers represent placeholders in SQL queries for substitution for an actual parameter. Using bind markers * allows creating safe queries so query strings are not required to contain escaped values but rather the driver * encodes parameter in the appropriate representation. - *

+ *

* {@link BindMarkers} is stateful and can be only used for a single binding pass of one or more parameters. It * maintains bind indexes/bind parameter names. * diff --git a/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkersFactory.java b/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkersFactory.java index 0ed98d2..719f880 100644 --- a/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkersFactory.java +++ b/src/main/java/org/springframework/data/r2dbc/dialect/BindMarkersFactory.java @@ -6,7 +6,7 @@ import org.springframework.util.Assert; /** * This class creates new {@link BindMarkers} instances to bind parameter for a specific {@link io.r2dbc.spi.Statement}. - *

+ *

* Bind markers can be typically represented as placeholder and identifier. Placeholders are used within the query to * execute so the underlying database system can substitute the placeholder with the actual value. Identifiers are used * in R2DBC drivers to bind a value to a bind marker. Identifiers are typically a part of an entire bind marker when @@ -106,7 +106,7 @@ public interface BindMarkersFactory extends org.springframework.r2dbc.core.bindi * Create named {@link BindMarkers} using identifiers to bind parameters. Named bind markers can support * {@link BindMarkers#next(String) name hints}. If no {@link BindMarkers#next(String) hint} is given, named bind * markers can use a counter or a random value source to generate unique bind markers. - *

+ *

* Allow customization of the bind marker placeholder {@code prefix} and {@code namePrefix} to represent the bind * marker as placeholder within the query. *