diff --git a/jOOQ/src/main/java/org/jooq/Configuration.java b/jOOQ/src/main/java/org/jooq/Configuration.java index ffd9985468..6fd24ea2c7 100644 --- a/jOOQ/src/main/java/org/jooq/Configuration.java +++ b/jOOQ/src/main/java/org/jooq/Configuration.java @@ -344,6 +344,32 @@ public interface Configuration extends Serializable { */ Configuration set(ConnectionProvider newConnectionProvider); + /** + * Change this configuration to hold a new connection wrapped in a + * {@link DefaultConnectionProvider}. + *

+ * This method is not thread-safe and should not be used in globally + * available Configuration objects. + * + * @param newConnection The new connection to be contained in the changed + * configuration. + * @return The changed configuration. + */ + Configuration set(Connection newConnection); + + /** + * Change this configuration to hold a new data source wrapped in a + * {@link DataSourceConnectionProvider}. + *

+ * This method is not thread-safe and should not be used in globally + * available Configuration objects. + * + * @param newConnection The new data source to be contained in the changed + * configuration. + * @return The changed configuration. + */ + Configuration set(DataSource newDataSource); + /** * Change this configuration to hold a new transaction provider. *

@@ -462,6 +488,26 @@ public interface Configuration extends Serializable { */ Configuration derive(ConnectionProvider newConnectionProvider); + /** + * Create a derived configuration from this one, with a new connection + * wrapped in a {@link DefaultConnectionProvider}. + * + * @param newConnection The new connection to be contained in the derived + * configuration. + * @return The derived configuration. + */ + Configuration derive(Connection newConnection); + + /** + * Create a derived configuration from this one, with a new data source + * wrapped in a {@link DataSourceConnectionProvider}. + * + * @param newDataSource The new data source to be contained in the derived + * configuration. + * @return The derived configuration. + */ + Configuration derive(DataSource newDataSource); + /** * Create a derived configuration from this one, with a new transaction * provider. diff --git a/jOOQ/src/main/java/org/jooq/impl/DefaultConfiguration.java b/jOOQ/src/main/java/org/jooq/impl/DefaultConfiguration.java index 931312e220..e60944d471 100644 --- a/jOOQ/src/main/java/org/jooq/impl/DefaultConfiguration.java +++ b/jOOQ/src/main/java/org/jooq/impl/DefaultConfiguration.java @@ -343,17 +343,17 @@ public class DefaultConfiguration implements Configuration { } /** - * Convenience method for {@link #derive(ConnectionProvider)}, using a - * {@link DefaultConnectionProvider}. + * {@inheritDoc} */ + @Override public final Configuration derive(Connection newConnection) { return derive(new DefaultConnectionProvider(newConnection)); } /** - * Convenience method for {@link #derive(ConnectionProvider)}, using a - * {@link DataSourceConnectionProvider}. + * {@inheritDoc} */ + @Override public final Configuration derive(DataSource newDataSource) { return derive(new DataSourceConnectionProvider(newDataSource)); } @@ -534,17 +534,17 @@ public class DefaultConfiguration implements Configuration { // ------------------------------------------------------------------------- /** - * Convenience method for {@link #set(ConnectionProvider)}, using a - * {@link DefaultConnectionProvider}. + * {@inheritDoc} */ + @Override public final Configuration set(Connection newConnection) { return set(new DefaultConnectionProvider(newConnection)); } /** - * Convenience method for {@link #set(ConnectionProvider)}, using a - * {@link DataSourceConnectionProvider}. + * {@inheritDoc} */ + @Override public final Configuration set(DataSource newDataSource) { return set(new DataSourceConnectionProvider(newDataSource)); }