Отладка реактивных потоков в Spring 5

Отладкаreactive streams, вероятно, является одной из основных проблем, с которыми нам придется столкнуться, когда мы начнем использовать эти структуры данных.

И учитывая, что реактивные потоки набирают популярность в последние годы, неплохо было бы узнать, как мы можем эффективно выполнить эту задачу.

Давайте начнем с настройки проекта с использованием реактивного стека, чтобы понять, почему это часто вызывает проблемы.

Мы хотим смоделировать реальный сценарий, когда выполняется несколько асинхронных процессов, и в котором мы внесли некоторые дефекты в код, которые в конечном итоге вызовут исключения.

Чтобы понять общую картину, мы упомянем, что наше приложение будет потреблять и обрабатывать потоки простых объектовFoo, которые содержат толькоid, aformattedName иquantityполе s. Для более подробной информации посмотритеon the project here.

Один из вариантов выяснить, что происходит с нашим приложением, - это запустить сеанс отладки с помощью нашей любимой IDE.

Нам нужно будет установить несколько условных точек останова и проанализировать поток данных при выполнении каждого шага в потоке.

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

Кроме того, во многих случаях мы не можем запустить сеанс отладки по соображениям безопасности.

Иногдаwe can add useful context information, by providing a Consumer as a second parameter of the subscribe method:

Примечание. Стоит упомянуть, что если нам не нужно выполнять дальнейшую обработку методаsubscribe, мы можем связать функциюdoOnError с нашим издателем:

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

БиблиотекаReactor предоставляет классHooks, который позволяет нам настраивать поведение операторовFlux иMono.

By just adding the following statement, our application will instrument the calls to the to the publishers' methods, wrap the construction of the operator, and capture a stack trace:

После активации режима отладки наши журналы исключений будут содержать некоторую полезную информацию:

Как мы видим, первый раздел остается относительно тем же, но следующие разделы предоставляют информацию о:

Примечание. В этом примере, чтобы наглядно это увидеть, мы добавляем операции для разных классов.

Мы можем включить или выключить режим отладки в любое время, но это не повлияет на объектыFlux иMono, для которых уже созданы экземпляры.

Инструментарий и генерация трассировки стека в каждом реактивном процессе являются дорогостоящими.

Таким образом,we should implement the former approach only in critical cases.

Во всяком случае,Reactor provides a way to enable the debug mode on single crucial processes, which is less memory-consuming.

Мы имеем в виду операторcheckpoint:

Обратите внимание, что таким образом трассировка сборки будет регистрироваться на этапе контрольной точки:

Мы должны реализовать методcheckpoint ближе к концу реактивной цепочки.

В противном случае оператор не сможет наблюдать ошибки, возникающие ниже по потоку.

Также отметим, что библиотека предлагает перегруженный метод. Мы можем избежать:

Наконец, издатели Reactor предлагают еще один метод, который в некоторых случаях может пригодиться.

By calling the log method in our reactive chain, the application will log each element in the flow with the state that it has at that stage.

Давайте попробуем это на нашем примере:

И проверьте логи:

Мы можем легко увидеть состояние каждого объектаFoo на этом этапе и то, как фреймворк отменяет поток при возникновении исключения.

Конечно, этот подход также требует больших затрат, и мы должны использовать его умеренно.

Мы можем потратить много времени и усилий на устранение неполадок, если не знаем инструментов и механизмов для правильной отладки нашего приложения.

Это особенно верно, если мы не привыкли обрабатывать реактивные и асинхронные структуры данных и нам нужна дополнительная помощь, чтобы понять, как все работает.

Как всегда, полный пример доступен наGitHub repo.