MetricUtility

public class MetricUtility
extends Object

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

---

Chứa các phương thức tiện ích chung để lưu trữ chỉ số kiểm thử, tổng hợp các chỉ số trong các kiểm thử tương tự và ghi các chỉ số vào một tệp.

Tóm tắt

Lớp lồng ghép
class	MetricUtility.DimensionalIterationData Lớp trợ giúp để lưu giữ tệp chỉ số theo phương diện và trạng thái cho một lần lặp lại kiểm thử.

Hàm khởi tạo công khai
MetricUtility()

Phương thức công khai
File	aggregateDimensionalMetricsAndWriteToFile(List<MetricUtility.DimensionalIterationData> iterationDataList, Set<Integer> percentiles, String testIterationSeparator) Đọc tất cả các tệp báo cáo chỉ số theo phương diện đã lưu trữ, tổng hợp các giá trị thô, tính toán số liệu thống kê và ghi một tệp báo cáo tổng hợp mới.
Map<String, MetricMeasurement.Metric>	aggregateMetrics(Map<String, MetricMeasurement.Metric> rawMetrics) Tổng hợp các chỉ số được phân tách bằng dấu phẩy.
File	aggregateStoredTestMetricsAndWriteToFile(String fileName) Tổng hợp các chỉ số được thu thập từ nhiều lần lặp lại của kiểm thử và ghi các chỉ số tổng hợp vào một tệp kết quả kiểm thử.
void	buildMetricFilterPatterns(Set<String> strictIncludeRegEx) Tạo các mẫu biểu thức chính quy để lọc chỉ số.
Map<String, MetricMeasurement.Metric>	filterMetrics(Map<String, MetricMeasurement.Metric> parsedMetrics) Lọc những chỉ số khớp với mẫu.
static Map<String, Double>	getStats(List<Double> values, Set<Integer> percentiles, int testIterations) Tính toán số liệu thống kê từ danh sách giá trị đã cho.
Map<String, List<MetricUtility.IterationData>>	getTestIterations()
static boolean	isAllDoubleValues(List<String> rawValues) Kiểm tra xem tất cả các giá trị trong danh sách có phải là giá trị kép hay không.
void	setIterationSeparator(String separator)
void	setMetricsUseForTestIterations(Set<String> metricsUseForTestIterations) Đặt biểu thức chính quy cho các chỉ số nên sử dụng các lần lặp lại kiểm thử đã vượt qua để tính giá trị trung bình trong quá trình tổng hợp.
void	setPercentiles(Set<Integer> percentiles)
void	storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics, boolean testFailed) Được dùng để lưu trữ các chỉ số kiểm thử riêng lẻ và dùng chỉ số này để tổng hợp.
void	storeTestMetrics(TestDescription testDescription, Map<String, MetricMeasurement.Metric> testMetrics) Phiên bản nạp chồng của storeTestMetrics để đảm bảo khả năng tương thích ngược.
File	writeResultsToFile(String testFileSuffix, String testHeaderName, Map<String, String> metrics, File resultsFile) Ghi các chỉ số vào một tệp.

Hàm khởi tạo công khai

MetricUtility

public MetricUtility ()

Phương thức công khai

aggregateDimensionalMetricsAndWriteToFile

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

Đọc tất cả các tệp báo cáo chỉ số theo phương diện đã lưu trữ, tổng hợp các giá trị thô, tính toán số liệu thống kê và ghi một tệp báo cáo tổng hợp mới.

Tham số
iterationDataList	List
percentiles	Set: Các phân vị cần tính.
testIterationSeparator	String: Dấu phân cách cho các lần lặp lại kiểm thử.

Giá trị trả về
File	Một File chứa báo cáo tổng hợp hoặc có giá trị rỗng nếu không có hoạt động tổng hợp nào được thực hiện.

aggregateMetrics

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

Tổng hợp các chỉ số được phân tách bằng dấu phẩy.

