Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 Из всех CRUD-операций, обновление сложнее всего реализовать правильно. В этом уроке вы узнаете, как правильно написать код для обновления сущностей с возможностью делать это частично.

2 Предположим, что мы написали такой код для обновления сущности Post:

3 При этом код DTO выглядит так:

4 Код маппера выглядит так:

5 Представим, что мы отправляем такой JSON в этот API:

6 В коде выше мы не передали body, поэтому в DTO это свойство будет равно null. Это значит, что при копировании данных из DTO в объект post оригинальное значение будет стерто.

7 Такая реализация обновления работает только тогда, когда передаются все поля, указанные в DTO. На практике это порождает проблемы при одновременных обновлениях от разных клиентов - клиенты будут стирать данные друг друга.

8 Кажется, что проблема решилась бы, если перед установкой значения мы проверили бы его на наличие null:

9 На самом деле, этот способ не сработает, потому что может быть ситуация, при которой мы действительно передали такое значение в JSON:

10 Эта ситуация возникает из-за того, что у свойств в объектах есть только два возможных значения:

11 <ul><li>Либо null</li>

12 <li>Либо какое-то конкретное значение</li>

13 </ul>Если в DTO оказался null, что это значит? Возможны два варианта:

14 <ul><li>Либо null действительно пришел в JSON снаружи</li>

15 <li>Либо свойство не было установлено вообще</li>

16 </ul>В таких условиях мы не можем с уверенностью сказать, какой вариант правильный.

17 Решить эту проблему можно с помощью модуля<a>jackson-databind-nullable</a>в связке с MapStruct.

18 Обсудим принцип работыjackson-databind-nullableподробнее. Сначала мы оборачиваем в класс JsonNullable какое-то свойство, которое может отсутствовать. Дальше применяется следующая логика:

19 <ul><li>Если в свойстве находится явный null, значение удалено явно</li>

20 <li>Если в свойстве находится JsonNullable.undefined(), значение не передано - его нужно игнорировать</li>

21 <li>Если в свойстве находится реальное значение, обернутое в JsonNullable, то нужно его использовать</li>

22 </ul>Пройдем весь путь подключения этой библиотеки к проекту и MapStruct.

23 <h2>Установка</h2>

24 Для начала библиотеку нужно установить:

25 Сам модуль подключается к Jackson с помощью конфигурационного класса:

26 <h2>Подключение к DTO</h2>

27 JacksonNullable подключается к опциональным свойствам DTO, то есть эти свойства могут быть пропущены при формировании JSON с клиентской стороны:

28 <h2>Подключение к MapStruct</h2>

29 По умолчанию MapStruct ничего не знает о JsonNullable. Чтобы добавить нужную нам условную логику, проверяющую наличие реального значения, надо добавить специальный маппер:

30 Это универсальный маппер, который можно подключить к любым другим мапперам. В нашей ситуации он понадобится для реализации маппера PostMapper:

31 После такого изменения реализация метода update() в сгенерированном маппере значительно меняется:

32 <h2>Валидация</h2>

33 Как в таком случае использовать валидацию? Валидация же должна применяться к оригинальному значению, а не свойству в целом - иначе мы не сможем использовать null как значение. Хорошая новость в том, что это происходит автоматически. Все добавленные аннотации применяются не к обертке, а к тому, что находится внутри нее. Соответственно, если значение не передано, то и валидация не применяется. Значит, мы можем писать так: