org.mapstruct

Enum CollectionMappingStrategy

java.lang.Object

java.lang.Enum<CollectionMappingStrategy>

org.mapstruct.CollectionMappingStrategy

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<CollectionMappingStrategy>

public enum CollectionMappingStrategy
extends java.lang.Enum<CollectionMappingStrategy>

Strategy for propagating the value of collection-typed properties from source to target.

Author:

Sjaak Derksen

Enum Constant Summary

Enum Constants

Enum Constant and Description
ACCESSOR_ONLY The setter of the target property will be used to propagate the value: orderDto.setOrderLines(order.getOrderLines).
ADDER_PREFERRED Identical to SETTER_PREFERRED, only that adder methods will be preferred over setter methods, if both are present for a given collection-typed property.
DEFAULT If given via Mapper.collectionMappingStrategy(), causes the setting specified via MapperConfig.collectionMappingStrategy() to be applied, if present.
SETTER_PREFERRED If present, the setter of the target property will be used to propagate the value: orderDto.setOrderLines(order.getOrderLines).

Method Summary

Modifier and Type	Method and Description
static CollectionMappingStrategy	valueOf(java.lang.String name) Returns the enum constant of this type with the specified name.
static CollectionMappingStrategy[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ACCESSOR_ONLY

public static final CollectionMappingStrategy ACCESSOR_ONLY

The setter of the target property will be used to propagate the value: orderDto.setOrderLines(order.getOrderLines).

If no setter is available but a getter method, this will be used, under the assumption it has been initialized: orderDto.getOrderLines().addAll(order.getOrderLines).

SETTER_PREFERRED

public static final CollectionMappingStrategy SETTER_PREFERRED

If present, the setter of the target property will be used to propagate the value: orderDto.setOrderLines(order.getOrderLines).

If no setter but and adder method is present, that adder will be invoked for each element of the source collection: order.addOrderLine(orderLine() ).

If neither a setter nor an adder method but a getter for the target property is present, that getter will be used, assuming it returns an initialized collection: If no setter is available, MapStruct will first look for an adder method before resorting to a getter.

ADDER_PREFERRED

public static final CollectionMappingStrategy ADDER_PREFERRED

Identical to SETTER_PREFERRED, only that adder methods will be preferred over setter methods, if both are present for a given collection-typed property.

DEFAULT

public static final CollectionMappingStrategy DEFAULT

If given via Mapper.collectionMappingStrategy(), causes the setting specified via MapperConfig.collectionMappingStrategy() to be applied, if present. Otherwise causes ACCESSOR_ONLY to be applied.

Method Detail

values

public static CollectionMappingStrategy[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (CollectionMappingStrategy c : CollectionMappingStrategy.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static CollectionMappingStrategy valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null