Mapping Strategy

Mapping behavior for null values.

Use the mapping strategy to define basic mapping behavior for null values.
Options
The following options are available for mapping strategy:
MAP_ALL - A strategy that maps all values of a field.
MAP_NOT_NULL - A strategy that maps only the values of a field that are not null. If the field value is null it will not override the current value in the target class instance. This is the default strategy when creating a new ShapeShift instance.
Usage
There are two options for setting the mapping strategy:
Default Mapping Strategy
Settings the default mapping strategy for the ShapeShift instance.
Kotlin
Java
val shapeShift = ShapeShiftBuilder()
    .withDefaultMappingStrategy(MappingStrategy.MAP_ALL)
    .build()
ShapeShift shapeShift = new ShapeShiftBuilder()
        .withDefaultMappingStrategy(MappingStrategy.MAP_ALL)
        .build();
Override Mapping Strategy
Overriding the mapping strategy for a specific field.
Annotations
Kotlin
Java
@MappedField(overrideMappingStrategy = MappingStrategy.MAP_ALL)
@MappedField(overrideMappingStrategy = MappingStrategy.MAP_ALL)
Kotlin DSL
val mapper = mapper<From, To> {
    From::value mappedTo To::value overrideStrategy MappingStrategy.MAP_NOT_NULL
}
Java Builder
MappingDefinition mappingDefinition = new MappingDefinitionBuilder(From.class, To.class)
        .mapField("value", "value").withMappingStrategy(MappingStrategy.MAP_NOT_NULL)
        .build();

Features - Previous

Object Suppliers

Next - Guides

Implicit Transformers

Last modified 8mo ago