BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object繼承
↳	com.android.tradefed.postprocessor.BasePostProcessor

已知直接子類

AggregatePostProcessor ， AveragePostProcessor

AggregatePostProcessor	度量聚合器，使該最小值，最大值，平均值，用於在多迭代測試運行收集的數字度量方差和標準偏差，將它們視為雙打。
AveragePostProcessor	後置處理器的實現，計算平均指標的清單。

該基地IPostProcessor每個執行應該擴展。確保後處理方法的最終結果之前，記者叫。

TODO：如果需要擴展到文件後處理過。

摘要

公共構造
`BasePostProcessor ()`

公共方法
`final ITestInvocationListener`	`init ( ITestInvocationListener listener)` 所述後處理器的初始化步驟。
`final void`	`invocationEnded (long elapsedTime)` 報導稱，該調用已經終止，是否成功，由於一些錯誤條件。
`final void`	`invocationFailed (Throwable cause)` 報告不完整的調用由於一些錯誤條件。
`final void`	`invocationStarted ( IInvocationContext context)` 調用監聽器轉發
`final boolean`	`isDisabled ()` 返回true如果整個對象禁用（跳過這兩者的安裝和拆卸）。
`final void`	`logAssociation (String dataName, LogFile logFile)` 在某些情況下，日誌必須堅決與測試用例相關聯，但機會就直接這樣做`testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)`回調是不可能的。
	`processAllTestMetrics (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics)` 實現此方法匯總測試指標。
`abstract`	`processRunMetrics ( rawMetrics)` `processRunMetrics ( rawMetrics)` 為了生成從所述現有的一組新的度量實現此方法。
	`processTestMetrics ( TestDescription testDescription, testMetrics)` `processTestMetrics ( TestDescription testDescription, testMetrics)` {} @inhericDoc
`final void`	`setLogSaver ( ILogSaver logSaver)` 設置`ILogSaver`允許實現者保存文件。
`final void`	`testAssumptionFailure ( TestDescription test, String trace)` 當調用原子彈試驗的標誌，它假定的條件是假的
`final void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` 替代`ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`在這裡我們可以直接指定的結束時間。
`final void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` 報告一個單獨的測試盒的執行結束。
`final void`	`testFailed ( TestDescription test, String trace)` 報告一個單獨的測試案例的失敗。
`final void`	`testIgnored ( TestDescription test)` 稱為當測試將不會被運行，通常是因為測試方法都被註解org.junit.Ignore。
`final void`	`testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)` 提供從測試調用相關的日誌或調試數據。
`final void`	`testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` 當測試日誌保存調用。
`final void`	`testRunEnded (long elapsedTime, runMetrics)` `testRunEnded (long elapsedTime, runMetrics)` 報告結束試運行。
`final void`	`testRunFailed (String errorMessage)` 報告試運行未能完全是由於一個致命錯誤。
`final void`	`testRunStarted (String runName, int testCount, int attemptNumber)` 報告試運行的開始。
`final void`	`testRunStarted (String runName, int testCount)` 測試運行回調
`final void`	`testRunStopped (long elapsedTime)` 報告試運行完成前停止由於用戶請求。
`final void`	`testStarted ( TestDescription test, long startTime)` 替代`testStarted(com.android.tradefed.result.TestDescription)`開始測試的時候，我們也可以指定，結合`ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))`為準確測量。
`final void`	`testStarted ( TestDescription test)` 測試用例回調

公共構造

BasePostProcessor

public BasePostProcessor ()

公共方法

在裡面

public final ITestInvocationListener init ( ITestInvocationListener listener)

所述後處理器的初始化步驟。確保之前的任何測試的回調被調用。

參數
`listener`	`ITestInvocationListener`

返回
`ITestInvocationListener`

invocationEnded

public final void invocationEnded (long elapsedTime)

報導稱，該調用已經終止，是否成功，由於一些錯誤條件。

將由TradeFederation框架被自動調用。

參數
`elapsedTime`	`long` ：在毫秒調用的經過時間

invocationFailed

public final void invocationFailed (Throwable cause)

報告不完整的調用由於一些錯誤條件。

將由TradeFederation框架被自動調用。

參數
`cause`	`Throwable` ：在`Throwable`失敗的原因

invocationStarted

public final void invocationStarted ( IInvocationContext context)

調用監聽器轉發

參數
`context`	`IInvocationContext` ：關於調用的信息

被禁用

public final boolean isDisabled ()

返回true如果整個對象禁用（跳過這兩者的安裝和拆卸）。否則為false。

返回
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

在某些情況下，日誌必須堅決與測試用例相關聯，但機會就直接這樣做testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)回調是不可能的。因此，此回調可以明確地提供了強有力的關係。

參數
`dataName`	`String` ：數據的名稱
`logFile`	`LogFile` ：該`LogFile`是在登錄之前，應與測試用例關聯。

processAllTestMetrics

public  processAllTestMetrics (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics)

實現此方法匯總測試指標。

參數
`allTestMetrics`	`ListMultimap` ：甲HashMultimap存儲從通過量度名稱分組每個測試的指標。

返回
	所有測試指標的一套新產生的指標。

processRunMetrics

public abstract  processRunMetrics ( rawMetrics)

為了生成從所述現有的一組新的度量實現此方法。只有新生成的度量應該返回，並具有獨特的鍵名（與現有鍵無衝突被允許）。

