Over a million developers have joined DZone.

IntelliJ IDEA 2017.1 EAP Extends Debugger with Async Stack Traces

DZone's Guide to

IntelliJ IDEA 2017.1 EAP Extends Debugger with Async Stack Traces

Reactive programming allows us to build efficient applications, but these applications are very difficult to write and debug. IntelliJ IDEA's new

· Performance Zone ·
Free Resource

Get the Edge with a Professional Java IDE. 30-day free trial.

Following the reactive programming trend, our code is getting more asynchronous. Earlier, Java 8 introduced CompletableFuture (adopted from Guava’s ListenableFuture). Akka, Ratpack, Reactor, RxJava, Vert.x, and other libraries implement Reactive Streams, Scala offers Future, Kotlin is adding Coroutines, and finally, Java 9 is about to bring us the Flow. Well, reactive programming helps us build efficient applications, but boy, are they difficult to write and debug.

Consider this sample (courtesy of Tomasz Nurkiewicz):

If we put a breakpoint here, the stack trace will look somewhat like this:

Instead of the place where we invoke CompletableFuture.supplyAsync  (S2_Creating.supplyAsync), we’re looking at ForkJoinPool.runWorker (an executor service that runs code asynchronously) and all of its internals. This makes it harder to understand the data flow and also makes it almost impossible to navigate to relevant frames.

IntelliJ IDEA 2017.1 helps us here with its a new Debugger feature called Capture, which alters the stack trace by substituting its parts related to the asynchronous code execution (receiver) with the corresponding parts of the stack trace captured from where the asynchronous code is passed (sender).

For this feature to work, IntelliJ IDEA needs to know exact signatures of methods used for sending and receiving data (asynchronous code), along with an expression that represents the data being sent.

IntelliJ IDEA 2017.1 EAP offers the following settings to configure this (Settings > Build, Execution, Deployment > Debugger > Capture):

Right now, you have to manually configure this, but later, we may provide a predefined configuration for the most popular libraries. Please let us know which libraries you would like to have on this list.

Once all the requirements have been met, IntelliJ IDEA will display the adapted stack traces:

For better clarity, you can filter out the library frames:


The substituted parts of stack trace display local variables (without object fields, though):

It’s important to know that this feature may affect performance because it collects additional data during execution.

This feature is already available in the newly-released IntelliJ IDEA 2017.1 EAP build.

The way the feature works, as well as the way it’s configured, are in active development. We appreciate any feedback that may help us improve this feature. Share your ideas as well as bug reports here in the comments or directly in the issue tracker.

In other news, we’ve added a new option to the Diff dialog. It ignores imports and formatting and, as its name says, it ignores changes within import statements and whitespaces (at the same time it respects whitespaces within String literals):

Hope you find this useful!

Get the Java IDE that understands code & makes developing enjoyable. Level up your code with IntelliJ IDEA. Download the free trial.

reactive programming ,debugging ,intellij idea ,performance

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}