org.mapstruct

Annotation Type IterableMapping

@Target(value=METHOD)
 @Retention(value=CLASS)
public @interface IterableMapping

Configures the mapping between two iterable types, e.g. List<String> and List<Date>.

Note: either @IterableMapping#dateFormat, @IterableMapping#resultType or @IterableMapping#qualifiedBy must be specified

Author:

Gunnar Morling

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	dateFormat A format string as processable by SimpleDateFormat if the annotated method maps from an iterable of String to an iterable Date or vice-versa.
Class<?>	elementTargetType Specifies the type of the element to be used in the result of the mapping method in case multiple mapping methods qualify.
NullValueMappingStrategy	nullValueMappingStrategy The strategy to be applied when null is passed as source value to this iterable mapping.
Class<? extends Annotation>[]	qualifiedBy A qualifier can be specified to aid the selection process of a suitable mapper.

Element Detail

dateFormat

public abstract String dateFormat

A format string as processable by SimpleDateFormat if the annotated method maps from an iterable of String to an iterable Date or vice-versa. Will be ignored for all other element types.

Returns:

A date format string as processable by SimpleDateFormat.

Default:

""

qualifiedBy

public abstract Class<? extends Annotation>[] qualifiedBy

A qualifier can be specified to aid the selection process of a suitable mapper. This is useful in case multiple mappers (hand written of internal) qualify and result in an 'Ambiguous mapping methods found' error. A qualifier is a custom annotation and can be placed on either a hand written mapper class or a method.

Returns:

the qualifiers

Default:

{}

elementTargetType

public abstract Class<?> elementTargetType

Specifies the type of the element to be used in the result of the mapping method in case multiple mapping methods qualify.

Returns:

the elementTargetType to select

Default:

void.class

nullValueMappingStrategy

public abstract NullValueMappingStrategy nullValueMappingStrategy

The strategy to be applied when null is passed as source value to this iterable mapping. If no strategy is configured, the strategy given via MapperConfig.nullValueMappingStrategy() or Mapper.nullValueMappingStrategy() will be applied, using NullValueMappingStrategy.RETURN_NULL by default.

Returns:

The strategy to be applied when null is passed as source value to the methods of this mapping.

Default:

org.mapstruct.NullValueMappingStrategy.RETURN_NULL