Skip to content

Commit

Permalink
581829: Do not show primitive values for dumps that do not have them
Browse files Browse the repository at this point in the history 
Add some help for this to tip and tricks.

Task-Url: https://bugs.eclipse.org/bugs/show_bug.cgi?id=581829
Change-Id: Ifeba4316fad6e8e3174fc56639fb861fedad22b2
  • Loading branch information
@ajohnson1
ajohnson1 committed Jul 6, 2023
1 parent 00c8fb7 commit c71db8a
Show file tree
Hide file tree
Showing 2 changed files with 141 additions and 40 deletions.
45 changes: 43 additions & 2 deletions plugins/org.eclipse.mat.ui.help/reference/tipsandtricks.dita
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2008, 2021 SAP AG and IBM Corporation.
Copyright (c) 2008, 2023 SAP AG and IBM Corporation.
All rights reserved. This program and the accompanying materials
are made available under the terms of the Eclipse Public License 2.0
which accompanies this distribution, and is available at
Expand All @@ -20,7 +20,7 @@
<copyright>
<copyryear year=""></copyryear>
<copyrholder>
Copyright (c) 2008, 2021 SAP AG, IBM Corporation and others.
Copyright (c) 2008, 2023 SAP AG, IBM Corporation and others.
All rights reserved. This program and the accompanying materials
are made available under the terms of the Eclipse Public License 2.0
which accompanies this distribution, and is available at
Expand Down Expand Up @@ -221,6 +221,47 @@
<image href="../mimes/link_with_snapshot.png" align="left" placement="break" />
</stentry>
</strow>
<strow id="attribute_tab">
<stentry>Attribute tab in Inspector View</stentry>
<stentry>
The Object Inspector View shows the details for the single selected
object. The attribute tab shows the fields of an object or array elements
for an array.
<dl>
<dlentry>
<dt>Type</dt>
<dd>The type of the field or array element.
<ul>
<li>byte</li>
<li>short</li>
<li>int</li>
<li>long</li>
<li>boolean</li>
<li>char</li>
<li>float</li>
<li>double</li>
<li>ref - an object reference</li>
</ul>
</dd>
</dlentry>
<dlentry>
<dt>Name</dt>
<dd>The name of the field or the array element index.</dd>
</dlentry>
<dlentry>
<dt>Value</dt>
<dd>The value of the field or array element.
Blank for PHD snapshots as the snapshot does not have
field names or the value of primitive arrays.</dd>
</dlentry>
</dl>
As IBM Portable Heap Dump (PHD) files do not contain primitive array contents
the value column for array elements is blank.
As IBM Portable Heap Dump (PHD) files do not contain field names
the attribute tab is blank for plain objects. Outbound references
are shown by the <xref format="dita" href="../reference/querymatrix.dita#ref_querymatrix/list_objects">list objects</xref> query.
</stentry>
</strow>
<strow id="value_tab">
<stentry>Value tab in Inspector View</stentry>
<stentry>
Expand Down
136 changes: 98 additions & 38 deletions plugins/org.eclipse.mat.ui.help/reference/tipsandtricks.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
<meta name="DC.title" content="Tips and Tricks" />
<meta name="abstract" content="" />
<meta name="description" content="" />
<meta name="copyright" content="Copyright (c) 2008, 2021 SAP AG, IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/ " type="primary" />
<meta name="DC.rights.owner" content="Copyright (c) 2008, 2021 SAP AG, IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/ " type="primary" />
<meta name="copyright" content="Copyright (c) 2008, 2023 SAP AG, IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/ " type="primary" />
<meta name="DC.rights.owner" content="Copyright (c) 2008, 2023 SAP AG, IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/ " type="primary" />
<meta name="DC.format" content="XHTML" />
<meta name="DC.identifier" content="ref_tips" />
<meta name="DC.language" content="en-us" />
Expand All @@ -31,15 +31,15 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>
</p>

