|
1
|
1 |
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
|
|
|
2 |
<html>
|
|
|
3 |
<head>
|
|
|
4 |
<title>Hotspot SA User Interface Notes</title>
|
|
|
5 |
</head>
|
|
|
6 |
|
|
|
7 |
<body>
|
|
|
8 |
<h1>Hotspot SA User Interface Notes</h1>
|
|
|
9 |
|
|
|
10 |
<h2>Workspace and Building</h2>
|
|
|
11 |
|
|
|
12 |
<p>
|
|
|
13 |
All the source code for the Serviceability Agent is in
|
|
|
14 |
<code>src/share/vm/agent</code> in the HotSport workspace
|
|
|
15 |
<code>/net/jano.sfbay/export/disk05/hotspot/ws/1.4/sa_baseline</code>
|
|
|
16 |
<p>
|
|
|
17 |
You can build the project by typing <code>gnumake</code> in the
|
|
|
18 |
<code>src/share/vm/agent</code> directory.
|
|
|
19 |
<p>
|
|
|
20 |
You can also use the default build target using the Ant build file (build.xml). You can download Ant from
|
|
|
21 |
<a href="http://jakarta.apache.org/ant">http://jakarta.apache.org/ant</a>. Documentation for Ant can be
|
|
|
22 |
found at <a href="http://jakarta.apache.org/ant/manual/index.html">http://jakarta.apache.org/ant/manual/index.html</a>
|
|
|
23 |
|
|
|
24 |
|
|
|
25 |
<h2>Running the project</h2>
|
|
|
26 |
|
|
|
27 |
<ul>
|
|
|
28 |
<li><code>java -cp classes sun.jvm.hotspot.HSDB</code>
|
|
|
29 |
<li><code>java -cp classes sun.jvm.hotspot.bugspot.Main</code>
|
|
|
30 |
</ul>
|
|
|
31 |
|
|
|
32 |
<h2>Feedback</h2>
|
|
|
33 |
<p>
|
|
|
34 |
Refactoring of package hierarchy. All user interface components should be in
|
|
|
35 |
the ui package. Perhaps: sun.jvm.hotspot.ui.hsdb.Main for the HSDB and
|
|
|
36 |
sun.jvm.hotspot.ui.bugspot.Main for BugSpot.
|
|
|
37 |
<p>
|
|
|
38 |
The src\share\vm\agent area seems like a workspace so it should be organized like
|
|
|
39 |
one. In particular, I'd like to suggest the following directory layout:<br>
|
|
|
40 |
|
|
|
41 |
<ul>
|
|
|
42 |
<li>src: All sources that are curently under the sun directory.
|
|
|
43 |
<li>classes: compiled class files.
|
|
|
44 |
<li>lib: Resources like images, icons and jar files.
|
|
|
45 |
<li>docs: Documentation
|
|
|
46 |
<li>deploy: distribution bundles for Java Web Start.
|
|
|
47 |
</ul>
|
|
|
48 |
|
|
|
49 |
<p>
|
|
|
50 |
Seems like there is a lot of redundant functionality. Between the HSDB and BugSpot. Perhaps
|
|
|
51 |
this can be consolidated with a <code>javax.swing.Actions</code> architecture.
|
|
|
52 |
|
|
|
53 |
<h2>Tasklist</h2>
|
|
|
54 |
|
|
|
55 |
<p>
|
|
|
56 |
<b>Stack memory pane</b>:
|
|
|
57 |
It's one of the more useful JVM debugging tools in the SA. However, it
|
|
|
58 |
doesn't support any interaction with the text; the Memory Panel in BugSpot
|
|
|
59 |
was written afterward (with help from Shannon) and implements proper
|
|
|
60 |
selection, scrolling, and drag-and-drop, but no annotations. I'm not sure how
|
|
|
61 |
to integrate the annotations with the JTable that's being used for the memory
|
|
|
62 |
view; if you have suggestions here please let me know.
|
|
|
63 |
<p>
|
|
|
64 |
<b>Integrations with the NetBeans architecture (plug in).</b> See the
|
|
|
65 |
<a href="http://openide.netbeans.org">Netbeans Open APIs homepage</a>
|
|
|
66 |
|
|
|
67 |
|
|
|
68 |
<p>
|
|
|
69 |
HSDB: Object Histogram. Column sizes should be sized according the the
|
|
|
70 |
contents. i.e, The size and count columns should be narrow enought to
|
|
|
71 |
handle the largest window. Since there is a lot of data, sorting
|
|
|
72 |
and searching should be implemented.
|
|
|
73 |
<p>
|
|
|
74 |
|
|
|
75 |
<h2>Log</h2>
|
|
|
76 |
|
|
|
77 |
<i>Last modified: Tue Feb 05 19:15:12 Pacific Standard Time 2002</i>
|
|
|
78 |
<p>
|
|
|
79 |
sun.jvm.hotspot.oops.ObjectHistogram should be the underlying data
|
|
|
80 |
structure for the TableModels. It shouldnt bother with sorting the data -
|
|
|
81 |
the table model should do that. It should implement these methods:
|
|
|
82 |
|
|
|
83 |
<pre>
|
|
|
84 |
public int getSize()
|
|
|
85 |
public ObjectHistogramElement getElementAt(int row);
|
|
|
86 |
</pre>
|
|
|
87 |
<p>
|
|
|
88 |
ObjectHistogramElement should return the String that represents
|
|
|
89 |
the third column
|
|
|
90 |
|
|
|
91 |
|
|
|
92 |
<hr>
|
|
|
93 |
<address><a href="mailto:mark.davidson@sun.com">Mark Davidson</a></address>
|
|
|
94 |
<!-- Created: Mon Jan 28 14:33:47 Pacific Standard Time 2002 -->
|
|
|
95 |
<!-- hhmts start -->
|
|
|
96 |
Last modified: Tue Feb 05 20:05:13 Pacific Standard Time 2002
|
|
|
97 |
<!-- hhmts end -->
|
|
|
98 |
</body>
|
|
|
99 |
</html>
|