MetricUtility

public class MetricUtility
extends Object

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

इसमें टेस्ट मेट्रिक को सेव करने, मिलते-जुलते टेस्ट में मेट्रिक को एग्रीगेट करने, और मेट्रिक को किसी फ़ाइल में लिखने के लिए, सामान्य यूटिलिटी के तरीके शामिल होते हैं.

खास जानकारी

नेस्टेड क्लास

class MetricUtility.DimensionalIterationData

यह हेल्पर क्लास, डाइमेंशनल मेट्रिक फ़ाइल और एक टेस्ट इटरेशन के लिए स्टेटस को सेव करती है. 

सार्वजनिक कंस्ट्रक्टर

MetricUtility()

पब्लिक मेथड

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

यह सेव की गई सभी डाइमेंशनल मेट्रिक रिपोर्ट फ़ाइलों को पढ़ता है, रॉ वैल्यू को इकट्ठा करता है, आंकड़ों का हिसाब लगाता है, और एग्रीगेट की गई नई रिपोर्ट फ़ाइल लिखता है.

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

कॉमा लगाकर अलग की गई मेट्रिक को एग्रीगेट करें.

File aggregateStoredTestMetricsAndWriteToFile(String fileName)

टेस्ट के कई इटरेशन से इकट्ठा की गई मेट्रिक को एग्रीगेट करें. साथ ही, एग्रीगेट की गई मेट्रिक को टेस्ट के नतीजे वाली फ़ाइल में लिखें.

void buildMetricFilterPatterns(Set<String> strictIncludeRegEx)

मेट्रिक को फ़िल्टर करने के लिए, रेगुलर एक्सप्रेशन पैटर्न बनाएं.

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

पैटर्न से मैच करने वाली मेट्रिक को फ़िल्टर करें.

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

वैल्यू की दी गई सूची से आंकड़े कैलकुलेट करो.

Map<String, List<MetricUtility.IterationData>> getTestIterations()
static boolean isAllDoubleValues(List<String> rawValues)

इस फ़ंक्शन से यह पता चलता है कि सूची में मौजूद सभी वैल्यू, डबल वैल्यू हैं या नहीं.

void setIterationSeparator(String separator)
void setMetricsUseForTestIterations(Set<String> metricsUseForTestIterations)

यह उन मेट्रिक के लिए रेगुलर एक्सप्रेशन सेट करता है जिन्हें एग्रीगेशन के दौरान औसत की गणना के लिए, पास किए गए टेस्ट के इटरेशन का इस्तेमाल करना चाहिए.

void setPercentiles(Set<Integer> percentiles)
void storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics, boolean testFailed)

इस कुकी का इस्तेमाल, हर टेस्ट की मेट्रिक को सेव करने के लिए किया जाता है. साथ ही, इसका इस्तेमाल एग्रीगेशन के लिए किया जाता है.

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

यह storeTestMetrics का ओवरलोड किया गया वर्शन है, ताकि यह पुराने सिस्टम के साथ काम कर सके.

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

किसी फ़ाइल में मेट्रिक लिखना.

सार्वजनिक कंस्ट्रक्टर

MetricUtility

public MetricUtility ()

पब्लिक मेथड

aggregateDimensionalMetricsAndWriteToFile

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

यह सेव की गई सभी डाइमेंशनल मेट्रिक रिपोर्ट फ़ाइलों को पढ़ता है, रॉ वैल्यू को इकट्ठा करता है, आंकड़ों का हिसाब लगाता है, और एग्रीगेट की गई नई रिपोर्ट फ़ाइल लिखता है.

पैरामीटर
iterationDataList List

percentiles Set: कैलकुलेट करने के लिए पर्सेंटाइल.
testIterationSeparator String: यह टेस्ट के वर्शन के लिए सेपरेटर होता है.
रिटर्न
File File में एग्रीगेट की गई रिपोर्ट शामिल होती है. अगर कोई एग्रीगेशन नहीं किया गया है, तो यह शून्य होता है.

aggregateMetrics

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

कॉमा लगाकर अलग की गई मेट्रिक को एग्रीगेट करें.

पैरामीटर
rawMetrics Map: टेस्ट रन के दौरान इकट्ठा की गई मेट्रिक.
रिटर्न
Map<String, MetricMeasurement.Metric> एग्रीगेट की गई मेट्रिक.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

