A simple scripting frontend for the Java Debugger Interface
Java
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
LICENSE.txt
README.md
build.xml

README.md

jdiscript is an elegant wrapper for a more civilized Java Debugger Interface. It allows you to write scripts that use the JDI to control and inspect almost anything happening inside a running JVM. Think of it as similar to DTrace, but with more Java-specific flexibility and the ability to use a JVM language for scripting.

Here's how you'd print out a stack trace any time a thread tried to enter a monitor already owned by another thread:

VirtualMachine vm = new VMSocketAttacher(12345).attach();
JDIScript j = new JDIScript(vm);

j.monitorContendedEnterRequest(e -> {
    j.printTrace(e, "ContendedEnter for "+e.monitor());
}).enable();

j.run();

For more, see the included examples.

jdiscript provides

jdiscript was originally focused on providing an API that you would use from languages like Groovy, JRuby, or Clojure, under the belief that Java itself was too verbose for a nice scripting experience. With Java 8, this has changed, and straight Java is now compact enough that it might not be worth the overhead of switching to another language. All examples that ship with jdiscript have been converted to Java 8.

Note: you need to have the jdk's tools.jar on your classpath in order to use the JDI.