Tham số
rawMetrics	Map: các chỉ số được thu thập trong quá trình chạy kiểm thử.

Giá trị trả về
Map<String, MetricMeasurement.Metric>	các chỉ số tổng hợp.

aggregateStoredTestMetricsAndWriteToFile

public File aggregateStoredTestMetricsAndWriteToFile (String fileName)

Tổng hợp các chỉ số được thu thập từ nhiều lần lặp lại của kiểm thử và ghi các chỉ số tổng hợp vào một tệp kết quả kiểm thử.

Tham số
fileName	String: tên tệp dùng khi ghi các chỉ số.

Giá trị trả về
File

buildMetricFilterPatterns

public void buildMetricFilterPatterns (Set<String> strictIncludeRegEx)

Tạo các mẫu biểu thức chính quy để lọc chỉ số.

Tham số
strictIncludeRegEx	Set

filterMetrics

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

Lọc những chỉ số khớp với mẫu.

Tham số
parsedMetrics	Map

Giá trị trả về
Map<String, MetricMeasurement.Metric>

getStats

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

Tính toán số liệu thống kê từ danh sách giá trị đã cho.

Tham số
values	List: giá trị thô để tính toán giá trị tổng hợp.
percentiles	Set: số liệu thống kê cần đưa vào các chỉ số cuối cùng.
testIterations	int: số lần lặp lại cần dùng làm số chia cho giá trị trung bình. Nếu là 0, giá trị trung bình được tính bằng kích thước của danh sách "values".

Giá trị trả về
Map<String, Double>	các giá trị tổng hợp.

getTestIterations

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

Giá trị trả về
Map<String, List<MetricUtility.IterationData>>

isAllDoubleValues

public static boolean isAllDoubleValues (List<String> rawValues)

Kiểm tra xem tất cả các giá trị trong danh sách có phải là giá trị kép hay không.

Tham số
rawValues	List: danh sách các giá trị cần kiểm tra.

Giá trị trả về
boolean	true nếu tất cả các giá trị đều là giá trị kép, false nếu không.

setIterationSeparator

public void setIterationSeparator (String separator)

Tham số
separator	String

setMetricsUseForTestIterations

public void setMetricsUseForTestIterations (Set<String> metricsUseForTestIterations)

Đặt biểu thức chính quy cho các chỉ số nên sử dụng các lần lặp lại kiểm thử đã vượt qua để tính giá trị trung bình trong quá trình tổng hợp.

Tham số
metricsUseForTestIterations	Set: Một tập hợp các chuỗi biểu thức chính quy.

setPercentiles

public void setPercentiles (Set<Integer> percentiles)

Tham số
percentiles	Set

storeTestMetrics

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

Được dùng để lưu trữ các chỉ số kiểm thử riêng lẻ và dùng chỉ số này để tổng hợp.

Tham số
testDescription	TestDescription: chứa thông tin chi tiết về kiểm thử, chẳng hạn như tên lớp và tên kiểm thử.
testMetrics	Map: các chỉ số được thu thập cho kiểm thử.
testFailed	boolean: liệu kiểm thử có thất bại hay không.

storeTestMetrics

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

Phiên bản nạp chồng của storeTestMetrics để đảm bảo khả năng tương thích ngược. Mặc định testFailed là false.

Tham số
testDescription	TestDescription
testMetrics	Map

writeResultsToFile

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

Ghi các chỉ số vào một tệp.

Tham số
testFileSuffix	String: được dùng làm hậu tố trong tên tệp chỉ số kiểm thử.
testHeaderName	String: các chỉ số sẽ được ghi theo tên tiêu đề kiểm thử.
metrics	Map: để ghi vào tệp.
resultsFile	File: nếu giá trị rỗng, hãy tạo một tệp mới và ghi các chỉ số, nếu không, hãy thêm tên tiêu đề kiểm thử và chỉ số vào tệp.

Giá trị trả về
File	tệp có chỉ số.