MetricUtility

public class MetricUtility
extends Object

java.lang.Object
↳	com.android.tradefed.util.MetricUtility

---

Enthält allgemeine Hilfsmethoden zum Speichern der Testmesswerte, zum Aggregieren der Messwerte in ähnlichen Tests und zum Schreiben der Messwerte in eine Datei.

Zusammenfassung

Verschachtelte Klassen
class	MetricUtility.DimensionalIterationData Hilfsklasse zum Speichern von Datei und Status für dimensionale Messwerte für eine einzelne Testiteration.

Öffentliche Konstruktoren
MetricUtility()

Öffentliche Methoden
File	aggregateDimensionalMetricsAndWriteToFile(List<MetricUtility.DimensionalIterationData> iterationDataList, Set<Integer> percentiles, String testIterationSeparator) Liest alle gespeicherten Berichtsdateien mit dimensionalen Messwerten, aggregiert die Rohwerte, berechnet Statistiken und schreibt eine neue aggregierte Berichtsdatei.
Map<String, MetricMeasurement.Metric>	aggregateMetrics(Map<String, MetricMeasurement.Metric> rawMetrics) Zusammengefasste, durch Kommas getrennte Messwerte.
File	aggregateStoredTestMetricsAndWriteToFile(String fileName) Die Messwerte aus mehreren Testläufen zusammenfassen und die zusammengefassten Messwerte in eine Testdatei schreiben.
void	buildMetricFilterPatterns(Set<String> strictIncludeRegEx) Erstellen Sie Muster für reguläre Ausdrücke, um die Messwerte zu filtern.
Map<String, MetricMeasurement.Metric>	filterMetrics(Map<String, MetricMeasurement.Metric> parsedMetrics) Filtern Sie die Messwerte, die dem Muster entsprechen.
static Map<String, Double>	getStats(List<Double> values, Set<Integer> percentiles, int testIterations) Berechne die Statistiken aus der angegebenen Liste von Werten.
Map<String, List<MetricUtility.IterationData>>	getTestIterations()
static boolean	isAllDoubleValues(List<String> rawValues) Prüft, ob alle Werte in der Liste Double-Werte sind.
void	setIterationSeparator(String separator)
void	setMetricsUseForTestIterations(Set<String> metricsUseForTestIterations) Legt die regulären Ausdrücke für Messwerte fest, für die bei der Aggregation bestandene Testiterationen für die Berechnung des Mittelwerts verwendet werden sollen.
void	setPercentiles(Set<Integer> percentiles)
void	storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics, boolean testFailed) Dient zum Speichern der einzelnen Testmesswerte und zur Aggregation.
void	storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics) Überladene Version von „storeTestMetrics“ zur Abwärtskompatibilität.
File	writeResultsToFile(String testFileSuffix, String testHeaderName, Map<String, String> metrics, File resultsFile) Messwerte in eine Datei schreiben

Öffentliche Konstruktoren

MetricUtility

public MetricUtility ()

Öffentliche Methoden

aggregateDimensionalMetricsAndWriteToFile

public File aggregateDimensionalMetricsAndWriteToFile (List<MetricUtility.DimensionalIterationData> iterationDataList, 
                Set<Integer> percentiles, 
                String testIterationSeparator)

Liest alle gespeicherten Berichtsdateien mit dimensionalen Messwerten, aggregiert die Rohwerte, berechnet Statistiken und schreibt eine neue aggregierte Berichtsdatei.

Parameter
iterationDataList	List
percentiles	Set: Die zu berechnenden Perzentile.
testIterationSeparator	String: Das Trennzeichen für Testiterationen.

Gibt Folgendes zurück:
File	Ein File mit dem aggregierten Bericht oder „null“, wenn keine Aggregation durchgeführt wurde.

aggregateMetrics

public Map<String, MetricMeasurement.Metric> aggregateMetrics (Map<String, MetricMeasurement.Metric> rawMetrics)

