How oracle/visualvm works
Project type and purpose
• This is a desktop, modular Java application built on the NetBeans Platform. Its purpose is to provide VisualVM, a GUI wrapper around JDK command-line tools (JMX, jstat, jstack, JFR, JVMTI, etc.) with profiling, heap/CPU/threads monitoring and extensibility via plugins.
File‐tree architecture overview
• Top‐level directories:
• integrations/… – IDE integrations (Eclipse, VSCode)
• plugins/… – VisualVM plugin suite
• visualvm/… – core VisualVM suite (NetBeans modules)
• samples/, templates/ – example modules
• Key modules under visualvm/visualvm:
• core/ – bootstrap and module system
• appui/ – platform UI support
• application/ – “Applications” data source
• jmx/, jvmstat/ – JMX and JVM metrics providers
• heapdump/, threaddump/, coredump/, jfr/ – snapshot providers
• charts/, caching.api/ – support libraries
• profiler/, sampler/, tracer/ – profiling subsystems
Reading the README
• Two suites:
• visualvm/visualvm – core tool built with Ant against NetBeans Platform 22
• visualvm/plugins – plugin suite that loads atop the core distribution
• Build/run commands and dependency on NetBeans platform structure.
Diagramming guidance
• NetBeans Platform Runtime
• Core VisualVM modules (core, caching.api, charts)
• DataSource Providers (application, host, JMX, jstat, JVMTI, JFR, heapdump, threaddump, coredump)
• Profiling Engines (profiler, sampler, tracer)
• UI Viewer modules (applicationviews, heapviewer, jfr views, profiler views)
• Plugin loader and individual plugins (under plugins/)
• External services/tools (JDK tools, native libs, BTrace)
• IDE integrations (Eclipse, VSCode extensions)
• User action → UI Viewer → Model API → DataSource Provider → JDK/JVM APIs/native
• Data flows back → Model → UI
• Plugins register via NetBeans Lookup/Services to extend modules or views
• IDE integrations invoke VisualVM via wrapper & pass args
c. Architectural patterns:
• Modular plugin architecture (NetBeans modules with manifest, layer.xml)
• MVC: UI Viewer modules separate from DataSource and Model layers
• Service Locator (Lookup API) for extensibility
d. Technologies & frameworks:
• Java 8 on Oracle JDK 8
• Apache Ant 1.9.15 build scripts
• NetBeans Platform 22
• JMX, JVMTI, JFR, native profiling APIs, BTrace
• VSCode & Eclipse extension APIs for IDE integrations