此页面由 Cloud Translation API 翻译。

LogSaverResultForwarder（日志保存结果转发器）

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object 中
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.LogSaverResultForwarder

已知的直接子类

RetryLogSaverResultForwarder

RetryLogSaverResultForwarder 转发器，也负责传递我们所处的当前尝试。

ResultForwarder，用于通过全局文件保存程序保存日志。

摘要

公共构造函数
`LogSaverResultForwarder(ILogSaver logSaver, listeners, IConfiguration config)`

公共方法
`void`	`invocationEnded(long elapsedTime)` 报告调用已终止（无论是成功终止还是由于某些错误）条件。
`void`	`invocationStarted(IInvocationContext context)` 报告测试调用的开始。
`void`	`logAssociation(String dataName, LogFile logFile)` 在某些情况下，日志必须与测试用例密切相关，以此类推，`testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` 回调。
`static void`	`logFile( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type)` 在完成前记录最终文件
`static void`	`reportEndHostLog( listeners, ILogSaver saver, String name)` 报告正在进行的会话的 host_log。
`void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` 提供来自测试调用的关联日志或调试数据。此外，使用全局 `ILogSaver` 保存日志文件并调用 `ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile)` 实现 `ILogSaverListener` 接口的监听器。
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` 仅转发 testLog，而不是先保存日志。
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` 在保存测试日志时调用。如果 `LogSaverResultForwarder` 封装在另一个函数中，请确保转发 testLogSaved 回调传递给其下的监听器。

公共构造函数

LogSaverResultForwarder（日志保存结果转发器）

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners, 
                IConfiguration config)

参数
`logSaver`	`ILogSaver`
`listeners`
`config`	`IConfiguration`

公共方法

invocationEnded

public void invocationEnded (long elapsedTime)

报告调用已终止（无论是成功终止还是由于某些错误）条件。

将由 TradeFederation 框架自动调用。

参数
`elapsedTime`	`long`：调用所用的时间（以毫秒为单位）

invocationStarted

public void invocationStarted (IInvocationContext context)

报告测试调用的开始。

将由 TradeFederation 框架自动调用。报告者需要覆盖此方法支持多设备报告。

参数
`context`	`IInvocationContext`：调用的相关信息

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` 之前记录，应与测试用例。

日志文件

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

在完成前记录最终文件

参数
`listeners`
`saver`	`ILogSaver`
`source`	`InputStreamSource`
`name`	`String`
`type`	`LogDataType`

reportEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

报告正在进行的会话的 host_log。

参数
`listeners`
`saver`	`ILogSaver`
`name`	`String`

testLog

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

提供来自测试调用的关联日志或调试数据。

必须在 ERROR(/ITestInvocationListener#invocationFailed(Throwable)) 或之前调用 ERROR(/ITestInvocationListener#invocationEnded(long))

TradeFederation 框架将自动调用此方法，并提供主机日志以及设备 logcat（如果适用）。

此外，使用全局 ILogSaver 保存日志文件并调用 ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) 实现 ILogSaverListener 接口的监听器。

参数
`dataName`	`String`：数据的 `String` 描述性名称。例如“device_logcat”。注意事项每次调用的 dataName 可能不唯一。例如，实施人员必须能够处理具有相同 dataName 的多个调用
`dataType`	`LogDataType`：数据的 `LogDataType`
`dataStream`	`InputStreamSource`：数据的 `InputStreamSource`。实现人员应调用 createInputStream 以开始读取数据，并确保关闭生成的 InputStream。调用方应确保数据的来源保持不变存在且可访问，直到 testLog 方法完成为止。

testLogForward

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

仅转发 testLog，而不是先保存日志。

参数
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

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

在保存测试日志时调用。

应用于替代 ITestInvocationListener#testLog(String, LogDataType, InputStreamSource)。

如果 LogSaverResultForwarder 封装在另一个函数中，请确保转发 testLogSaved 回调传递给其下的监听器。

参数
`dataName`	`String`：数据的 `String` 描述性名称。例如“device_logcat”。注意事项每次调用的 dataName 可能不唯一。例如，实施人员必须能够处理具有相同 dataName 的多个调用
`dataType`	`LogDataType`：数据的 `LogDataType`
`dataStream`	`InputStreamSource`：数据的 `InputStreamSource`。实现人员应调用 createInputStream 以开始读取数据，并确保关闭生成的 InputStream。
`logFile`	`LogFile`：包含已保存文件的元数据的 `LogFile`。