Package org.jdbi.v3.core.config
Interface Configurable<This>
-
- Type Parameters:
This- The subtype that implements this interface.
- All Known Implementing Classes:
BaseStatement,Batch,Call,Handle,Jdbi,MetaData,PreparedBatch,Query,Script,SqlStatement,Update
public interface Configurable<This>A type with access to access and modify arbitrary Jdbi configuration.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Deprecated Methods Modifier and Type Method Description default ThisaddCustomizer(StatementCustomizer customizer)default <C extends JdbiConfig<C>>
Thisconfigure(java.lang.Class<C> configClass, java.util.function.Consumer<C> configurer)Passes the configuration object of the given type to the configurer, then returns this object.default Thisdefine(java.lang.String key, java.lang.Object value)Convenience method forgetConfig(SqlStatements.class).define(key, value)ConfigRegistrygetConfig()Returns the configuration registry associated with this object.default <C extends JdbiConfig<C>>
CgetConfig(java.lang.Class<C> configClass)Gets the configuration object of the given type, associated with this object.default ThisregisterArgument(ArgumentFactory factory)Convenience method forgetConfig(Arguments.class).register(factory)default ThisregisterArgument(QualifiedArgumentFactory factory)Convenience method forgetConfig(Arguments.class).register(factory)default ThisregisterArrayType(java.lang.Class<?> elementType, java.lang.String sqlTypeName)Convenience method forgetConfig(SqlArrayTypes.class).register(elementType, sqlTypeName)default <T> ThisregisterArrayType(java.lang.Class<T> elementType, java.lang.String sqlTypeName, java.util.function.Function<T,?> conversion)Convenience method for registering an array type asSqlArrayTypeFactory.of(Class, String, Function).default ThisregisterArrayType(SqlArrayType<?> arrayType)Convenience method forgetConfig(SqlArrayTypes.class).register(arrayType)default ThisregisterArrayType(SqlArrayTypeFactory factory)Convenience method forgetConfig(SqlArrayTypes.class).register(factory)default ThisregisterCodecFactory(CodecFactory codecFactory)Convenience method to register aCodecFactory.default ThisregisterCollector(java.lang.reflect.Type collectionType, java.util.stream.Collector<?,?,?> collector)Convenience method forgetConfig(JdbiCollectors.class).register(CollectorFactory.collectorFactory(collectionType, collector))default ThisregisterCollector(CollectorFactory factory)Convenience method forgetConfig(JdbiCollectors.class).register(factory)default ThisregisterColumnMapper(java.lang.reflect.Type type, ColumnMapper<?> mapper)Convenience method forgetConfig(ColumnMappers.class).register(type, mapper)default <T> ThisregisterColumnMapper(GenericType<T> type, ColumnMapper<T> mapper)Convenience method forgetConfig(ColumnMappers.class).register(type, mapper)default ThisregisterColumnMapper(ColumnMapper<?> mapper)Convenience method forgetConfig(ColumnMappers.class).register(mapper)default ThisregisterColumnMapper(ColumnMapperFactory factory)Convenience method forgetConfig(ColumnMappers.class).register(factory)default ThisregisterColumnMapper(QualifiedColumnMapperFactory factory)Convenience method forgetConfig(ColumnMappers.class).register(factory)default <T> ThisregisterColumnMapper(QualifiedType<T> type, ColumnMapper<T> mapper)Convenience method forgetConfig(ColumnMappers.class).register(type, mapper)default ThisregisterExtension(ExtensionFactory factory)Convenience method forgetConfig(Extensions.class).register(factory)default ThisregisterRowMapper(java.lang.reflect.Type type, RowMapper<?> mapper)Convenience method forgetConfig(RowMappers.class).register(type, mapper)default <T> ThisregisterRowMapper(GenericType<T> type, RowMapper<T> mapper)Convenience method forgetConfig(RowMappers.class).register(type, mapper)default ThisregisterRowMapper(RowMapper<?> mapper)Convenience method forgetConfig(RowMappers.class).register(mapper)default ThisregisterRowMapper(RowMapperFactory factory)Convenience method forgetConfig(RowMappers.class).register(factory)default ThissetMapKeyColumn(java.lang.String keyColumn)Convenience method forgetConfig(MapEntryMappers.class).setKeyColumn(keyColumn)default ThissetMapValueColumn(java.lang.String valueColumn)Convenience method forgetConfig(MapEntryMappers.class).setValueColumn(valueColumn)default ThissetSqlArrayArgumentStrategy(SqlArrayArgumentStrategy strategy)Convenience method forgetConfig(SqlArrayTypes.class).setArgumentStrategy(strategy)default ThissetSqlLogger(SqlLogger sqlLogger)default ThissetSqlParser(SqlParser parser)Convenience method forgetConfig(SqlStatements.class).setSqlParser(rewriter)default ThissetTemplateEngine(TemplateEngine templateEngine)Convenience method forgetConfig(SqlStatements.class).setTemplateEngine(rewriter)default ThissetTimingCollector(TimingCollector collector)Deprecated.
-
-
-
Method Detail
-
getConfig
ConfigRegistry getConfig()
Returns the configuration registry associated with this object.- Returns:
- the configuration registry associated with this object.
-
getConfig
default <C extends JdbiConfig<C>> C getConfig(java.lang.Class<C> configClass)
Gets the configuration object of the given type, associated with this object.- Type Parameters:
C- the configuration type- Parameters:
configClass- the configuration type- Returns:
- the configuration object of the given type, associated with this object.
-
configure
default <C extends JdbiConfig<C>> This configure(java.lang.Class<C> configClass, java.util.function.Consumer<C> configurer)
Passes the configuration object of the given type to the configurer, then returns this object.- Type Parameters:
C- the configuration type- Parameters:
configClass- the configuration typeconfigurer- consumer that will be passed the configuration object- Returns:
- this object (for call chaining)
-
setTemplateEngine
default This setTemplateEngine(TemplateEngine templateEngine)
Convenience method forgetConfig(SqlStatements.class).setTemplateEngine(rewriter)- Parameters:
templateEngine- the template engine- Returns:
- this
-
setSqlParser
default This setSqlParser(SqlParser parser)
Convenience method forgetConfig(SqlStatements.class).setSqlParser(rewriter)- Parameters:
parser- SQL parser- Returns:
- this
-
setTimingCollector
@Deprecated default This setTimingCollector(TimingCollector collector)
Deprecated.Convenience method forgetConfig(SqlStatements.class).setTimingCollector(collector)- Parameters:
collector- timing collector- Returns:
- this
-
addCustomizer
default This addCustomizer(StatementCustomizer customizer)
-
define
default This define(java.lang.String key, java.lang.Object value)
Convenience method forgetConfig(SqlStatements.class).define(key, value)- Parameters:
key- attribute namevalue- attribute value- Returns:
- this
-
registerArgument
default This registerArgument(ArgumentFactory factory)
Convenience method forgetConfig(Arguments.class).register(factory)- Parameters:
factory- argument factory- Returns:
- this
-
registerArgument
default This registerArgument(QualifiedArgumentFactory factory)
Convenience method forgetConfig(Arguments.class).register(factory)- Parameters:
factory- qualified argument factory- Returns:
- this
-
setSqlArrayArgumentStrategy
default This setSqlArrayArgumentStrategy(SqlArrayArgumentStrategy strategy)
Convenience method forgetConfig(SqlArrayTypes.class).setArgumentStrategy(strategy)- Parameters:
strategy- argument strategy- Returns:
- this
-
setMapKeyColumn
default This setMapKeyColumn(java.lang.String keyColumn)
Convenience method forgetConfig(MapEntryMappers.class).setKeyColumn(keyColumn)- Parameters:
keyColumn- the key column name- Returns:
- this
-
setMapValueColumn
default This setMapValueColumn(java.lang.String valueColumn)
Convenience method forgetConfig(MapEntryMappers.class).setValueColumn(valueColumn)- Parameters:
valueColumn- the value column name- Returns:
- this
-
registerArrayType
default This registerArrayType(java.lang.Class<?> elementType, java.lang.String sqlTypeName)
Convenience method forgetConfig(SqlArrayTypes.class).register(elementType, sqlTypeName)- Parameters:
elementType- element typesqlTypeName- SQL type name- Returns:
- this
-
registerArrayType
default <T> This registerArrayType(java.lang.Class<T> elementType, java.lang.String sqlTypeName, java.util.function.Function<T,?> conversion)
Convenience method for registering an array type asSqlArrayTypeFactory.of(Class, String, Function).- Type Parameters:
T- element type- Parameters:
elementType- element raw typesqlTypeName- SQL type nameconversion- the function to convert to database representation- Returns:
- this
-
registerArrayType
default This registerArrayType(SqlArrayType<?> arrayType)
Convenience method forgetConfig(SqlArrayTypes.class).register(arrayType)- Parameters:
arrayType- SQL array type- Returns:
- this
-
registerArrayType
default This registerArrayType(SqlArrayTypeFactory factory)
Convenience method forgetConfig(SqlArrayTypes.class).register(factory)- Parameters:
factory- SQL array type factory- Returns:
- this
-
registerCollector
default This registerCollector(java.lang.reflect.Type collectionType, java.util.stream.Collector<?,?,?> collector)
Convenience method forgetConfig(JdbiCollectors.class).register(CollectorFactory.collectorFactory(collectionType, collector))- Parameters:
collectionType- collector type to register the collector forcollector- the Collector to use to build the resulting collection- Returns:
- this
- Since:
- 3.38.0
-
registerCollector
default This registerCollector(CollectorFactory factory)
Convenience method forgetConfig(JdbiCollectors.class).register(factory)- Parameters:
factory- collector factory- Returns:
- this
-
registerColumnMapper
default This registerColumnMapper(ColumnMapper<?> mapper)
Convenience method forgetConfig(ColumnMappers.class).register(mapper)- Parameters:
mapper- column mapper- Returns:
- this
-
registerColumnMapper
default <T> This registerColumnMapper(GenericType<T> type, ColumnMapper<T> mapper)
Convenience method forgetConfig(ColumnMappers.class).register(type, mapper)- Type Parameters:
T- the type- Parameters:
type- the generic type to registermapper- the mapper to use on that type- Returns:
- this
-
registerColumnMapper
default This registerColumnMapper(java.lang.reflect.Type type, ColumnMapper<?> mapper)
Convenience method forgetConfig(ColumnMappers.class).register(type, mapper)- Parameters:
type- the type to registermapper- the mapper to use on that type- Returns:
- this
-
registerColumnMapper
default <T> This registerColumnMapper(QualifiedType<T> type, ColumnMapper<T> mapper)
Convenience method forgetConfig(ColumnMappers.class).register(type, mapper)- Parameters:
type- the type to registermapper- the mapper to use on that type- Returns:
- this
-
registerColumnMapper
default This registerColumnMapper(ColumnMapperFactory factory)
Convenience method forgetConfig(ColumnMappers.class).register(factory)- Parameters:
factory- column mapper factory- Returns:
- this
-
registerColumnMapper
default This registerColumnMapper(QualifiedColumnMapperFactory factory)
Convenience method forgetConfig(ColumnMappers.class).register(factory)- Parameters:
factory- column mapper factory- Returns:
- this
-
registerExtension
default This registerExtension(ExtensionFactory factory)
Convenience method forgetConfig(Extensions.class).register(factory)- Parameters:
factory- extension factory- Returns:
- this
-
registerRowMapper
default This registerRowMapper(RowMapper<?> mapper)
Convenience method forgetConfig(RowMappers.class).register(mapper)- Parameters:
mapper- row mapper- Returns:
- this
-
registerRowMapper
default <T> This registerRowMapper(GenericType<T> type, RowMapper<T> mapper)
Convenience method forgetConfig(RowMappers.class).register(type, mapper)- Type Parameters:
T- the type- Parameters:
type- to matchmapper- row mapper- Returns:
- this
-
registerRowMapper
default This registerRowMapper(java.lang.reflect.Type type, RowMapper<?> mapper)
Convenience method forgetConfig(RowMappers.class).register(type, mapper)- Parameters:
type- to matchmapper- row mapper- Returns:
- this
-
registerRowMapper
default This registerRowMapper(RowMapperFactory factory)
Convenience method forgetConfig(RowMappers.class).register(factory)- Parameters:
factory- row mapper factory- Returns:
- this
-
registerCodecFactory
@Alpha default This registerCodecFactory(CodecFactory codecFactory)
Convenience method to register aCodecFactory.- Parameters:
codecFactory- codec factory- Returns:
- this
-
-