檔案系統記錄儲存器

public class FileSystemLogSaver
extends Object implements ILogSaver

java.lang.Object
↳	com.android.tradefed.result.FileSystemLogSaver

已知直接子類別 ATestFileSystemLogSaver ATestFileSystemLogSaver ATest 會使用這個 LogSaver 類別將記錄儲存在特定路徑中。

---

將記錄儲存至檔案系統。

摘要

公用建構函式
FileSystemLogSaver()

公用方法
LogFile	getLogReportDir() 取得含有儲存記錄目錄的路徑和/或網址的 LogFile。
void	invocationEnded(long elapsedTime) 回報叫用已終止 (無論成功或因某些錯誤而終止) 值。
void	invocationStarted(IInvocationContext context) 回報測試叫用開始的時間。 另外，請在 report-dir/[branch/]build-id/test-tag/unique_dir 下建立不重複的檔案系統目錄來儲存記錄。
LogFile	saveLogData(String dataName, LogDataType dataType, InputStream dataStream) 儲存記錄資料。 如果 LogDataType#isCompressed() 傳回 false，系統會壓縮並儲存記錄檔 已設定「dataType」和「compressed-files」，否則系統會儲存串流內容 未壓縮。
LogFile	saveLogFile(String dataName, LogDataType dataType, File fileToLog) 儲存記錄檔。
void	setCompressFiles(boolean compress)

保護方法
File	generateLogReportDir(IBuildInfo buildInfo, File reportDir) 公開的方法，允許子類別自訂產生路徑邏輯。

公用建構函式

檔案系統記錄儲存器

public FileSystemLogSaver ()

公用方法

getLogReportDir

public LogFile getLogReportDir ()

取得含有儲存記錄目錄的路徑和/或網址的 LogFile。

傳回
LogFile	LogFile。

已叫用

public void invocationEnded (long elapsedTime)

回報叫用已終止 (無論成功或因某些錯誤而終止) 值。

之後，再由貿易聯盟架構自動呼叫 系統會呼叫 ITestInvocationListener#invocationEnded(long)。

參數
elapsedTime	long：叫用的經過時間 (以毫秒為單位)

叫用

public void invocationStarted (IInvocationContext context)

回報測試叫用開始的時間。

會由 TradeFederation 架構自動呼叫，早於 系統會呼叫 ITestInvocationListener#invocationStarted(IInvocationContext)。

另外，請在 report-dir/[branch/]build-id/test-tag/unique_dir 下建立不重複的檔案系統目錄來儲存記錄。如果建立 目錄失敗，會將記錄寫入本機檔案系統的臨時目錄。

參數
context	IInvocationContext：叫用的相關資訊。

儲存記錄資料

public LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

儲存記錄資料。

每次呼叫 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 時，TradeFederation 架構會自動呼叫。這可能會 也能做為儲存其他記錄資料的輔助方法。

視實作方式和政策而定，記錄可能會以壓縮格式儲存。 記錄檔也可能儲存在交易無法存取的位置。

如果 LogDataType#isCompressed() 傳回 false，系統會壓縮並儲存記錄檔 已設定「dataType」和「compressed-files」，否則系統會儲存串流內容 未壓縮。

參數
dataName	String：資料的 String 描述性名稱。例如：「device_logcat」
dataType	LogDataType：檔案的 LogDataType。
dataStream	InputStream：資料的 ERROR(/InputStream)。

傳回
LogFile	包含已儲存檔案的路徑和網址的 LogFile。

儲存記錄檔

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

儲存記錄檔。

每次呼叫 ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) 且 串流參照檔案

視實作方式和政策而定，記錄可能會以壓縮格式儲存。 記錄檔也可能儲存在交易無法存取的位置。

參數
dataName	String：資料的 String 描述性名稱。例如：「device_logcat」
dataType	LogDataType：檔案的 LogDataType。
fileToLog	File：要儲存的 ERROR(/File)。

傳回
LogFile	包含已儲存檔案的路徑和網址的 LogFile。

setCompressFiles

public void setCompressFiles (boolean compress)

參數
compress	boolean

保護方法

產生 LogReportDir

protected File generateLogReportDir (IBuildInfo buildInfo, 
                File reportDir)

公開的方法，允許子類別自訂產生路徑邏輯。

參數
buildInfo	IBuildInfo：IBuildInfo
reportDir	File：報表目錄的 ERROR(/File)。

傳回
File	已建立的目錄。