Add since tag to new API elements

This commit is contained in:
Filip Hrisafov 2018-11-24 02:07:31 +01:00
parent a3ba57c372
commit 9a43b210d3
9 changed files with 19 additions and 0 deletions

View File

@ -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.
*/

View File

@ -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.
*/

View File

@ -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.
*/

View File

@ -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.
*/

View File

@ -16,6 +16,7 @@ package org.mapstruct;
* {@code @}{@link MappingTarget}).
*
* @author Sjaak Derksen
* @since 1.3
*/
public enum NullValuePropertyMappingStrategy {

View File

@ -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) {

View File

@ -12,6 +12,8 @@ import javax.lang.model.element.ExecutableElement;
* Holder for the builder information.
*
* @author Filip Hrisafov
*
* @since 1.3
*/
public class BuilderInfo {

View File

@ -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 {

View File

@ -15,6 +15,8 @@ import javax.lang.model.util.Types;
*
* @author Filip Hrisafov
* @see javax.annotation.processing.ProcessingEnvironment
*
* @since 1.3
*/
public interface MapStructProcessingEnvironment {