Class DbColumnBase

java.lang.Object

io.helidon.dbclient.DbColumnBase

All Implemented Interfaces:

OptionalValue<Object>, Value<Object>, DbColumn

Direct Known Subclasses:

MongoDbColumn

public abstract class DbColumnBase
extends Object
implements DbColumn

Base DbColumn implementation.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DbColumnBase(Object value, Mappers mapperManager, String... mappingQualifiers)	Create a new instance.

Method Summary

Modifier and Type	Method	Description
<N> OptionalValue<N>	as(GenericType<N> type)	Convert this value to a different type using a mapper.
<N> OptionalValue<N>	as(Class<N> type)	Convert this value to a different type using a mapper.
<N> OptionalValue<N>	as(Function<? super Object, ? extends N> mapper)	Convert this Value to a different type using a mapper function.
OptionalValue<Boolean>	asBoolean()	Boolean typed value.
OptionalValue<Double>	asDouble()	Double typed value.
OptionalValue<Integer>	asInt()	Integer typed value.
OptionalValue<Long>	asLong()	Long typed value.
Optional<Object>	asOptional()	Typed value as Optional.
OptionalValue<String>	asString()	String typed value.
<T> T	get(GenericType<T> type)	Value of this column as a generic type.
<T> T	get(Class<T> type)	Typed value of this column.
protected <SRC,T> T	map(SRC value, GenericType<T> type)	Map value to target type using Mapper.
protected <SRC,T> T	map(SRC value, Class<T> type)	Map value to target type using Mapper.
protected Object	rawValue()	Get raw value of the database column.

Methods inherited from class Object

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

Methods inherited from interface DbColumn

dbType, get, javaType, name, precision, scale

Modifier and Type	Method	Description
String	dbType()	Type of the column in the language of the database.
default Object	get()	Untyped value of this column, returns java type as provided by the underlying database driver.
Class<?>	javaType()	Type of the column as would be returned by the underlying database driver.
String	name()	Column name.
default Optional<Integer>	precision()	Precision of this column.
default Optional<Integer>	scale()	Scale of this column.

Methods inherited from interface OptionalValue

ifPresent, ifPresentOrElse, isEmpty, isPresent, map, or, orElse, orElseGet, orElseThrow, orElseThrow

Modifier and Type	Method	Description
default void	ifPresent(Consumer<? super Object> consumer)	If a value is present, invoke the specified consumer with the value, otherwise do nothing.
default void	ifPresentOrElse(Consumer<Object> action, Runnable emptyAction)	If a value is present, performs the given action with the value, otherwise performs the given empty-based action.
default boolean	isEmpty()	Return false if there is a value present, otherwise true.
default boolean	isPresent()	Return true if there is a value present, otherwise false.
default <U> Optional<U>	map(Function<? super Object, ? extends U> mapper)	If a value is present, apply the provided mapping function to it, and if the result is non-null, return an Optional describing the result.
default Optional<Object>	or(Supplier<? extends Optional<Object>> supplier)	If the underlying Optional does not have a value, set it to the Optional produced by the supplying function.
default Object	orElse(Object other)	Return the value if present, otherwise return other.
default Object	orElseGet(Supplier<? extends Object> other)	Return the value if present, otherwise invoke other and return the result of that invocation.
default Object	orElseThrow()	If a value is present, returns the value, otherwise throws NoSuchElementException.
default <X extends Throwable> Object	orElseThrow(Supplier<? extends X> exceptionSupplier)	Return the contained value, if present, otherwise throw an exception to be created by the provided supplier.

Methods inherited from interface Value

filter, flatMap, getBoolean, getDouble, getInt, getLong, getString, stream

Modifier and Type	Method	Description
default Optional<Object>	filter(Predicate<? super Object> predicate)	If a value is present, and the value matches the given predicate, return an Optional describing the value, otherwise return an empty Optional.
default <U> Optional<U>	flatMap(Function<? super Object, Optional<? extends U>> mapper)	Apply the provided Optional-bearing mapping function to this value, return that result.
default boolean	getBoolean()	Boolean typed value.
default double	getDouble()	Double typed value.
default int	getInt()	Integer typed value.
default long	getLong()	Long typed value.
default String	getString()	String typed value.
default Stream<Object>	stream()	If a value is present, returns a sequential Stream containing only that value, otherwise returns an empty Stream.

Constructor Details

DbColumnBase

protected DbColumnBase(Object value,
 Mappers mapperManager,
 String... mappingQualifiers)

Create a new instance.

Parameters:

value - value

mapperManager - mapper manager

mappingQualifiers - mapping qualifiers

Method Details

