- Published on
Explore JVM class-resolution traces as interactive directed graphs
- Authors
- Name
- DeepHorus
A new open-source tool called ClassTrace Explorer is helping Java developers visualize and understand the complex process of class loading within the JVM. The tool, released as version 2.x, captures a Java application's class-resolution activity and transforms it into an interactive, self-contained HTML graph. This visualization aims to demystify startup behavior, application and runtime boundaries, and dependency coupling, which are often opaque and challenging to debug.
ClassTrace Explorer represents a significant update from earlier versions. It is now written in TypeScript and rendered using the React Flow library, eliminating previous dependencies on Python, Graphviz, and a separate report server. The core requirement is a Node.js 20 or newer environment for building from source, while the built command-line interface (CLI) tool supports Node.js 18 or newer. A JDK is required for capturing the class-loading data from an application.
The tool provides a straightforward workflow for developers. Users launch their Java application with specific JVM logging flags to capture class loads and resolutions, then feed the log file to the CLI. The CLI, maintaining compatibility with the earlier command name clgrapher, generates a single, portable HTML file. This file can be opened directly in any web browser, offering a fully interactive experience without needing a server.
The generated graph offers rich functionality for analysis. Developers can navigate through various scopes, from high-level namespaces down to inner classes and generated lambdas. Nodes are color-coded to distinguish between application, system, dependency, and unknown code origins. Key features include filtering by class name or origin, inspecting detailed metadata like load timing and source locations, and comparing the bytecode footprint of classes. The tool also preserves the directional edges of resolution chains at every level of aggregation.
The project includes practical examples to aid adoption. Its repository contains complete, interactive reports for well-known Java applications like Apache NetBeans and the SwingSet3 demo. These serve as both documentation and proof-of-concept for the tool's capabilities. The project is made available under the permissive BSD 3-Clause License, encouraging community use and contribution.
ClassTrace Explorer is positioned as a valuable diagnostic tool for performance tuning and dependency analysis in complex Java projects. By making the JVM's internal class-loading mechanics visible and navigable, it empowers developers to pinpoint issues like unexpected code loading or tight coupling between modules. Its self-contained HTML output simplifies sharing and reviewing these insights across development teams.