參數
`rawMetrics`	：一組可用於運行原始指標的。

返回
	該組從運行指標，新生成的指標。

processTestMetrics

public  processTestMetrics ( TestDescription testDescription, 
                 testMetrics)

{} @inhericDoc

參數
`testDescription`	`TestDescription` ：描述測試的TestDescription對象。
`testMetrics`	：該組從測試度量。

返回
	該組從測試度量新生成的指標。

setLogSaver

public final void setLogSaver ( ILogSaver logSaver)

設置ILogSaver允許實現者保存文件。

參數
`logSaver`	`ILogSaver` ：在`ILogSaver`

testAssumptionFailure

public final void testAssumptionFailure ( TestDescription test, 
                String trace)

當調用原子彈試驗的標誌，它假定的條件是假的

參數
`test`	`TestDescription` ：識別測試
`trace`	`String` ：失敗的堆棧跟踪

testEnded

public final void testEnded ( TestDescription test, 
                long endTime, 
                 testMetrics)

替代ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))在這裡我們可以直接指定的結束時間。兼備testStarted(com.android.tradefed.result.TestDescription, long)用於精確的測量。

參數
`test`	`TestDescription` ：識別測試
`endTime`	`long` ：試驗結束時，通過測定`System.currentTimeMillis()`
`testMetrics`	：一個`ERROR(/Map)`的指標的發射

testEnded

public final void testEnded ( TestDescription test, 
                 testMetrics)

報告一個單獨的測試盒的執行結束。

如果testFailed(TestDescription, String)沒有被引用，這個測試通過。也返回其可以測試用例的執行期間被發射的任何鍵/值指標。

參數
`test`	`TestDescription` ：識別測試
`testMetrics`	：一個`ERROR(/Map)`的指標的發射

testFailed

public final void testFailed ( TestDescription test, 
                String trace)

報告一個單獨的測試案例的失敗。

將testStarted和testEnded之間被調用。

參數
`test`	`TestDescription` ：識別測試
`trace`	`String` ：失敗的堆棧跟踪

testIgnored

public final void testIgnored ( TestDescription test)

稱為當測試將不會被運行，通常是因為測試方法都被註解org.junit.Ignore。

參數
`test`	`TestDescription` ：識別測試

TESTLOG

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

提供從測試調用相關的日誌或調試數據。

前，必須調用ITestInvocationListener#invocationFailed(Throwable)或ITestInvocationListener#invocationEnded(long)

該TradeFederation框架會自動調用該方法，提供主機日誌，如果適用，設備logcat的。

參數
`dataName`	`String` ：一個`String`數據的描述性名稱。例如，“device_logcat”。注意數據名稱可能不是每次調用唯一的。即實施者必須能夠處理與同一數據名多次調用
`dataType`	`LogDataType` ：在`LogDataType`數據
`dataStream`	`InputStreamSource` ：在`InputStreamSource`數據。實施者應該叫createInputStream開始讀取數據，並確保完成時關閉造成的InputStream。調用者應該確保數據的源仍然存在，並且訪問，直到TESTLOG方法完成。

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

當測試日誌保存調用。

應該代替使用ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)

參數
`dataName`	`String` ：一個`String`數據的描述性名稱。例如，“device_logcat”。注意數據名稱可能不是每次調用唯一的。即實施者必須能夠處理與同一數據名多次調用
`dataType`	`LogDataType` ：在`LogDataType`數據
`dataStream`	`InputStreamSource` ：在`InputStreamSource`數據。實施者應該叫createInputStream開始讀取數據，並確保完成時關閉造成的InputStream。
`logFile`	`LogFile` ：該`LogFile`包含所保存的文件的元數據。

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

報告結束試運行。 FIXME：我們不能有兩個地圖<>接口與不同類型的，所以我們要使用的HashMap這裡。

參數
`elapsedTime`	`long` ：設備報告經過的時間，以毫秒為單位
`runMetrics`	：鍵值對報導有測試運行結束`Metric` 。

testRunFailed

public final void testRunFailed (String errorMessage)

報告試運行未能完全是由於一個致命錯誤。

參數
`errorMessage`	`String` ： `String`描述的原因啟動失敗。

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

報告試運行的開始。

參數
`runName`	`String` ：試運行名
`testCount`	`int` ：在試運行的測試總數
`attemptNumber`	`int` ：訂單號，識別多次運行相同runName的不同嘗試。該attemptNumber是0索引，應增加每次新的運行情況。例如，A的測試是粒狀重試3次，它應具有相同的runName下4總運行並且attemptNumber是從0到3。

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

測試運行回調

參數
`runName`	`String` ：試運行名
`testCount`	`int` ：在試運行的測試總數

testRunStopped

public final void testRunStopped (long elapsedTime)

報告試運行完成前停止由於用戶請求。

TODO：當前未使用，考慮刪除

參數
`elapsedTime`	`long` ：設備報告經過的時間，以毫秒為單位

testStarted

public final void testStarted ( TestDescription test, 
                long startTime)

替代testStarted(com.android.tradefed.result.TestDescription)開始測試的時候，我們也可以指定，結合ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))為準確測量。

參數
`test`	`TestDescription` ：識別測試
`startTime`	`long` ：試驗開始時的時間，通過測量`System.currentTimeMillis()`

testStarted

public final void testStarted ( TestDescription test)

測試用例回調

參數
`test`	`TestDescription` ：識別測試