0N/A<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
0N/A<html>
0N/A <head>
0N/A <title>Hotspot SA User Interface Notes</title>
0N/A </head>
0N/A
0N/A <body>
0N/A <h1>Hotspot SA User Interface Notes</h1>
0N/A
0N/A <h2>Workspace and Building</h2>
0N/A
0N/A <p>
0N/A All the source code for the Serviceability Agent is in
0N/A <code>src/share/vm/agent</code> in the HotSport workspace
0N/A <code>/net/jano.sfbay/export/disk05/hotspot/ws/1.4/sa_baseline</code>
0N/A <p>
0N/A You can build the project by typing <code>gnumake</code> in the
0N/A <code>src/share/vm/agent</code> directory.
0N/A <p>
0N/A You can also use the default build target using the Ant build file (build.xml). You can download Ant from
0N/A <a href="http://jakarta.apache.org/ant">http://jakarta.apache.org/ant</a>. Documentation for Ant can be
0N/A found at <a href="http://jakarta.apache.org/ant/manual/index.html">http://jakarta.apache.org/ant/manual/index.html</a>
0N/A
0N/A
0N/A <h2>Running the project</h2>
0N/A
0N/A <ul>
0N/A <li><code>java -cp classes sun.jvm.hotspot.HSDB</code>
0N/A <li><code>java -cp classes sun.jvm.hotspot.bugspot.Main</code>
0N/A </ul>
0N/A
0N/A <h2>Feedback</h2>
0N/A <p>
0N/A Refactoring of package hierarchy. All user interface components should be in
0N/A the ui package. Perhaps: sun.jvm.hotspot.ui.hsdb.Main for the HSDB and
0N/A sun.jvm.hotspot.ui.bugspot.Main for BugSpot.
0N/A <p>
0N/A The src\share\vm\agent area seems like a workspace so it should be organized like
0N/A one. In particular, I'd like to suggest the following directory layout:<br>
0N/A
0N/A <ul>
0N/A <li>src: All sources that are curently under the sun directory.
0N/A <li>classes: compiled class files.
0N/A <li>lib: Resources like images, icons and jar files.
0N/A <li>docs: Documentation
0N/A <li>deploy: distribution bundles for Java Web Start.
0N/A </ul>
0N/A
0N/A <p>
0N/A Seems like there is a lot of redundant functionality. Between the HSDB and BugSpot. Perhaps
0N/A this can be consolidated with a <code>javax.swing.Actions</code> architecture.
0N/A
0N/A <h2>Tasklist</h2>
0N/A
0N/A <p>
0N/A <b>Stack memory pane</b>:
0N/A It's one of the more useful JVM debugging tools in the SA. However, it
0N/A doesn't support any interaction with the text; the Memory Panel in BugSpot
0N/A was written afterward (with help from Shannon) and implements proper
0N/A selection, scrolling, and drag-and-drop, but no annotations. I'm not sure how
0N/A to integrate the annotations with the JTable that's being used for the memory
0N/A view; if you have suggestions here please let me know.
0N/A <p>
0N/A <b>Integrations with the NetBeans architecture (plug in).</b> See the
0N/A <a href="http://openide.netbeans.org">Netbeans Open APIs homepage</a>
0N/A
0N/A
0N/A <p>
0N/A HSDB: Object Histogram. Column sizes should be sized according the the
0N/A contents. i.e, The size and count columns should be narrow enought to
0N/A handle the largest window. Since there is a lot of data, sorting
0N/A and searching should be implemented.
0N/A <p>
0N/A
0N/A <h2>Log</h2>
0N/A
0N/A <i>Last modified: Tue Feb 05 19:15:12 Pacific Standard Time 2002</i>
0N/A <p>
0N/A sun.jvm.hotspot.oops.ObjectHistogram should be the underlying data
0N/A structure for the TableModels. It shouldnt bother with sorting the data -
0N/A the table model should do that. It should implement these methods:
0N/A
0N/A <pre>
0N/A public int getSize()
0N/A public ObjectHistogramElement getElementAt(int row);
0N/A </pre>
0N/A <p>
0N/A ObjectHistogramElement should return the String that represents
0N/A the third column
0N/A
0N/A
0N/A <hr>
0N/A <address><a href="mailto:mark.davidson@sun.com">Mark Davidson</a></address>
0N/A<!-- Created: Mon Jan 28 14:33:47 Pacific Standard Time 2002 -->
0N/A<!-- hhmts start -->
0N/ALast modified: Tue Feb 05 20:05:13 Pacific Standard Time 2002
0N/A<!-- hhmts end -->
0N/A </body>
0N/A</html>