91 lines
3.1 KiB
Plaintext
91 lines
3.1 KiB
Plaintext
Working On Java[TM] Management Extensions (JMX[TM)) Using NetBeans IDE
|
|
|
|
README FIRST
|
|
|
|
make/netbeans/README for getting started with NetBeans IDE and OpenJDK,
|
|
and workings with OpenJDK NetBeans projects.
|
|
|
|
This README focusses on working on the OpenJDK JMX API using NetBeans IDE.
|
|
|
|
This NetBeans project for OpenJDK JMX allows you to modify, build, and test
|
|
the JMX API in a standalone manner. It can also be used to generate
|
|
the JMX API documentation for preview.
|
|
|
|
The JMX API does not contain native code. It is a pure java library.
|
|
You do not need to install all the Java SE sources to work on JMX,
|
|
you only need the following subset:
|
|
|
|
make/netbeans/
|
|
src/share/classes/com/sun/jmx/
|
|
src/share/classes/javax/management/
|
|
test/TEST.ROOT
|
|
test/com/sun/management/
|
|
test/java/lang/management/
|
|
test/javax/management/
|
|
|
|
If you don't want to build the whole JDK, you will also need a
|
|
pre-built version of OpenJDK (or JDK 7). Edit your
|
|
|
|
$HOME/.openjdk/build.properties
|
|
|
|
file (create it if you don't have one yet) and set the bootstrap.jdk variable
|
|
point to that JDK:
|
|
|
|
bootstrap.jdk=<JDK_7_HOME>
|
|
|
|
Then from within NetBeans IDE open the JMX project, and invoke the
|
|
"Build Project" and "Test Project" target. Note that running all the
|
|
tests for JMX takes a while. The build may also fail if it doesn't
|
|
find a directory named src/${platform}. This may happen if you haven't
|
|
installed all OpenJDK sources. In this case, you can simply
|
|
create an empty directory with the name expected by the build mechanism.
|
|
|
|
Which tests are run are defined by the jtreg.test variable declared
|
|
in make/netbeans/jmx/build.properties. Note that JMX tests are all
|
|
placed under test/javax/management/. test/java/lang/management/
|
|
and test/com/sun/management/ contain some tests that happen to
|
|
use JMX and we therefore recommend to run these tests too.
|
|
|
|
If you are working on a JMX fix, don't forget to create a
|
|
corresponding jtreg unit test under test/javax/management/.
|
|
You can look at existing tests to see how this is done.
|
|
|
|
The set of actions defined in this project are:
|
|
|
|
* Build Project:
|
|
|
|
- Compiles JMX API source files and puts the class files under
|
|
build/${platform}-${arch}/classes.
|
|
|
|
- Generates a JMX jar file under dist/lib/jmx.jar. To use your modified
|
|
JMX classes instead of the built-in JDK classes you will need
|
|
to put this jar file in front of the bootclasspath:
|
|
|
|
java -Xbootclasspath/p:dist/lib/jmx.jar mytestapp.MyAppMainClass
|
|
|
|
* Generate Javadoc for Project
|
|
|
|
- Generates the JMX API Documentation under
|
|
|
|
build/${platform}-${arch}/javadoc/jmx.
|
|
|
|
* Test Project
|
|
|
|
- Runs the JMX and Management and Monitoring jtreg unit tests.
|
|
|
|
- The results are written under build/${platform}-${arch}/jtreg/jmx
|
|
and the HTML test report can be found at
|
|
build/${platform}-${arch}/jtreg/jmx/JTreport/report.html.
|
|
|
|
* Clean Project
|
|
|
|
- Cleans the files created by this projet under build/
|
|
Some files may remain.
|
|
|
|
|
|
IMPORTANT NOTE
|
|
|
|
Please make sure to follow carefully the governance rules documented at
|
|
http://openjdk.dev.java.net/
|
|
|