[SnowOne 2025] Артём Бояршинов: Fluent API на Java

Вы замечали, что при использовании одних библиотек вам постоянно приходится копаться в исходниках, штудировать Javadocs, а при использовании других — код будто сам пишется, и нужные методы выпрыгивают в подсказках IDE? Это происходит из-за разных подходов к проектированию API. Такие API, в которых последовательный вызов методов выстраивается в цепочку, формируя DSL-библиотеки, называются Fluent API.

Из доклада вы узнаете, почему Fluent API — это больше чем Builder. Рассмотрим различные приемы проектирования Fluent API на примере популярных библиотек: Spring Security, AssertJ, Awaitility и других. Напишем свой небольшой Fluent API.

Видео: https://youtu.be/iamsGOHNpCo

Transcript

1. Fluent API на Java
2. Артём Бояршинов - Software developer - СБП - Система быстрых платежей - Был в ПК Podlodka Java Crew 2 https://github.com/Boiarshinov/fluent-api-demo
3. Disclaimer 3
4. Disclaimer 4 GitHub Copilot JetBrains AI Assistant
5. Imperative Java VS Fluent API 5
6. Fluent API - это API, реализующий внутренний DSL, нацеленный на удобство чтения и использования. Martin Fowler 6 https://martinfowler.com/bliki/FluentInterface.html
7. Fluent API • Где используется? • Как написать? • Когда писать? 7
8. Где используется - Поэтапное создание объектов - Конфигурация - Тесты, ассерты 8
9. Где используется 9 - Поэтапное создание объектов - Конфигурация - Тесты, ассерты OkHttp3
10. Где используется 10 Spring Security - Поэтапное создание объектов - Конфигурация - Тесты, ассерты
11. Где используется 11 Kafka Streams - Поэтапное создание объектов - Конфигурация - Тесты, ассерты
12. Где используется 12 Awaitility - Поэтапное создание объектов - Конфигурация - Тесты, ассерты
13. Где используется 13 MockMvc - Поэтапное создание объектов - Конфигурация - Тесты, ассерты
14. Пример 14
15. СБП Прокси / Gateway 15 Клиенты API СБП Бэкенд Т- Банка Бэкенд СБП Proxy / Gateway СПб СБП СПб СБП
16. СБП Прокси / Gateway. Фичи • Список получателей • Балансировка запросов по получателям • Контроль request’ов ◦ Проверка входящего контента на вхождение в черный список • Контроль respons’ов ◦ Замена части исходящего контента 16
17. Как написать Fluent API 17
18. Приёмы Fluent API 18 • Method chaining - последовательный вызов методов • Step interfaces - шаги, регулирующие последовательность и обязательность вызова методов • Смена контекста ◦ С помощью method chaining ◦ С помощью лямбда-выражений • Selftypes - самообобщение
19. Builder 19
20. Stream 20
21. Builder 21 • можно забыть заполнить обязательные поля • случайно можно заполнить одно поле дважды
22. Приёмы Fluent API 22 • Method chaining - последовательный вызов методов • Step interfaces - шаги, регулирующие последовательность и обязательность вызова методов • Смена контекста ◦ С помощью method chaining ◦ С помощью лямбда-выражений • Selftypes - самообобщение
23. Step Interfaces 23
25. Приёмы Fluent API 25 • Method chaining - последовательный вызов методов • Step interfaces - шаги, регулирующие последовательность и обязательность вызова методов • Смена контекста ◦ С помощью method chaining ◦ С помощью лямбда-выражений • Selftypes - самообобщение
26. Fluent API позволяет не знать API, но при этом пользоваться им (с помощью подсказок IDE) 26
28. org.springframework.security:spring-security-config 28
29. io.projectreactor 29
30. Смена контекста 30 • Для визуализации смены контекста нужны отступы • Отступы пропадают при автоформатировании • Паразитные методы and() для переходов между контекстами
31. Приёмы Fluent API 31 • Method chaining - последовательный вызов методов • Step interfaces - шаги, регулирующие последовательность и обязательность вызова методов • Смена контекста ◦ С помощью method chaining ◦ С помощью лямбда-выражений • Selftypes - самообобщение
33. Приёмы Fluent API 33 • Method chaining - последовательный вызов методов • Step interfaces - шаги, регулирующие последовательность и обязательность вызова методов • Смена контекста ◦ С помощью method chaining ◦ С помощью лямбда-выражений • Selftypes - самообобщение
34. 34 https://web.archive.org/web/20090807111719/http://blogs.sun.com/ahe/entry/selftypes AssertJ
35. 35 java.util.stream
36. Когда писать? 36
37. Когда писать? • Фреймворк • Либа для многих команд • PR в Lombok для обязательных полей в Builder :) 37
38. Приёмы Fluent API 38 • Method chaining - последовательный вызов методов • Step interfaces - шаги, регулирующие последовательность и обязательность вызова методов • Смена контекста ◦ С помощью method chaining ◦ С помощью лямбда-выражений • Selftypes - самообобщение • …
39. 39 Спасибо за внимание!