/* * 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.Value; import com.android.tools.perflib.heap.ProguardMap; import java.io.File; import java.io.IOException; import java.text.ParseException; /** * 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 = null; private AhatSnapshot mBaseline = null; /** * 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); } /** * 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, mSnapshot); } /** * 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, mBaseline); } /** * Returns the value of a field in the DumpedStuff instance in the * given snapshot for the test-dump program. */ private Value getDumpedValue(String name, AhatSnapshot snapshot) { AhatClassObj main = snapshot.findClass("Main"); AhatInstance stuff = null; for (FieldValue field : main.getStaticFieldValues()) { if ("stuff".equals(field.name)) { stuff = field.value.asAhatInstance(); } } return stuff.getField(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; } }