Skip to content

A simple scripting frontend for the Java Debugger Interface

Notifications You must be signed in to change notification settings

StareInTheAir/jdiscript

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

94 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

A simple scripting frontend for the Java Debugger Interface

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 100.0%