1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/agent/make/marks_notes.html Wed Apr 27 01:25:04 2016 +0800
1.3 @@ -0,0 +1,93 @@
1.4 +<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
1.5 +<html>
1.6 + <head>
1.7 + <title>Hotspot SA User Interface Notes</title>
1.8 + </head>
1.9 +
1.10 + <body>
1.11 + <h1>Hotspot SA User Interface Notes</h1>
1.12 +
1.13 + <h2>Workspace and Building</h2>
1.14 +
1.15 + <p>
1.16 + All the source code for the Serviceability Agent is in
1.17 + <code>src/share/vm/agent</code> in the HotSport workspace
1.18 + <code>/net/jano.sfbay/export/disk05/hotspot/ws/1.4/sa_baseline</code>
1.19 + <p>
1.20 + You can build the project by typing <code>gnumake</code> in the
1.21 + <code>src/share/vm/agent</code> directory.
1.22 + <p>
1.23 + You can also use the default build target using the Ant build file (build.xml). You can download Ant from
1.24 + <a href="http://jakarta.apache.org/ant">http://jakarta.apache.org/ant</a>. Documentation for Ant can be
1.25 + found at <a href="http://jakarta.apache.org/ant/manual/index.html">http://jakarta.apache.org/ant/manual/index.html</a>
1.26 +
1.27 +
1.28 + <h2>Running the project</h2>
1.29 +
1.30 + <ul>
1.31 + <li><code>java -cp classes sun.jvm.hotspot.HSDB</code>
1.32 + </ul>
1.33 +
1.34 + <h2>Feedback</h2>
1.35 + <p>
1.36 + Refactoring of package hierarchy. All user interface components should be in
1.37 + the ui package. Perhaps: sun.jvm.hotspot.ui.hsdb.Main for the HSDB.
1.38 + <p>
1.39 + The src\share\vm\agent area seems like a workspace so it should be organized like
1.40 + one. In particular, I'd like to suggest the following directory layout:<br>
1.41 +
1.42 + <ul>
1.43 + <li>src: All sources that are curently under the sun directory.
1.44 + <li>classes: compiled class files.
1.45 + <li>lib: Resources like images, icons and jar files.
1.46 + <li>docs: Documentation
1.47 + <li>deploy: distribution bundles for Java Web Start.
1.48 + </ul>
1.49 +
1.50 + <p>
1.51 + Seems like there is a lot of redundant functionality. Perhaps
1.52 + this can be consolidated with a <code>javax.swing.Actions</code> architecture.
1.53 +
1.54 + <h2>Tasklist</h2>
1.55 +
1.56 + <p>
1.57 + <b>Stack memory pane</b>:
1.58 + It's one of the more useful JVM debugging tools in the SA. However, it
1.59 + doesn't support any interaction with the text.
1.60 + <p>
1.61 + <b>Integrations with the NetBeans architecture (plug in).</b> See the
1.62 + <a href="http://openide.netbeans.org">Netbeans Open APIs homepage</a>
1.63 +
1.64 +
1.65 + <p>
1.66 + HSDB: Object Histogram. Column sizes should be sized according the the
1.67 + contents. i.e, The size and count columns should be narrow enought to
1.68 + handle the largest window. Since there is a lot of data, sorting
1.69 + and searching should be implemented.
1.70 + <p>
1.71 +
1.72 + <h2>Log</h2>
1.73 +
1.74 + <i>Last modified: Tue Feb 05 19:15:12 Pacific Standard Time 2002</i>
1.75 + <p>
1.76 + sun.jvm.hotspot.oops.ObjectHistogram should be the underlying data
1.77 + structure for the TableModels. It shouldnt bother with sorting the data -
1.78 + the table model should do that. It should implement these methods:
1.79 +
1.80 + <pre>
1.81 + public int getSize()
1.82 + public ObjectHistogramElement getElementAt(int row);
1.83 + </pre>
1.84 + <p>
1.85 + ObjectHistogramElement should return the String that represents
1.86 + the third column
1.87 +
1.88 +
1.89 + <hr>
1.90 + <address><a href="mailto:mark.davidson@sun.com">Mark Davidson</a></address>
1.91 +<!-- Created: Mon Jan 28 14:33:47 Pacific Standard Time 2002 -->
1.92 +<!-- hhmts start -->
1.93 +Last modified: Tue Feb 05 20:05:13 Pacific Standard Time 2002
1.94 +<!-- hhmts end -->
1.95 + </body>
1.96 +</html>
