ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener


允許 ITestInvocationListener 監聽記錄檔儲存時的情況。

如此一來,多個 ITestInvocationListener 在產生報表時,就能使用相同的儲存記錄檔,而且不必在呼叫 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 時讓每個事件監聽器個別儲存檔案。

實作此介面的類別應注意,每次呼叫 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 時都會呼叫 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)

此類別也會傳遞全域 ILogSaver 例項,讓 ITestInvocationListener 能將其他檔案儲存在同一個位置。

摘要

公用方法

default void logAssociation(String dataName, LogFile logFile)

在某些情況下,記錄必須與測試案例密切相關,但可能無法使用直接 testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) 回呼執行這項操作。

default void setLogSaver(ILogSaver logSaver)

設定 ILogSaver,允許實作器儲存檔案。

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

儲存測試記錄時呼叫。

公用方法

logAssociation

public 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,應與測試案例相關聯。

setLogSaver

public void setLogSaver (ILogSaver logSaver)

設定 ILogSaver,允許實作者儲存檔案。

參數
logSaver ILogSaverILogSaver

testLogSaved

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

儲存測試記錄時呼叫。

應改用 ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)

參數
dataName String:資料的 String 描述性名稱,例如「device_logcat」。請注意,每個叫用作業的 dataName 可能不具唯一性。也就是說,實作者必須能夠處理具有相同 dataName 的多個呼叫

dataType LogDataType:資料的 LogDataType

dataStream InputStreamSource:資料的 InputStreamSource。實作者應呼叫 createInputStream 以開始讀取資料,並確保在完成時關閉產生的 InputStream。

logFile LogFile:包含儲存檔案中繼資料的 LogFile