متریکوتیولیتی

public class MetricUtility
extends 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) بررسی می‌کند که آیا تمام مقادیر موجود در لیست، مقادیر double هستند یا خیر.
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) نوشتن معیارها در یک فایل.

سازندگان عمومی

متریکوتیولیتی

public MetricUtility ()

روش‌های عمومی

aggregateDimensionalMetricsAndWriteToFile

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

تمام فایل‌های گزارش متریک ابعادی ذخیره شده را می‌خواند، مقادیر خام را جمع می‌کند، آمار را محاسبه می‌کند و یک فایل گزارش جمع‌بندی شده جدید می‌نویسد.

پارامترها
iterationDataList	List
percentiles	Set : صدک‌هایی که باید محاسبه شوند.
testIterationSeparator	String : جداکننده برای تکرارهای آزمایشی.

بازگشت‌ها
File	File حاوی گزارش تجمیع‌شده، یا اگر تجمیعی انجام نشده باشد، تهی (null).

معیارهای تجمیعی

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

الگوهای فیلتر متریک ساخت

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

الگوهای عبارات منظم را برای فیلتر کردن معیارها بسازید.

پارامترها
strictIncludeRegEx	Set

فیلتر متریک‌ها

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

معیارهایی را که با الگو مطابقت دارند فیلتر کنید.

پارامترها
parsedMetrics	Map

بازگشت‌ها
Map<String, MetricMeasurement.Metric>

دریافت آمار

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

آمار را از لیست مقادیر ارائه شده محاسبه کنید.

پارامترها
values	List : مقادیر خام برای محاسبه تجمیع.
percentiles	Set : آمارهایی که باید در معیارهای نهایی لحاظ شوند.
testIterations	int : تعداد تکرارها برای استفاده به عنوان مقسوم علیه میانگین. اگر ۰ باشد، میانگین با استفاده از اندازه لیست «مقادیر» محاسبه می‌شود.

بازگشت‌ها
Map<String, Double>	مقادیر تجمیع شده

تکرارهای تست دریافت‌شده

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

بازگشت‌ها
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

بررسی می‌کند که آیا تمام مقادیر موجود در لیست، مقادیر double هستند یا خیر.

پارامترها
rawValues	List : فهرستی از مقادیری که باید بررسی شوند.

بازگشت‌ها
boolean	اگر همه مقادیر از نوع double باشند، مقدار true و در غیر این صورت false برمی‌گرداند.

جداکننده‌ی تکرار تنظیم‌شده

public void setIterationSeparator (String separator)

پارامترها
separator	String

تکرارهای setMetricsUseForTest

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

عبارات منظم را برای معیارهایی که باید از تکرارهای آزمون پذیرفته شده برای محاسبه میانگین در طول تجمیع استفاده کنند، تنظیم می‌کند.

پارامترها
metricsUseForTestIterations	Set : مجموعه‌ای از رشته‌های عبارات منظم.

تنظیم درصدها

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

نوشتن نتایج به فایل

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

نوشتن معیارها در یک فایل.

پارامترها
testFileSuffix	String : به عنوان پسوند در نام فایل معیار آزمون استفاده می‌شود.
testHeaderName	String : معیارها زیر نام سربرگ آزمون نوشته خواهند شد.
metrics	Map : برای نوشتن در فایل.
resultsFile	File : اگر null باشد، یک فایل جدید ایجاد کنید و معیارها را بنویسید، در غیر این صورت نام هدر تست و معیار را به فایل اضافه کنید.

بازگشت‌ها
File	با معیار مربوطه ثبت کنید.