此页面由 Cloud Translation API 翻译。

日志文件保存器

public class LogFileSaver
extends Object

java.lang.Object 中
↳	com.android.tradefed.result.LogFileSaver

ITestInvocationListener 的帮助程序，可将日志数据保存到文件中

摘要

公共构造函数
`LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays)` 创建 `LogFileSaver`。
`LogFileSaver(IBuildInfo buildInfo, File rootDir)` 创建 `LogFileSaver`。
`LogFileSaver(File rootDir)` 另一个 `LogFileSaver` 构造函数，它会仅使用指定目录作为日志存储目录中。

公共方法
`File`	`createCompressedLogFile(String dataName, LogDataType origDataType)` 创建一个空文件，用于存储压缩的日志数据。
`OutputStream`	`createGZipLogStream(File logFile)` 创建输出流，以将经过 GZIP 压缩的数据写入文件
`InputStream`	`createInputStreamFromFile(File logFile)` 用于创建输入流以读取给定日志 Fi 的内容的辅助方法 TODO：考虑将此方法移至其他位置。
`File`	`getFileDir()` 获取用于存储文件的目录。
	`getInvocationLogPathSegments()`
`File`	`saveAndGZipLogData(String dataName, LogDataType dataType, InputStream dataStream)` 如有必要，将日志数据保存并压缩为 gzip 文件
`File`	`saveAndGZipLogFile(String dataName, LogDataType dataType, File fileToLog)` 如有必要，将日志数据保存并压缩为 gzip 文件
`File`	`saveLogData(String dataName, LogDataType dataType, InputStream dataStream)` 将日志数据保存到文件中
`File`	`saveLogDataRaw(String dataName, String ext, InputStream dataStream)` 将原始数据保存到文件
`File`	`saveLogFile(String dataName, LogDataType dataType, File fileToLog)` 保存给定的日志文件

公共构造函数

日志文件保存器

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir, 
                Integer logRetentionDays)

创建 LogFileSaver。

在 rootDir/branch/build_id/testTag/uniqueDir 中构造唯一的文件系统目录

参数
`buildInfo`	`IBuildInfo`：`IBuildInfo`
`rootDir`	`File`：根文件系统路径
`logRetentionDays`	`Integer`：如果提供了“.retention”文件将写入日志目录包含等于当前时间 + logRetentionDays 的时间戳。外部清理脚本可以使用此文件来确定何时删除日志目录。

日志文件保存器

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir)

创建 LogFileSaver。

在 rootDir/branch/build_id/uniqueDir 中构造唯一的文件系统目录

参数
`buildInfo`	`IBuildInfo`：`IBuildInfo`
`rootDir`	`File`：根文件系统路径

日志文件保存器

public LogFileSaver (File rootDir)

另一个 LogFileSaver 构造函数，它会仅使用指定目录作为日志存储目录中。

公共方法

createCompressedLogFile

public File createCompressedLogFile (String dataName, 
                LogDataType origDataType)

创建一个空文件，用于存储压缩的日志数据。

参数
`dataName`	`String`：要存储的数据的 `String` 描述性名称。
`origDataType`	`LogDataType`：要存储的 `LogDataType` 的类型

返回
`File`	`ERROR(/File)`

抛出
	如果无法创建日志文件

createGZipLogStream

public OutputStream createGZipLogStream (File logFile)

创建输出流，以将经过 GZIP 压缩的数据写入文件

参数
`logFile`	`File`：要写入的 `ERROR(/File)`

返回
`OutputStream`	`ERROR(/OutputStream)`，用于压缩数据并将数据写入文件。播放完毕时此直播

抛出
	如果无法生成信息流

createInputStreamFromFile

public InputStream createInputStreamFromFile (File logFile)

用于创建输入流以读取给定日志 Fi 的内容的辅助方法

TODO：考虑将此方法移至其他位置。暂时放置在此处，因此此类用户进行模拟。

参数
`logFile`	`File`：要读取的 `ERROR(/File)`

返回
`InputStream`	缓冲的 `ERROR(/InputStream)` 来读取文件数据。来电者必须致电播放完毕时此直播

抛出
	如果无法生成信息流

getFileDir

public File getFileDir ()

获取用于存储文件的目录。

返回
`File`	`ERROR(/File)` 目录

getInvocationLogPathSegments

public  getInvocationLogPathSegments ()

返回
	唯一的调用日志路径段。

SaveAndGZipLogData

public File saveAndGZipLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

如有必要，将日志数据保存并压缩为 gzip 文件

参数
`dataName`	`String`：数据的 `String` 描述性名称。
`dataType`	`LogDataType`：文件的 `LogDataType`。日志数据是一个（即 `LogDataType#isCompressed()` 为 `true`）
`dataStream`	`InputStream`：数据的 `ERROR(/InputStream)`。

返回
`File`	包含所生成数据的文件

抛出
	如果无法生成日志文件

SaveAndGZipLogFile

public File saveAndGZipLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

如有必要，将日志数据保存并压缩为 gzip 文件

参数
`dataName`	`String`：数据的 `String` 描述性名称。
`dataType`	`LogDataType`：文件的 `LogDataType`。日志数据为（即 `LogDataType.isCompressed()` 为 `true`）
`fileToLog`	`File`：要保存的 `ERROR(/File)`

返回
`File`	包含所生成数据的文件

抛出
	如果无法生成日志文件

保存日志数据

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

将日志数据保存到文件中

参数
`dataName`	`String`：数据的 `String` 描述性名称。
`dataType`	`LogDataType`：文件的 `LogDataType`。
`dataStream`	`InputStream`：数据的 `ERROR(/InputStream)`。

返回
`File`	包含所生成数据的文件

抛出
	如果无法生成日志文件

SaveLogDataRaw

public File saveLogDataRaw (String dataName, 
                String ext, 
                InputStream dataStream)

将原始数据保存到文件

参数
`dataName`	`String`：数据的 `String` 描述性名称。
`ext`	`String`：日期的扩展
`dataStream`	`InputStream`：数据的 `ERROR(/InputStream)`。

返回
`File`	包含所生成数据的文件

抛出
	如果无法生成日志文件

保存日志文件

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

保存给定的日志文件

参数
`dataName`	`String`：数据的 `String` 描述性名称。
`dataType`	`LogDataType`：文件的 `LogDataType`。
`fileToLog`	`File`：要记录的 `ERROR(/File)`

返回
`File`	包含所生成数据的文件

抛出
	如果无法生成日志文件