<table cellpadding="4" cellspacing="0" summary="" id="ref_tips__tips_table" border="1" class="simpletable"><col style="width:20%" /><col style="width:80%" /><thead><tr class="sthead">
<th style="vertical-align:bottom;text-align:left;" id="d8193e37" class="stentry">Tip</th>
<th style="vertical-align:bottom;text-align:left;" id="d8327e37" class="stentry">Tip</th>

<th style="vertical-align:bottom;text-align:left;" id="d8193e40" class="stentry">Description</th>
<th style="vertical-align:bottom;text-align:left;" id="d8327e40" class="stentry">Description</th>

</tr>
</thead><tbody><tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Shortcuts. Use <span class="ph uicontrol">command</span> instead of <span class="ph uicontrol">ctrl</span> on macOS</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Shortcuts. Use <span class="ph uicontrol">command</span> instead of <span class="ph uicontrol">ctrl</span> on macOS</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
<p class="p"><span class="ph uicontrol">ctrl+Q</span> - Opens the Query Browser.</p>

<p class="p"><span class="ph uicontrol">ctrl+H</span> - Opens the history of executed queries.</p>
Expand All @@ -63,9 +63,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Quick Search</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Quick Search</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
Just start to type while you are in the heap editor, all the
matches will be highlighted. This quick search starts is activated
when 3 or more letters are provided.
Expand All @@ -74,9 +74,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Filter</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Filter</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
To show only rows of a table or tree matching a filter,
click the top row, or press enter when the top row is selected.
Then type the required filter for the column. Multiple filters can be used.
Expand Down Expand Up @@ -121,9 +121,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Resize and reorder columns</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Resize and reorder columns</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
To resize or rearrange columns using the keyboard select a filter entry
for the column as above.
<ul class="ul">
Expand All @@ -141,9 +141,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Keyboard navigation of trees</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Keyboard navigation of trees</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
<ul class="ul">
<li class="li">Use <span class="ph uicontrol">numpad-plus</span> or <span class="ph uicontrol">enter</span> to expand a row.</li>

Expand All @@ -161,9 +161,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Notes, Hyperlinks in Notes View</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Notes, Hyperlinks in Notes View</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
Notes View recognizes and highlights object addresses. Activating
the hyperlink brings up a context menu which contains actions for
this particular object. Activate the hyperlink using the <span class="ph uicontrol">control</span> key
Expand All @@ -173,29 +173,29 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Undo/redo in Notes View, OQL Pane</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Undo/redo in Notes View, OQL Pane</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
There is undo/redo using <span class="ph uicontrol">ctrl+Z</span> / <span class="ph uicontrol">ctrl+Y</span> in the Notes View and
the OQL Pane. The navigator pane can also be used to retrieve
previous OQL statements.
</td>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Copy To Clipboard</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Copy To Clipboard</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
Use <span class="ph uicontrol">ctrl+C</span> to copy the selection to the clipboard. The data will
keep its structure:
<br /><div class="imageleft"><img class="image imageleft" src="../mimes/1af34c1.png" /></div><br />
</td>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry"> Manage the history of opened heap dumps</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry"> Manage the history of opened heap dumps</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
Heap Dump History view offers a set of context menu actions to
manage the history of opened heap dumps:
<br /><div class="imageleft"><img class="image imageleft" src="../mimes/691a2594.png" /></div><br />
Expand All @@ -211,9 +211,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr id="ref_tips__editor_tabs" class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Manage editor tabs</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Manage editor tabs</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
Right click on the Heap Editor tab will open a context menu to
manage the tabs. It might be very helpful when many tabs are open.
<br /><div class="imageleft"><img class="image imageleft" src="../mimes/7df38219.png" /></div><br />
Expand Down Expand Up @@ -269,9 +269,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry"> Link Inspector View with Heap Editor</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry"> Link Inspector View with Heap Editor</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
Object Inspector View shows the details for the single selected
object. The view updates itself with every change in the
selection. Sometimes it is interesting to compare two or more
Expand All @@ -283,11 +283,71 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>
<br /><div class="imageleft"><img class="image imageleft" src="../mimes/link_with_snapshot.png" /></div><br />
</td>