टेस्ट के कई इटरेशन से इकट्ठा की गई मेट्रिक को एग्रीगेट करें. साथ ही, एग्रीगेट की गई मेट्रिक को टेस्ट के नतीजे वाली फ़ाइल में लिखें.

पैरामीटर
fileName String: मेट्रिक लिखते समय इस्तेमाल किया जाने वाला फ़ाइल का नाम.
रिटर्न
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

मेट्रिक को फ़िल्टर करने के लिए, रेगुलर एक्सप्रेशन पैटर्न बनाएं.

पैरामीटर
strictIncludeRegEx Set

filterMetrics

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

पैटर्न से मैच करने वाली मेट्रिक को फ़िल्टर करें.

पैरामीटर
parsedMetrics Map

रिटर्न
Map<String, MetricMeasurement.Metric>

getStats

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

वैल्यू की दी गई सूची से आंकड़े कैलकुलेट करो.

पैरामीटर
values List: एग्रीगेशन की गणना करने के लिए रॉ वैल्यू.
percentiles Set: फ़ाइनल मेट्रिक में शामिल करने के लिए आंकड़े.
testIterations int: औसत के लिए भाजक के तौर पर इस्तेमाल की जाने वाली पुनरावृत्तियों की संख्या. अगर वैल्यू 0 है, तो 'values' सूची के साइज़ का इस्तेमाल करके औसत की गणना की जाती है.
रिटर्न
Map<String, Double> एग्रीगेट की गई वैल्यू.

getTestIterations

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

रिटर्न
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

इस फ़ंक्शन से यह पता चलता है कि सूची में मौजूद सभी वैल्यू, डबल वैल्यू हैं या नहीं.

पैरामीटर
rawValues List: जांच करने के लिए वैल्यू की सूची.
रिटर्न
boolean अगर सभी वैल्यू डबल वैल्यू हैं, तो true दिखाता है. अगर ऐसा नहीं है, तो false दिखाता है.

setIterationSeparator

public void setIterationSeparator (String separator)

पैरामीटर
separator String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

यह उन मेट्रिक के लिए रेगुलर एक्सप्रेशन सेट करता है जिन्हें एग्रीगेशन के दौरान औसत की गणना के लिए, पास किए गए टेस्ट के इटरेशन का इस्तेमाल करना चाहिए.

पैरामीटर
metricsUseForTestIterations Set: रेगुलर एक्सप्रेशन स्ट्रिंग का सेट.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

पैरामीटर
percentiles Set

storeTestMetrics

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

इस कुकी का इस्तेमाल, हर टेस्ट की मेट्रिक को सेव करने के लिए किया जाता है. साथ ही, इसका इस्तेमाल एग्रीगेशन के लिए किया जाता है.

पैरामीटर
testDescription TestDescription: इसमें टेस्ट की जानकारी होती है. जैसे, क्लास का नाम और टेस्ट का नाम.
testMetrics Map: टेस्ट के लिए इकट्ठा की गई मेट्रिक.
testFailed boolean: इससे पता चलता है कि टेस्ट फ़ेल हो गया है या नहीं.

storeTestMetrics

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

यह storeTestMetrics का ओवरलोड किया गया वर्शन है, ताकि यह पुराने सिस्टम के साथ काम कर सके. डिफ़ॉल्ट रूप से, testFailed को false पर सेट करता है.

पैरामीटर
testDescription TestDescription

testMetrics Map

writeResultsToFile

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

किसी फ़ाइल में मेट्रिक लिखना.

पैरामीटर
testFileSuffix String: का इस्तेमाल, टेस्ट मेट्रिक फ़ाइल के नाम में सफ़िक्स के तौर पर किया जाता है.
testHeaderName String: मेट्रिक, टेस्ट हेडर के नाम के नीचे लिखी जाएंगी.
metrics Map: फ़ाइल में लिखने के लिए.
resultsFile File: अगर फ़ाइल मौजूद नहीं है, तो नई फ़ाइल बनाएं और उसमें मेट्रिक लिखें. अगर फ़ाइल मौजूद है, तो उसमें टेस्ट हेडर का नाम और मेट्रिक जोड़ें.
रिटर्न
File मेट्रिक वाली फ़ाइल.