From 9a43b210d39bc590d8c9237d13c5c9016199b6b4 Mon Sep 17 00:00:00 2001 From: Filip Hrisafov Date: Sat, 24 Nov 2018 02:07:31 +0100 Subject: [PATCH] Add since tag to new API elements --- core/src/main/java/org/mapstruct/BeanMapping.java | 2 ++ core/src/main/java/org/mapstruct/Mapper.java | 2 ++ core/src/main/java/org/mapstruct/MapperConfig.java | 2 ++ core/src/main/java/org/mapstruct/Mapping.java | 4 ++++ .../java/org/mapstruct/NullValuePropertyMappingStrategy.java | 1 + .../java/org/mapstruct/ap/spi/AccessorNamingStrategy.java | 2 ++ processor/src/main/java/org/mapstruct/ap/spi/BuilderInfo.java | 2 ++ .../src/main/java/org/mapstruct/ap/spi/BuilderProvider.java | 2 ++ .../org/mapstruct/ap/spi/MapStructProcessingEnvironment.java | 2 ++ 9 files changed, 19 insertions(+) diff --git a/core/src/main/java/org/mapstruct/BeanMapping.java b/core/src/main/java/org/mapstruct/BeanMapping.java index b510b442d..6b062dac9 100644 --- a/core/src/main/java/org/mapstruct/BeanMapping.java +++ b/core/src/main/java/org/mapstruct/BeanMapping.java @@ -69,6 +69,8 @@ public @interface BeanMapping { * {@link Mapper#nullValuePropertyMappingStrategy()} will be applied, * {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default. * + * @since 1.3 + * * @return The strategy to be applied when {@code null} is passed as source property value or the source property * is not present. */ diff --git a/core/src/main/java/org/mapstruct/Mapper.java b/core/src/main/java/org/mapstruct/Mapper.java index 64e22ab74..69e70e859 100644 --- a/core/src/main/java/org/mapstruct/Mapper.java +++ b/core/src/main/java/org/mapstruct/Mapper.java @@ -153,6 +153,8 @@ public @interface Mapper { * configured, the strategy given via {@link MapperConfig#nullValuePropertyMappingStrategy()} will be applied, * {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default. * + * @since 1.3 + * * @return The strategy to be applied when {@code null} is passed as source property value or the source property * is not present. */ diff --git a/core/src/main/java/org/mapstruct/MapperConfig.java b/core/src/main/java/org/mapstruct/MapperConfig.java index cd58d70db..e042d4011 100644 --- a/core/src/main/java/org/mapstruct/MapperConfig.java +++ b/core/src/main/java/org/mapstruct/MapperConfig.java @@ -136,6 +136,8 @@ public @interface MapperConfig { * The strategy to be applied when a source bean property is {@code null} or not present. If no strategy is * configured, {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default. * + * @since 1.3 + * * @return The strategy to be applied when {@code null} is passed as source property value or the source property * is not present. */ diff --git a/core/src/main/java/org/mapstruct/Mapping.java b/core/src/main/java/org/mapstruct/Mapping.java index 66f4f825e..01ffcd17a 100644 --- a/core/src/main/java/org/mapstruct/Mapping.java +++ b/core/src/main/java/org/mapstruct/Mapping.java @@ -264,6 +264,8 @@ public @interface Mapping { * * Can be overridden by the one on {@link MapperConfig}, {@link Mapper} or {@link BeanMapping}. * + * @since 1.3 + * * @return strategy how to do null checking */ NullValueCheckStrategy nullValueCheckStrategy() default ON_IMPLICIT_CONVERSION; @@ -276,6 +278,8 @@ public @interface Mapping { * * {@link NullValuePropertyMappingStrategy#SET_TO_NULL} will be used by default. * + * @since 1.3 + * * @return The strategy to be applied when {@code null} is passed as source property value or the source property * is not present. */ diff --git a/core/src/main/java/org/mapstruct/NullValuePropertyMappingStrategy.java b/core/src/main/java/org/mapstruct/NullValuePropertyMappingStrategy.java index 41ee737d0..c9182938f 100644 --- a/core/src/main/java/org/mapstruct/NullValuePropertyMappingStrategy.java +++ b/core/src/main/java/org/mapstruct/NullValuePropertyMappingStrategy.java @@ -16,6 +16,7 @@ package org.mapstruct; * {@code @}{@link MappingTarget}). * * @author Sjaak Derksen + * @since 1.3 */ public enum NullValuePropertyMappingStrategy { diff --git a/processor/src/main/java/org/mapstruct/ap/spi/AccessorNamingStrategy.java b/processor/src/main/java/org/mapstruct/ap/spi/AccessorNamingStrategy.java index e4dd2cfe2..c9d073475 100644 --- a/processor/src/main/java/org/mapstruct/ap/spi/AccessorNamingStrategy.java +++ b/processor/src/main/java/org/mapstruct/ap/spi/AccessorNamingStrategy.java @@ -19,6 +19,8 @@ public interface AccessorNamingStrategy { * Initializes the accessor naming strategy with the MapStruct processing environment. * * @param processingEnvironment environment for facilities + * + * @since 1.3 */ default void init(MapStructProcessingEnvironment processingEnvironment) { diff --git a/processor/src/main/java/org/mapstruct/ap/spi/BuilderInfo.java b/processor/src/main/java/org/mapstruct/ap/spi/BuilderInfo.java index 1e55bef95..0f9556748 100644 --- a/processor/src/main/java/org/mapstruct/ap/spi/BuilderInfo.java +++ b/processor/src/main/java/org/mapstruct/ap/spi/BuilderInfo.java @@ -12,6 +12,8 @@ import javax.lang.model.element.ExecutableElement; * Holder for the builder information. * * @author Filip Hrisafov + * + * @since 1.3 */ public class BuilderInfo { diff --git a/processor/src/main/java/org/mapstruct/ap/spi/BuilderProvider.java b/processor/src/main/java/org/mapstruct/ap/spi/BuilderProvider.java index c755c63f2..419c85a39 100644 --- a/processor/src/main/java/org/mapstruct/ap/spi/BuilderProvider.java +++ b/processor/src/main/java/org/mapstruct/ap/spi/BuilderProvider.java @@ -11,6 +11,8 @@ import javax.lang.model.type.TypeMirror; * A service provider interface that is used to detect types that require a builder for mapping. This interface could * support automatic detection of builders for projects like Lombok, Immutables, AutoValue, etc. * @author Filip Hrisafov + * + * @since 1.3 */ public interface BuilderProvider { diff --git a/processor/src/main/java/org/mapstruct/ap/spi/MapStructProcessingEnvironment.java b/processor/src/main/java/org/mapstruct/ap/spi/MapStructProcessingEnvironment.java index 97fd42148..0471108a5 100644 --- a/processor/src/main/java/org/mapstruct/ap/spi/MapStructProcessingEnvironment.java +++ b/processor/src/main/java/org/mapstruct/ap/spi/MapStructProcessingEnvironment.java @@ -15,6 +15,8 @@ import javax.lang.model.util.Types; * * @author Filip Hrisafov * @see javax.annotation.processing.ProcessingEnvironment + * + * @since 1.3 */ public interface MapStructProcessingEnvironment {