Deprecated API

Contents

• Interfaces
• Classes
• Fields
• Methods
• Constructors
• Enum Constants

Deprecated Interfaces

Interface	Description
org.jdbi.v3.core.statement.SqlLoggable	this class is not for end-user use and should not be in the public API.
org.jdbi.v3.core.statement.TimingCollector	Use SqlLogger instead.

Deprecated Classes

Class	Description
org.jdbi.v3.core.argument.BeanPropertyArguments	this should never have been public API
org.jdbi.v3.core.argument.BuiltInArgumentFactory	will be replaced by a plugin
org.jdbi.v3.core.argument.MapArguments	use SqlStatement.bindMap(Map) instead
org.jdbi.v3.core.argument.ObjectFieldArguments	this functionality will remain supported, but this class should not be API
org.jdbi.v3.core.argument.ObjectMethodArguments	this functionality will remain supported, but this class should not be API
org.jdbi.v3.core.collector.BuiltInCollectorFactory	will be replaced by plugin
org.jdbi.v3.core.mapper.BuiltInMapperFactory	will be replaced by an opt-out plugin to give the core no hardwired behavior
org.jdbi.v3.core.mapper.EnumByNameMapperFactory	Use getConfig(Enums.class).setEnumStrategy(BY_NAME) instead.
org.jdbi.v3.core.mapper.EnumByOrdinalMapperFactory	Use getConfig(Enums.class).setEnumStrategy(BY_ORDINAL) instead.
org.jdbi.v3.core.statement.MessageFormatTemplateEngine	MessageFormat formats integers with decimal separators, e.g. 1000 → "1,000". This hindsight realization has led us to discourage its use.

Deprecated Fields

Field	Description
org.jdbi.v3.core.statement.TimingCollector.NOP_TIMING_COLLECTOR	Use SqlLogger.NOP_SQL_LOGGER instead.

Deprecated Methods

Method	Description
org.jdbi.v3.core.argument.ArgumentFactory.Preparable.prePreparedTypes()	no longer used
org.jdbi.v3.core.argument.QualifiedArgumentFactory.Preparable.prePreparedTypes()	no longer used
org.jdbi.v3.core.collector.BuiltInCollectorFactory.toMap(Supplier<M>)	Use MapCollectors.toMap(Supplier) instead.
org.jdbi.v3.core.collector.BuiltInCollectorFactory.toOptional()	Use OptionalCollectors.toOptional() instead.
org.jdbi.v3.core.config.Configurable.setTimingCollector(TimingCollector)	use Configurable.setSqlLogger(org.jdbi.v3.core.statement.SqlLogger) instead
org.jdbi.v3.core.extension.HandleSupplier.invokeInContext(ExtensionMethod, ConfigRegistry, Callable<V>)	New code should implement the HandleSupplier.invokeInContext(ExtensionContext, Callable) method and use this as a retrofit.
org.jdbi.v3.core.Handle.release(String)	Use Handle.releaseSavepoint(String)
org.jdbi.v3.core.Handle.setTransactionIsolation(int)	Use Handle.setTransactionIsolationLevel(TransactionIsolationLevel)
org.jdbi.v3.core.Handle.setTransactionIsolation(TransactionIsolationLevel)	Use Handle.setTransactionIsolationLevel(int)
org.jdbi.v3.core.locator.ClasspathSqlLocator.findSqlOnClasspath(Class<?>, String)	ClasspathSqlLocator.create() an instance instead of using static methods
org.jdbi.v3.core.locator.ClasspathSqlLocator.findSqlOnClasspath(String)	ClasspathSqlLocator.create() an instance instead of using static methods
org.jdbi.v3.core.locator.ClasspathSqlLocator.getResourceOnClasspath(ClassLoader, String)	ClasspathSqlLocator.create() an instance instead of using static methods
org.jdbi.v3.core.locator.ClasspathSqlLocator.getResourceOnClasspath(String)	ClasspathSqlLocator.create() an instance instead of using static methods
org.jdbi.v3.core.mapper.reflect.ReflectionMapperUtil.getColumnNames(ResultSet)
org.jdbi.v3.core.result.ResultIterable.findOnly()	use ResultIterable.one() or ResultIterable.findOne() instead.
org.jdbi.v3.core.statement.Binding.findForName(String, StatementContext)	don't inspect a Binding: keep your own state!
org.jdbi.v3.core.statement.Binding.findForPosition(int)	don't inspect a Binding: keep your own state!
org.jdbi.v3.core.statement.Binding.getNames()	this is expensive to compute, and it's bad practice to inspect a Binding: keep track of your own state!
org.jdbi.v3.core.statement.PreparedBatch.executeAndReturnGeneratedKeys(String...)	Use PreparedBatch.executePreparedBatch(String...) which has the same functionality but also returns the per-batch modified row counts.
org.jdbi.v3.core.statement.SqlStatements.getTimingCollector()	use SqlStatements.getSqlLogger() instead
org.jdbi.v3.core.statement.SqlStatements.setTimingCollector(TimingCollector)	use SqlStatements.setSqlLogger(org.jdbi.v3.core.statement.SqlLogger) instead
org.jdbi.v3.core.statement.TimingCollector.collect(long, StatementContext)	Use SqlLogger.logAfterExecution(org.jdbi.v3.core.statement.StatementContext) instead.
org.jdbi.v3.freemarker.FreemarkerSqlLocator.findTemplate(Class<?>, String)	this static method does not respect configuration, use FreemarkerConfig.createLocator()
org.jdbi.v3.sqlobject.customizer.BindList.EmptyHandling.define(SqlStatement, String)	legacy internal API
org.jdbi.v3.testing.JdbiRule.migrateWithFlyway()	use JdbiRule.withMigration(Migration)
org.jdbi.v3.testing.JdbiRule.migrateWithFlyway(String...)	use JdbiRule.withMigration(Migration)
org.jdbi.v3.testing.junit5.JdbiFlywayMigration.cleanAfter()	The default changed to true so this call actually does nothing.

Deprecated Constructors

Constructor	Description
org.jdbi.v3.core.argument.ObjectArgument(Object, Integer)	use ObjectArgument.of(Object, Integer) factory method for more consistent null handling

Deprecated Enum Constants

Enum Constant	Description
org.jdbi.v3.sqlobject.customizer.BindList.EmptyHandling.NULL	vaguely named in light of new additions, use BindList.EmptyHandling.NULL_STRING instead