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 التقرير المجمَّع، أو القيمة null إذا لم يتم إجراء أي تجميع.

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، يتم احتساب المتوسط باستخدام حجم قائمة "القيم".

المرتجعات
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	صحيح إذا كانت جميع القيم قيمًا مضاعفة، وخاطئ في الحالات الأخرى.

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 للتوافق مع الأنظمة القديمة. القيمة التلقائية هي 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	ملف يتضمّن المقياس