IPostProcessor

public interface IPostProcessor
implements IDisableable, ILogSaverListener, ITestInvocationListener

com.android.tradefed.postprocessor.IPostProcessor

已知間接子類別 AggregatePostProcessor、AveragePostProcessor、BasePostProcessor、BluetoothConnectionSuccessRatePostProcessor、MetricFilePostProcessor、PerfettoGenericPostProcessor、StatsdBeforeAfterGaugeMetricPostProcessor、StatsdEventMetricPostProcessor、StatsdGenericPostProcessor AggregatePostProcessor 指標匯總工具，可針對在多次迭代測試執行期間收集到的數值指標，提供最小值、最大值、平均值、變異數、標準差、總數、計數，以及選用的百分位數，並將這些值視為雙精度浮點值。  AveragePostProcessor 實作後置處理器，計算指標清單的平均值。  BasePostProcessor 每個實作項目都應擴充的基本 IPostProcessor。  BluetoothConnectionSuccessRatePostProcessor 實作後置處理器，計算藍牙設定檔的成功率 使用「metric-key-match」指定包含藍牙連線狀態的指標，並以數值陣列表示，例如 [0, 1, 2, 3, 0, 1, 2, 3]。  MetricFilePostProcessor 用於上傳在測試和執行層級收集的指標記錄檔案。  PerfettoGenericPostProcessor 後置處理器會以遞迴方式展開 proto 訊息和字串值欄位，直到遇到數值欄位為止，藉此將文字/二進位指標資料處理成鍵/值組合。  StatsdBeforeAfterGaugeMetricPostProcessor 後續處理器會處理以「前後」方式收集的評估指標，也就是 StatsdEventMetricPostProcessor 後置處理器，可使用處理器上指定的格式化工具，將 statsd 報表中的事件指標轉換為鍵/值組合。  StatsdGenericPostProcessor 後置處理器，可將二進位值 Proto 統計資料報表處理為鍵/值組合，方法是將報表展開為樹狀結構。

---

後置處理器是 Trade Federation 物件，可在測試完成後及結果回報前處理指標和記錄。這樣一來，您就能對部分資料進行後置處理，並讓所有 result_reporter 物件接收，而不是只在一個 result_reporter 中執行後置處理，並在傳遞新資料時發生問題。

摘要

公用方法
abstract ITestInvocationListener	init(ITestInvocationListener listener) 後置處理器的初始化步驟。
abstract	processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) 實作此方法，匯總所有測試的指標和記錄。
abstract	processRunMetricsAndLogs( rawMetrics, runLogs) 實作此方法，即可從現有指標和記錄產生一組新指標。
abstract	processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs) 實作此方法，以便從每項測試中後處理指標和記錄。

公用方法

init

public abstract ITestInvocationListener init (ITestInvocationListener listener)

後置處理器的初始化步驟。請務必在任何測試回呼之前呼叫。

參數
listener	ITestInvocationListener

傳回
ITestInvocationListener

processAllTestMetricsAndLogs

public abstract  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

實作此方法，匯總所有測試的指標和記錄。這個方法產生的指標會以執行指標的形式回報。請只傳回新產生的指標，並附上專屬的鍵名稱 (不得與現有鍵衝突)。

參數
allTestMetrics	ListMultimap：HashMultimap，用於儲存各項測試的指標，並依指標名稱分組。
allTestLogs	：儲存每個測試的記錄檔案地圖，並以資料名稱做為索引，使用每個測試的 TestDescription 做為索引鍵。

傳回
	從所有測試指標產生的全新指標組合。

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

實作此方法，即可從現有指標和記錄產生一組新指標。請只傳回新產生的指標，並附上專屬的鍵名稱 (不得與現有鍵衝突)。

參數
rawMetrics	：可用於執行作業的原始指標集。
runLogs	：測試執行作業的記錄檔集合。

傳回
	從執行指標新產生的指標組合。

processTestMetricsAndLogs

public abstract  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

實作此方法，以便從每項測試中後處理指標和記錄。請只傳回新產生的指標，並附上專屬的鍵名稱 (不得與現有鍵重複)。

參數
testDescription	TestDescription：描述測試的 TestDescription 物件。
testMetrics	：測試的一系列指標。
testLogs	：測試期間記錄的檔案集合。

傳回
	從測試指標新產生的指標組合。