Package org.jdbi.v3.core.codec

Class CodecFactory

java.lang.Object

org.jdbi.v3.core.codec.CodecFactory

All Implemented Interfaces:

QualifiedArgumentFactory, QualifiedArgumentFactory.Preparable, QualifiedColumnMapperFactory

Direct Known Subclasses:

TypeResolvingCodecFactory

@ThreadSafe
@Beta
public class CodecFactory
extends Object
implements QualifiedColumnMapperFactory, QualifiedArgumentFactory.Preparable

CodecFactory provides column mappers and arguments for bidirectional mapping types to database columns.

This class is immutable and thread safe.

Alpha: this class as public API is redundant with the existing way of managing mappers: we should try to combine them to make the new public API as small as possible

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	CodecFactory.Builder	Fluent Builder for CodecFactory.

Nested classes/interfaces inherited from interface org.jdbi.v3.core.argument.QualifiedArgumentFactory

QualifiedArgumentFactory.Preparable

Constructor Summary

Constructors

Constructor	Description
CodecFactory(Map<QualifiedType<?>,Codec<?>> codecMap)	Create a new CodecFactory.

Method Summary

Modifier and Type	Method	Description
final Optional<Argument>	build(QualifiedType<?> type, Object value, ConfigRegistry config)	Returns an Argument for the given value if the factory supports it; empty otherwise.
final Optional<ColumnMapper<?>>	build(QualifiedType<?> type, ConfigRegistry config)	Supplies a column mapper which will map columns to type if the factory supports it; empty otherwise.
static CodecFactory.Builder	builder()	Returns a builder for fluent API.
static CodecFactory	forSingleCodec(QualifiedType<?> type, Codec<?> codec)
final Optional<Function<Object,Argument>>	prepare(QualifiedType<?> type, ConfigRegistry config)
final Collection<QualifiedType<?>>	prePreparedTypes()	Deprecated. no longer used

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

CodecFactory

public CodecFactory(Map<QualifiedType<?>,Codec<?>> codecMap)

Create a new CodecFactory.

Method Details

builder

public static CodecFactory.Builder builder()

Returns a builder for fluent API.

forSingleCodec

public static CodecFactory forSingleCodec(QualifiedType<?> type,
 Codec<?> codec)

prepare

public final Optional<Function<Object,Argument>> prepare(QualifiedType<?> type,
 ConfigRegistry config)

Specified by:

prepare in interface QualifiedArgumentFactory.Preparable

prePreparedTypes

@Deprecated
public final Collection<QualifiedType<?>> prePreparedTypes()

Deprecated.

no longer used

Specified by:

prePreparedTypes in interface QualifiedArgumentFactory.Preparable

build

public final Optional<Argument> build(QualifiedType<?> type,
 Object value,
 ConfigRegistry config)

Description copied from interface: QualifiedArgumentFactory

Returns an Argument for the given value if the factory supports it; empty otherwise.

Specified by:

build in interface QualifiedArgumentFactory

Parameters:

type - the known qualified type of value. Depending on the situation this may be a full generic signature e.g. ParameterizedType, a Class, or Object.class if no type information is known.

value - the value to convert into an Argument

config - the config registry, for composition

Returns:

an argument for the given value if this factory supports it, or Optional.empty() otherwise.

See Also:

• StatementContext.findArgumentFor(QualifiedType, Object)
• Arguments.findFor(QualifiedType, Object)
• QualifiedType

build

public final Optional<ColumnMapper<?>> build(QualifiedType<?> type,
 ConfigRegistry config)

Description copied from interface: QualifiedColumnMapperFactory

Supplies a column mapper which will map columns to type if the factory supports it; empty otherwise.

Specified by:

build in interface QualifiedColumnMapperFactory

Parameters:

type - the target qualified type to map to

config - the config registry, for composition

Returns:

a column mapper for the given type if this factory supports it, or Optional.empty() otherwise.

See Also:

• for composition
• QualifiedType