Zusammengefasste, durch Kommas getrennte Messwerte.

Parameter
rawMetrics	Map: Messwerte, die während des Testlaufs erfasst wurden.

Gibt Folgendes zurück:
Map<String, MetricMeasurement.Metric>	zusammengefasste Messwerte.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Die Messwerte aus mehreren Testläufen zusammenfassen und die zusammengefassten Messwerte in eine Testdatei schreiben.

Parameter
fileName	String: Der Dateiname, der beim Schreiben der Messwerte verwendet werden soll.

Gibt Folgendes zurück:
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Erstellen Sie Muster für reguläre Ausdrücke, um die Messwerte zu filtern.

Parameter
strictIncludeRegEx	Set

filterMetrics

public Map<String, MetricMeasurement.Metric> filterMetrics (Map<String, MetricMeasurement.Metric> parsedMetrics)

Filtern Sie die Messwerte, die dem Muster entsprechen.

Parameter
parsedMetrics	Map

Gibt Folgendes zurück:
Map<String, MetricMeasurement.Metric>

getStats

public static Map<String, Double> getStats (List<Double> values, 
                Set<Integer> percentiles, 
                int testIterations)

Berechne die Statistiken aus der angegebenen Liste von Werten.

Parameter
values	List: Rohwerte zur Berechnung der Aggregation.
percentiles	Set: Statistiken, die in die endgültigen Messwerte aufgenommen werden sollen.
testIterations	int: Anzahl der Iterationen, die als Divisor für den Mittelwert verwendet werden sollen. Wenn 0, wird der Mittelwert anhand der Größe der Liste „values“ berechnet.

Gibt Folgendes zurück:
Map<String, Double>	aggregierte Werte.

getTestIterations

public Map<String, List<MetricUtility.IterationData>> getTestIterations ()

Gibt Folgendes zurück:
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

Prüft, ob alle Werte in der Liste Double-Werte sind.

Parameter
rawValues	List: Liste der zu prüfenden Werte.

Gibt Folgendes zurück:
boolean	„true“, wenn alle Werte Double-Werte sind, andernfalls „false“.

setIterationSeparator

public void setIterationSeparator (String separator)

Parameter
separator	String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Legt die regulären Ausdrücke für Messwerte fest, für die bei der Aggregation bestandene Testiterationen für die Berechnung des Mittelwerts verwendet werden sollen.

Parameter
metricsUseForTestIterations	Set: Eine Reihe von Strings für reguläre Ausdrücke.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

Parameter
percentiles	Set

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                Map<String, MetricMeasurement.Metric> testMetrics, 
                boolean testFailed)

Dient zum Speichern der einzelnen Testmesswerte und zur Aggregation.

Parameter
testDescription	TestDescription: Enthält die Testdetails wie Klassenname und Testname.
testMetrics	Map: Die für den Test erhobenen Messwerte.
testFailed	boolean: Gibt an, ob der Test fehlgeschlagen ist.

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                Map<String, MetricMeasurement.Metric> testMetrics)

Überladene Version von „storeTestMetrics“ zur Abwärtskompatibilität. Die Standardeinstellung ist „false“.

Parameter
testDescription	TestDescription
testMetrics	Map

writeResultsToFile

public File writeResultsToFile (String testFileSuffix, 
                String testHeaderName, 
                Map<String, String> metrics, 
                File resultsFile)

Messwerte in eine Datei schreiben

Parameter
testFileSuffix	String: Wird als Suffix im Dateinamen des Testmesswerts verwendet.
testHeaderName	String: Messwerte werden unter dem Namen des Test-Headers geschrieben.
metrics	Map: in die Datei schreiben.
resultsFile	File: Wenn der Wert „null“ ist, wird eine neue Datei erstellt und die Messwerte werden geschrieben. Andernfalls werden der Testheadername und der Messwert an die Datei angehängt.

Gibt Folgendes zurück:
File	Datei mit dem Messwert.