Универсальная монада XResult для Java

Для функционального программирования в Java достаточно одной монады XResult<T>, заменяющей Optional, Result и Either. Эта монада обрабатывает различные типы отказов, включая отсутствие значений, исключения и специфические ошибки. XResult предоставляет два основных варианта: Ok для успешного результата и Err для ошибки, содержащей причину типа ErrCause.
Универсальная монада XResult для Java
Изображение носит иллюстративный характер

ErrCause — расширяемый интерфейс для описания ошибок. Включает реализации: ExceptionCause для исключений, FilterCause для ошибок фильтрации, SimpleCause для текстовых сообщений. Отсутствие NullCause компенсируется созданием ExceptionCause с NullPointerException для обнаружения null. Метод fromCallable() автоматически оборачивает результаты и ошибки в XResult, обрабатывая исключения и null.

Монада XResult обеспечивает композицию с помощью map(), flatMap(), filter(). Пример: получение пользователя может возвращать XResult.ofNullable(user) при успехе, XResult.err(exception) при исключении, XResult.err("HTTP error 401") при HTTP-ошибках. Можно расширить ErrCause классом HttpError для подробной информации об ошибках HTTP.

XResult легко внедряется в легаси проекты и создает безопасные API. Компактный и самодостаточный код (260 строк) без внешних зависимостей покрыт тестами. Разработан для Java 8, но совместим с более новыми версиями. В будущем возможно применение sealed интерфейсов, records и pattern matching для большей лаконичности кода.


Новое на сайте

20065[b]СПКЯ стало СПМЯ: почему переименование болезни, затрагивающей миллионы женщин, заняло... 20064[b]Почему великая пирамида Гизы пережила все землетрясения за 4500 лет[/b] 20063[b]Генетика Homo erectus: что зубная эмаль рассказала о наших предках[/b] 20062[b]Кости в бухте эребус: что кости моряков Франклина рассказывают спустя полтора века[/b] 20061[b]Крупнейший плавучий ветрогенератор в мире: Китай испытывает установку у берегов... 20060[b]Карие глаза младенца стали индиго после лечения от COVID-19[/b] 20058[b]Почему серебряная чаша с Афиной пролежала в немецком лесу две тысячи лет?[/b] 20057[b]Дыра в атмосфере солнца: вспышка достигла пика и может зажечь полярное сияние[/b] 20056[b]Динго возрастом 950 лет: кто и зачем кормил могилу животного сотни лет?[/b] 20055[b]Томоэ гозэн: женщина-самурай, которая существовала на самом деле[/b] 20054[b]Что видели астронавты «Аполлона-12» над лунным горизонтом?[/b] 20053[b]Восковой блокнот на латыни и шёлковая туалетная бумага: кто посещал средневековый... 20052[b]Хантавирус на борту: 41 человек под наблюдением после рейса MV Hondius[/b] 20051[b]Зелёные камни в пещере Пиренеев: четыре тысячи лет медной металлургии[/b]
Ссылка