Skip to content
A simple scripting frontend for the Java Debugger Interface
Branch: master
Clone or download
Latest commit f3768f2 Sep 24, 2017
Type Name Latest commit message Commit time
Failed to load latest commit information.
src add FunctionalInterface annotations Mar 16, 2014
LICENSE.txt Update Mar 16, 2014
build.xml 2-space indents Jan 2, 2011

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());

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.

You can’t perform that action at this time.