本頁面由 Cloud Translation API 翻譯而成。

檔案系統記錄儲存器

public class FileSystemLogSaver
extends Object implements ILogSaver

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

已知直接子類別

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 ()

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)

儲存記錄檔。

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

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

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

public void setCompressFiles (boolean compress)

參數
`compress`	`boolean`

protected File generateLogReportDir (IBuildInfo buildInfo, 
                File reportDir)

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

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

傳回
`File`	已建立的目錄。