</tr>
<tr id="ref_tips__attribute_tab" class="strow">
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Attribute tab in Inspector View</td>

<td style="vertical-align:top;" headers="d8327e40" class="stentry">
The Object Inspector View shows the details for the single selected
object. The attribute tab shows the fields of an object or array elements
for an array.
<dl class="dl">

<dt class="dt dlterm">Type</dt>

<dd class="dd">The type of the field or array element.
<ul class="ul">
<li class="li">byte</li>

<li class="li">short</li>

<li class="li">int</li>

<li class="li">long</li>

<li class="li">boolean</li>

<li class="li">char</li>

<li class="li">float</li>

<li class="li">double</li>

<li class="li">ref - an object reference</li>

</ul>

</dd>



<dt class="dt dlterm">Name</dt>

<dd class="dd">The name of the field or the array element index.</dd>



<dt class="dt dlterm">Value</dt>

<dd class="dd">The value of the field or array element.
Blank for PHD snapshots as the snapshot does not have
field names or the value of primitive arrays.</dd>


</dl>

As IBM Portable Heap Dump (PHD) files do not contain primitive array contents
the value column for array elements is blank.
As IBM Portable Heap Dump (PHD) files do not contain field names
the attribute tab is blank for plain objects. Outbound references
are shown by the <a class="xref" href="querymatrix.html#ref_querymatrix__list_objects">list objects</a> query.
</td>

</tr>
<tr id="ref_tips__value_tab" class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Value tab in Inspector View</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Value tab in Inspector View</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
The Object Inspector View shows the details for the single selected
object. The value tab shows the value as given by the
<a class="xref" href="../doc/org_eclipse_mat_api_nameResolver.html">
Expand All @@ -297,9 +357,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Image and Color objects</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Image and Color objects</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
The Object Inspector View
recreates Eclipse colors and images from the information in the heap dump and
displays the information in the lower left corner of the inspector.
Expand All @@ -312,19 +372,19 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Class Hierarchy in Inspector</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Class Hierarchy in Inspector</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
The inspector now displays the full class hierarchy of any selected object.
One can drill-down via context menus.
<br /><div class="imageleft"><img class="image imageleft" src="../mimes/nn_inspector_class_hierarchy.png" /></div><br />
</td>

</tr>
<tr class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Context menu for totals row</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Context menu for totals row</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
The totals row now represents all the additional entries in a tree or table.
If the totals row is selected then the context menu will operate on all the unshown
entries in the tree or table. If all the rows are selected, for example using <span class="ph uicontrol">ctrl+A</span>,
Expand All @@ -337,9 +397,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr class="strow">
<td style="vertical-align:top;" id="ref_tips__oqlcompletion" headers="d8193e37" class="stentry">OQL autocompletion</td>
<td style="vertical-align:top;" id="ref_tips__oqlcompletion" headers="d8327e37" class="stentry">OQL autocompletion</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
The Object Query Language (OQL) pane has syntax highlighting for OQL
keywords. It also offers suggestions for class names for the
<span class="keyword">SELECT</span> <span class="keyword">FROM</span> clause, both simple class names and regular expressions.
Expand Down Expand Up @@ -370,9 +430,9 @@ <h1 class="title topictitle1" id="ariaid-title1">Tips and Tricks</h1>

</tr>
<tr id="ref_tips__piechartlinks" class="strow">
<td style="vertical-align:top;" headers="d8193e37" class="stentry">Links in Pie Chart Image</td>
<td style="vertical-align:top;" headers="d8327e37" class="stentry">Links in Pie Chart Image</td>

<td style="vertical-align:top;" headers="d8193e40" class="stentry">
<td style="vertical-align:top;" headers="d8327e40" class="stentry">
Memory Analyzer 1.11 adds hot-spots to the pie chart.
The legend entries now link to the referenced object.
<br /><div class="imageleft"><img class="image imageleft" src="../mimes/piechartlinks.png" height="292" width="809" alt="Pie Chart showing links from legend" /></div><br />
Expand Down

0 comments on commit c71db8a

Please sign in to comment.