2
+ − 1
Working on JConsole Using the NetBeans IDE
+ − 2
+ − 3
This JConsole NetBeans project allows a developer interested in making changes
+ − 4
to and/or fixing bugs in the jconsole tool to modify, build, run and test
+ − 5
jconsole in a standalone manner as well as generating the javadoc for the
+ − 6
JConsole plugin API.
+ − 7
+ − 8
README FIRST
+ − 9
+ − 10
make/netbeans/README to get started with NetBeans IDE and OpenJDK, and
+ − 11
working with the OpenJDK NetBeans projects.
+ − 12
+ − 13
WORKING WITH JCONSOLE
+ − 14
+ − 15
JConsole doesn't contain native code. It's a pure java tool. You don't need to
+ − 16
have all the Java SE sources to work on JConsole but just the following subset:
+ − 17
+ − 18
make/netbeans/
+ − 19
src/share/classes/com/sun/tools/jconsole/
+ − 20
src/share/classes/sun/tools/jconsole/
+ − 21
test/TEST.ROOT
+ − 22
test/sun/tools/jconsole/
+ − 23
+ − 24
The set of actions supported by this project are:
+ − 25
+ − 26
* Build Project:
+ − 27
+ − 28
- Compiles JConsole's source files and puts the class files under
+ − 29
build/${platform}-${arch}/classes.
+ − 30
+ − 31
- Generates JConsole's jar file under dist/lib/jconsole.jar
+ − 32
+ − 33
This new jar file could be used to patch an existing JDK installation
+ − 34
by replacing the jar file at <jdk-home>/lib/jconsole.jar, then calling
+ − 35
<jdk-home>/bin/jconsole will make use of the new jar file.
+ − 36
+ − 37
* Generate Javadoc for Project
+ − 38
+ − 39
- Generates the javadoc for the JConsole Plugin API source files,
+ − 40
i.e. the ones under src/share/classes/com/sun/tools/jconsole.
+ − 41
+ − 42
- The javadoc is generated under build/${platform}-${arch}/javadoc/jconsole.
+ − 43
+ − 44
* Test Project
+ − 45
+ − 46
- Runs the JConsole jtreg unit tests located under test/sun/tools/jconsole.
+ − 47
+ − 48
- The test results are written under
+ − 49
+ − 50
build/${platform}-${arch}/jtreg/jconsole
+ − 51
+ − 52
and the HTML test report can be found at
+ − 53
+ − 54
build/${platform}-${arch}/jtreg/jconsole/JTreport/report.html
+ − 55
+ − 56
* Run Project
+ − 57
+ − 58
- Runs the newly built JConsole tool.
+ − 59
+ − 60
* Clean Project
+ − 61
+ − 62
- Cleans the files created by this projet under build and dist.
+ − 63
+ − 64
IMPORTANT NOTE
+ − 65
+ − 66
Please make sure to follow carefully the governance rules documented at
+ − 67
http://openjdk.dev.java.net/