0N/AWorking On Java[TM] Management Extensions (JMX[TM)) Using NetBeans IDE

0N/A

0N/AREADME FIRST

0N/A

0N/A make/netbeans/README for getting started with NetBeans IDE and OpenJDK,

0N/A and workings with OpenJDK NetBeans projects.

0N/A

0N/AThis README focusses on working on the OpenJDK JMX API using NetBeans IDE.

0N/A

0N/A This NetBeans project for OpenJDK JMX allows you to modify, build, and test

0N/A the JMX API in a standalone manner. It can also be used to generate

0N/A the JMX API documentation for preview.

0N/A

0N/A The JMX API does not contain native code. It is a pure java library.

0N/A You do not need to install all the Java SE sources to work on JMX,

0N/A you only need the following subset:

0N/A

0N/A make/netbeans/

0N/A src/share/classes/com/sun/jmx/

0N/A src/share/classes/javax/management/

0N/A test/TEST.ROOT

0N/A test/com/sun/management/

0N/A test/java/lang/management/

0N/A test/javax/management/

0N/A

0N/A If you don't want to build the whole JDK, you will also need a

0N/A pre-built version of OpenJDK (or JDK 7). Edit your

0N/A

0N/A $HOME/.openjdk/build.properties

0N/A

0N/A file (create it if you don't have one yet) and set the bootstrap.jdk variable

0N/A point to that JDK:

0N/A

0N/A bootstrap.jdk=<JDK_7_HOME>

0N/A

0N/A Then from within NetBeans IDE open the JMX project, and invoke the

0N/A "Build Project" and "Test Project" target. Note that running all the

0N/A tests for JMX takes a while. The build may also fail if it doesn't

0N/A find a directory named src/${platform}. This may happen if you haven't

0N/A installed all OpenJDK sources. In this case, you can simply

0N/A create an empty directory with the name expected by the build mechanism.

0N/A

0N/A Which tests are run are defined by the jtreg.test variable declared

0N/A in make/netbeans/jmx/build.properties. Note that JMX tests are all

0N/A placed under test/javax/management/. test/java/lang/management/

0N/A and test/com/sun/management/ contain some tests that happen to

0N/A use JMX and we therefore recommend to run these tests too.

0N/A

0N/A If you are working on a JMX fix, don't forget to create a

0N/A corresponding jtreg unit test under test/javax/management/.

0N/A You can look at existing tests to see how this is done.

0N/A

0N/AThe set of actions defined in this project are:

0N/A

0N/A* Build Project:

0N/A

0N/A - Compiles JMX API source files and puts the class files under

0N/A build/${platform}-${arch}/classes.

0N/A

0N/A - Generates a JMX jar file under dist/lib/jmx.jar. To use your modified

0N/A JMX classes instead of the built-in JDK classes you will need

0N/A to put this jar file in front of the bootclasspath:

0N/A

0N/A java -Xbootclasspath/p:dist/lib/jmx.jar mytestapp.MyAppMainClass

0N/A

0N/A* Generate Javadoc for Project

0N/A

0N/A - Generates the JMX API Documentation under

0N/A

0N/A build/${platform}-${arch}/javadoc/jmx.

0N/A

0N/A* Test Project

0N/A

0N/A - Runs the JMX and Management and Monitoring jtreg unit tests.

0N/A

0N/A - The results are written under build/${platform}-${arch}/jtreg/jmx

0N/A and the HTML test report can be found at

0N/A build/${platform}-${arch}/jtreg/jmx/JTreport/report.html.

0N/A

0N/A* Clean Project

0N/A

0N/A - Cleans the files created by this projet under build/

0N/A Some files may remain.

0N/A

0N/A

0N/AIMPORTANT NOTE

0N/A

0N/A Please make sure to follow carefully the governance rules documented at

0N/A http://openjdk.dev.java.net/

0N/A