В разработке Java сопоставление объектов является распространенной и важной задачей. Будучи мощной средой сопоставления объектов, MapStruct повышает эффективность разработки за счет упрощения написания кода сопоставления. Однако в практических приложениях мы часто сталкиваемся с ситуацией, когда в исходном или целевом объекте существуют значения Null. В этой статье будут рассмотрены некоторые особенности аннотации @Mapping в MapStruct, особенно то, как корректно обрабатывать значения Null в процессе сопоставления.

1. Знакомство с аннотацией @Mapping

Аннотация @Mapping — важный инструмент в MapStruct для настройки отношений сопоставления полей. С помощью аннотации @Mapping мы можем указать связь сопоставления полей между исходным объектом и целевым объектом, включая имена полей, методы преобразования и другую информацию. При работе с нулевыми значениями аннотация @Mapping предоставляет несколько мощных опций, делающих процесс сопоставления более гибким и управляемым.

2. Обработка значения Null исходного объекта.

В процессе сопоставления значение Null в исходном объекте может привести к тому, что соответствующее поле в результате сопоставления также станет нулевым. Чтобы избежать этой ситуации, вы можете использовать атрибут источника аннотации @Mapping, чтобы указать значение по умолчанию. Если поле исходного объекта имеет значение NULL, для сопоставления будет использоваться указанное значение по умолчанию.

@Mapper
public interface MyMapper {

    @Mapping(source = "sourceField", target = "targetField", defaultValue = "defaultValue")
    TargetObject map(SourceObject source);
}

3. Обработка значения Null целевого объекта.

Аналогично, значения Null в целевом объекте также могут потребовать специальной обработки. С помощью атрибута target аннотации @Mapping мы можем указать, что, если поле исходного объекта имеет значение Null, для поля целевого объекта установлено определенное значение.

@Mapper
public interface MyMapper {

    @Mapping(source = "sourceField", target = "targetField", nullValuePropertyMappingStrategy = NullValuePropertyMappingStrategy.SET_TO_DEFAULT)
    TargetObject map(SourceObject source);
}

4. Настройте стратегию обработки нулевых значений.

Помимо использования значений по умолчанию и установки полей целевого объекта в значения по умолчанию, MapStruct также поддерживает пользовательские стратегии обработки значений Null. Настроив атрибут nullValueCheckStrategy в аннотации @Mapper, мы можем указать собственный класс стратегии, чтобы определить, как обрабатывать значения Null в процессе сопоставления.

@Mapper(nullValueCheckStrategy = NullValueCheckStrategy.ALWAYS)
public interface MyMapper {

    @Mapping(source = "sourceField", target = "targetField")
    TargetObject map(SourceObject source);
}

5. Проверка значений Null при неявных преобразованиях

MapStruct также предоставляет один из вариантов nullValueCheckStrategy: NullValueCheckStrategy.ON_IMPLICIT_CONVERSION. Эта опция указывает, что при выполнении неявных преобразований сопоставления проверяются нулевые значения, чтобы обеспечить надежность результатов сопоставления. В MapStruct,Неявное преобразование относится к выполнению сопоставления полей.,MapStruct попытается автоматически выполнить преобразование типов.,Чтобы адаптироваться к типу целевого объектного поля. Например,если источникобъект Тип поляIntegerИ цельобъект Тип поляString,MapStructпостараюсьIntegerЗначения типа неявно преобразуются вStringтип。

когда КонфигурацияnullValueCheckStrategyдляNullValueCheckStrategy.ON_IMPLICIT_CONVERSIONчас,MapStruct проверяет, имеет ли поле исходного объекта значение NULL при выполнении неявного преобразования. Если поле исходного объекта имеет значение null,MapStruct гарантирует отсутствие неявных преобразований.,и соответствующим образом обрабатывать результаты сопоставления,Предотвратите исключения NullPointerException во время преобразования.

Например:

@Mapper(nullValueCheckStrategy = NullValueCheckStrategy.ON_IMPLICIT_CONVERSION)
public interface MyMapper {

    @Mapping(source = "sourceIntegerField", target = "targetStringField")
    TargetObject map(SourceObject source);
}

В приведенном выше примере,еслиsourceIntegerFieldдляnull,MapStructвыполню картографированиечас Проверьте и убедитесь, что нетпостараюсьnullЗначение неявно преобразуется вtargetStringField,Таким образом избегая потенциального исключения NullPointerException.

6. Резюме

Аннотация @Mapping MapStruct предоставляет разработчикам гибкий способ обработки значений Null в процессе сопоставления. Будь то установка значений по умолчанию, установка полей целевого объекта в качестве значений по умолчанию, настройка стратегий обработки нулевых значений и проверка нулевых значений в неявных преобразованиях, это может удовлетворить потребности различных сценариев. В практических приложениях выбор соответствующего метода обработки в соответствии с конкретной ситуацией может сделать процесс отображения более управляемым и повысить надежность и удобство сопровождения кода. Рационально используя функции MapStruct, мы можем элегантно и эффективно решить проблему нулевых значений при сопоставлении объектов.

Последующие статьи будут обновляться...

Выпущен недавно.