rawValue

protected Object rawValue()

Get raw value of the database column.

Returns:

raw value of the column

get

public <T> T get(Class<T> type)
          throws MapperException

Description copied from interface: DbColumn

Typed value of this column. This method can return a correct result only if the type is the same as DbColumn.javaType() or there is a Mapper registered that can map it.

Specified by:

get in interface DbColumn

Specified by:

get in interface Value<Object>

Type Parameters:

T - type of the returned value

Parameters:

type - class of the type that should be returned (must be supported by the underlying data type)

Returns:

value of this column correctly typed

Throws:

MapperException - in case the type is not the underlying DbColumn.javaType() and there is no mapper registered for it

get

public <T> T get(GenericType<T> type)
          throws MapperException

Description copied from interface: DbColumn

Value of this column as a generic type. This method can return a correct result only if the type represents a class, or if there is a Mapper registered that can map underlying DbColumn.javaType() to the type requested.

Specified by:

get in interface DbColumn

Specified by:

get in interface Value<Object>

Type Parameters:

T - type of the returned value

Parameters:

type - requested type

Returns:

value mapped to the expected type if possible

Throws:

MapperException - in case the mapping cannot be done

as

public <N> OptionalValue<N> as(Class<N> type)
                        throws MapperException

Description copied from interface: Value

Convert this value to a different type using a mapper.

Specified by:

as in interface OptionalValue<Object>

Specified by:

as in interface Value<Object>

Type Parameters:

N - type we expect

Parameters:

type - type to convert to

Returns:

converted value

Throws:

MapperException - in case the value cannot be converted

as

public <N> OptionalValue<N> as(GenericType<N> type)
                        throws MapperException

Description copied from interface: Value

Convert this value to a different type using a mapper.

Specified by:

as in interface OptionalValue<Object>

Specified by:

as in interface Value<Object>

Type Parameters:

N - type we expect

Parameters:

type - type to convert to

Returns:

converted value

Throws:

MapperException

as

public <N> OptionalValue<N> as(Function<? super Object, ? extends N> mapper)

Description copied from interface: Value

Convert this Value to a different type using a mapper function.

Specified by:

as in interface OptionalValue<Object>

Specified by:

as in interface Value<Object>

Type Parameters:

N - type of the returned Value

Parameters:

mapper - mapper to map the type of this Value to a type of the returned Value

Returns:

a new value with the new type

asOptional

public Optional<Object> asOptional()
                            throws MapperException

Description copied from interface: Value

Typed value as Optional. Returns a empty if this value does not have a backing value present. As this class implements all methods of Optional, this is only a utility method if an actual Optional instance is needed (Optional itself is {code final}).

Specified by:

asOptional in interface Value<Object>

Returns:

value as Optional, empty in case the value does not have a direct value

Throws:

MapperException - in case the value cannot be converted to the expected type

See Also:

• Value.get()

asBoolean

public OptionalValue<Boolean> asBoolean()

Description copied from interface: Value

Boolean typed value.

Specified by:

asBoolean in interface OptionalValue<Object>

Specified by:

asBoolean in interface Value<Object>

Returns:

typed value

asString

public OptionalValue<String> asString()

Description copied from interface: Value

String typed value.

Specified by:

asString in interface OptionalValue<Object>

Specified by:

asString in interface Value<Object>

Returns:

typed value

asInt

public OptionalValue<Integer> asInt()

Description copied from interface: Value

Integer typed value.

Specified by:

asInt in interface OptionalValue<Object>

Specified by:

asInt in interface Value<Object>

Returns:

typed value

asLong

public OptionalValue<Long> asLong()

Description copied from interface: Value

Long typed value.

Specified by:

asLong in interface OptionalValue<Object>

Specified by:

asLong in interface Value<Object>

Returns:

typed value

asDouble

public OptionalValue<Double> asDouble()

Description copied from interface: Value

Double typed value.

Specified by:

asDouble in interface OptionalValue<Object>

Specified by:

asDouble in interface Value<Object>

Returns:

typed value

map

protected <SRC,T> T map(SRC value,
 GenericType<T> type)

Map value to target type using Mapper.

Type Parameters:

SRC - type of the source value

T - type of the target value

Parameters:

value - source value

type - target type

Returns:

result of the mapping

Throws:

MapperException - in case the mapper was not found or failed

map

protected <SRC,T> T map(SRC value,
 Class<T> type)

Map value to target type using Mapper. String.valueOf(Object) is used as fallback option when Mapper fails.

Type Parameters:

SRC - type of the source value

T - type of the target value

Parameters:

value - source value

type - target type

Returns:

result of the mapping