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