| 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/
|
|---|
