1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
|
/*
* Copyright (C) 2015 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.android.ahat;
import com.android.ahat.heapdump.AhatClassObj;
import com.android.ahat.heapdump.AhatInstance;
import com.android.ahat.heapdump.AhatSnapshot;
import com.android.ahat.heapdump.Diff;
import com.android.ahat.heapdump.FieldValue;
import com.android.ahat.heapdump.Site;
import com.android.ahat.heapdump.Value;
import com.android.tools.perflib.heap.ProguardMap;
import java.io.File;
import java.io.IOException;
import java.text.ParseException;
import java.util.ArrayList;
import java.util.Collection;
/**
* The TestDump class is used to get an AhatSnapshot for the test-dump
* program.
*/
public class TestDump {
// It can take on the order of a second to parse and process the test-dump
// hprof. To avoid repeating this overhead for each test case, we cache the
// loaded instance of TestDump and reuse it when possible. In theory the
// test cases should not be able to modify the cached snapshot in a way that
// is visible to other test cases.
private static TestDump mCachedTestDump = null;
// If the test dump fails to load the first time, it will likely fail every
// other test we try. Rather than having to wait a potentially very long
// time for test dump loading to fail over and over again, record when it
// fails and don't try to load it again.
private static boolean mTestDumpFailed = false;
private AhatSnapshot mSnapshot;
private AhatSnapshot mBaseline;
private AhatClassObj mMain;
private AhatClassObj mBaselineMain;
/**
* Load the test-dump.hprof and test-dump-base.hprof files.
* The location of the files are read from the system properties
* "ahat.test.dump.hprof" and "ahat.test.dump.base.hprof", which is expected
* to be set on the command line.
* The location of the proguard map for both hprof files is read from the
* system property "ahat.test.dump.map". For example:
* java -Dahat.test.dump.hprof=test-dump.hprof \
* -Dahat.test.dump.base.hprof=test-dump-base.hprof \
* -Dahat.test.dump.map=proguard.map \
* -jar ahat-tests.jar
*
* An IOException is thrown if there is a failure reading the hprof files or
* the proguard map.
*/
private TestDump() throws IOException {
// TODO: Make use of the baseline hprof for tests.
String hprof = System.getProperty("ahat.test.dump.hprof");
String hprofBase = System.getProperty("ahat.test.dump.base.hprof");
String mapfile = System.getProperty("ahat.test.dump.map");
ProguardMap map = new ProguardMap();
try {
map.readFromFile(new File(mapfile));
} catch (ParseException e) {
throw new IOException("Unable to load proguard map", e);
}
mSnapshot = AhatSnapshot.fromHprof(new File(hprof), map);
mBaseline = AhatSnapshot.fromHprof(new File(hprofBase), map);
Diff.snapshots(mSnapshot, mBaseline);
mMain = findClass(mSnapshot, "Main");
assert(mMain != null);
mBaselineMain = findClass(mBaseline, "Main");
assert(mBaselineMain != null);
}
/**
* Get the AhatSnapshot for the test dump program.
*/
public AhatSnapshot getAhatSnapshot() {
return mSnapshot;
}
/**
* Get the baseline AhatSnapshot for the test dump program.
*/
public AhatSnapshot getBaselineAhatSnapshot() {
return mBaseline;
}
/**
* Returns the value of a field in the DumpedStuff instance in the
* snapshot for the test-dump program.
*/
public Value getDumpedValue(String name) {
return getDumpedValue(name, mMain);
}
/**
* Returns the value of a field in the DumpedStuff instance in the
* baseline snapshot for the test-dump program.
*/
public Value getBaselineDumpedValue(String name) {
return getDumpedValue(name, mBaselineMain);
}
/**
* Returns the value of a field in the DumpedStuff instance given the Main
* class object for the snapshot.
*/
private static Value getDumpedValue(String name, AhatClassObj main) {
AhatInstance stuff = null;
for (FieldValue field : main.getStaticFieldValues()) {
if ("stuff".equals(field.name)) {
stuff = field.value.asAhatInstance();
}
}
return stuff.getField(name);
}
/**
* Returns a class object in the given heap dump whose name matches the
* given name, or null if no such class object could be found.
*/
private static AhatClassObj findClass(AhatSnapshot snapshot, String name) {
Site root = snapshot.getRootSite();
Collection<AhatInstance> classes = new ArrayList<AhatInstance>();
root.getObjects(null, "java.lang.Class", classes);
for (AhatInstance inst : classes) {
if (inst.isClassObj()) {
AhatClassObj cls = inst.asClassObj();
if (name.equals(cls.getName())) {
return cls;
}
}
}
return null;
}
/**
* Returns a class object in the heap dump whose name matches the given
* name, or null if no such class object could be found.
*/
public AhatClassObj findClass(String name) {
return findClass(mSnapshot, name);
}
/**
* Returns the value of a non-primitive field in the DumpedStuff instance in
* the snapshot for the test-dump program.
*/
public AhatInstance getDumpedAhatInstance(String name) {
Value value = getDumpedValue(name);
return value == null ? null : value.asAhatInstance();
}
/**
* Returns the value of a non-primitive field in the DumpedStuff instance in
* the baseline snapshot for the test-dump program.
*/
public AhatInstance getBaselineDumpedAhatInstance(String name) {
Value value = getBaselineDumpedValue(name);
return value == null ? null : value.asAhatInstance();
}
/**
* Get the test dump.
* An IOException is thrown if there is an error reading the test dump hprof
* file.
* To improve performance, this returns a cached instance of the TestDump
* when possible.
*/
public static synchronized TestDump getTestDump() throws IOException {
if (mTestDumpFailed) {
throw new RuntimeException("Test dump failed before, assuming it will again");
}
if (mCachedTestDump == null) {
mTestDumpFailed = true;
mCachedTestDump = new TestDump();
mTestDumpFailed = false;
}
return mCachedTestDump;
}
}
|