MetricUtility

public class MetricUtility
extends Object

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

---

يحتوي على طُرق أدوات شائعة لتخزين مقاييس الاختبار وتجميع المقاييس في اختبارات مشابهة وكتابة المقاييس في ملف.

ملخّص

وظائف الإنشاء العامة
MetricUtility()

الطرق العامة
	aggregateMetrics( rawMetrics) تجميع المقاييس المفصولة بفواصل
File	aggregateStoredTestMetricsAndWriteToFile(String fileName) تجميع المقاييس التي تم جمعها من عدّة تكرارات للاختبار وكتابة المقاييس المجمّعة في ملف نتائج الاختبار
void	buildMetricFilterPatterns( strictIncludeRegEx) أنشئ أنماط تعبيرات عادية لفلترة المقاييس.
	filterMetrics( parsedMetrics) فلتِر المقاييس التي تتطابق مع النمط.
static	getStats( values, percentiles) احتساب الإحصاءات من قائمة القيم المحدّدة
	getStoredTestMetric()
static boolean	isAllDoubleValues( rawValues) عرض القيمة "صحيح" إذا كان بالإمكان تحليل جميع القيم إلى قيمة مزدوجة
void	setIterationSeparator(String separator)
void	setPercentiles( percentiles)
void	storeTestMetrics(TestDescription testDescription, testMetrics) يُستخدَم لتخزين مقاييس الاختبار الفردية واستخدامها للتجميع.
File	writeResultsToFile(String testFileSuffix, String testHeaderName, metrics, File resultsFile) كتابة المقاييس في ملف

وظائف الإنشاء العامة

MetricUtility

public MetricUtility ()

الطرق العامة

aggregateMetrics

public  aggregateMetrics ( rawMetrics)

تجميع المقاييس المفصولة بفواصل

المعلمات
rawMetrics	: المقاييس التي تم جمعها أثناء إجراء الاختبار

المرتجعات
	المقاييس المجمّعة

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

تجميع المقاييس التي تم جمعها من عدّة تكرارات للاختبار وكتابة المقاييس المجمّعة في ملف نتائج الاختبار

المعلمات
fileName	‫String: اسم الملف المطلوب استخدامه أثناء كتابة المقاييس

المرتجعات
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns ( strictIncludeRegEx)

أنشئ أنماط تعبيرات عادية لفلترة المقاييس.

المعلمات
strictIncludeRegEx

filterMetrics

public  filterMetrics ( parsedMetrics)

فلتِر المقاييس التي تتطابق مع النمط.

المعلمات
parsedMetrics

المرتجعات

getStats

public static  getStats ( values, 
                 percentiles)

احتساب الإحصاءات من قائمة القيم المحدّدة

المعلمات
values	: القيم الأوّلية لاحتساب التجميع.
percentiles	: الإحصاءات المطلوب تضمينها في المقاييس النهائية

المرتجعات
	القيم المجمّعة

getStoredTestMetric

public  getStoredTestMetric ()

المرتجعات

isAllDoubleValues

public static boolean isAllDoubleValues ( rawValues)

عرض القيمة "صحيح" إذا كان بالإمكان تحليل جميع القيم إلى قيمة مزدوجة بخلاف ذلك، يتم عرض القيمة false.

المعلمات
rawValues	: قائمة يتم التحقّق من قيمها.

المرتجعات
boolean

setIterationSeparator

public void setIterationSeparator (String separator)

المعلمات
separator	String

setPercentiles

public void setPercentiles ( percentiles)

المعلمات
percentiles

storeTestMetrics

public void storeTestMetrics (TestDescription testDescription, 
                 testMetrics)

يُستخدَم لتخزين مقاييس الاختبار الفردية واستخدامها للتجميع.

المعلمات
testDescription	‫TestDescription: يحتوي على تفاصيل الاختبار، مثل اسم الفئة واسم الاختبار.
testMetrics	: المقاييس التي تم جمعها للاختبار

writeResultsToFile

public File writeResultsToFile (String testFileSuffix, 
                String testHeaderName, 
                 metrics, 
                File resultsFile)

كتابة المقاييس في ملف

المعلمات
testFileSuffix	String: تُستخدَم كلاحقة في اسم ملف مقياس الاختبار.
testHeaderName	String: سيتمّ كتابة المقاييس ضمن اسم عنوان الاختبار.
metrics	‫: للكتابة في الملف
resultsFile	File: إذا كان القيمة فارغة، أنشئ ملفًا جديدًا واكتب المقاييس، وإلا أضِف اسم رأس الاختبار ومقاييسه إلى الملف.

المرتجعات
File	ملف يحتوي على المقياس