自 2025 年 3 月 27 日起，我们建议您使用 android-latest-release 而非 aosp-main 构建 AOSP 并为其做出贡献。如需了解详情，请参阅 AOSP 的变更。

此页面由 Cloud Translation API 翻译。

TerribleFailureEmailHandler

public class TerribleFailureEmailHandler
extends Object implements ITerribleFailureHandler

java.lang.Object
↳	com.android.tradefed.log.TerribleFailureEmailHandler

一个简单的处理程序类，用于在 Trade Federation 实例中发生 WTF（糟糕的失败）错误时向感兴趣的人员发送电子邮件。

摘要

公共构造函数
`TerribleFailureEmailHandler()` 创建 `TerribleFailureEmailHandler`

受保护的构造函数
`TerribleFailureEmailHandler(IEmail mailer)` 创建一个包含要使用的自定义 `IEmail` 实例的 `TerribleFailureEmailHandler`。

公共方法
`void`	`addDestination(String dest)` 添加电子邮件目标地址。
`boolean`	`onTerribleFailure(String description, Throwable cause)` 当 `LogUtil.CLog.wtf(String, Throwable)` 中发生严重失败时触发
`void`	`setMinEmailInterval(long interval)` 设置最小电子邮件间隔时间。
`void`	`setSender(String sender)` 设置电子邮件发件人地址。

受保护的方法
`String`	`generateEmailBody(String message, Throwable cause)` 用于为 WTF 电子邮件报告生成正文的方法。
`IEmail.Message`	`generateEmailMessage(String description, Throwable cause)` 根据已收集的属性（主题、发件人、收件人）以及说明和原因（可选）生成新的电子邮件消息
`String`	`generateEmailSubject()` 用于生成电子邮件报告主题的方法。
`long`	`getCurrentTimeMillis()` 以毫秒为单位获取当前时间。
`String`	`getLocalHostName()` 获取机器的本地主机名。

public TerribleFailureEmailHandler ()

protected TerribleFailureEmailHandler (IEmail mailer)

创建一个包含要使用的自定义 IEmail 实例的 TerribleFailureEmailHandler。

公开以进行单元测试。

参数
`mailer`	`IEmail`：要使用的 `IEmail` 实例。

public void addDestination (String dest)

添加电子邮件目标地址。

public boolean onTerribleFailure (String description, 
                Throwable cause)

当 LogUtil.CLog.wtf(String, Throwable) 中发生严重失败时触发

参数
`description`	`String`：对发生的严重故障的摘要
`cause`	`Throwable`：（可选）包含严重失败的堆栈轨迹

返回
`boolean`	如果成功处理，则为 true；否则为 false

public void setMinEmailInterval (long interval)

设置最小电子邮件间隔时间。

public void setSender (String sender)

设置电子邮件发件人地址。

protected String generateEmailBody (String message, 
                Throwable cause)

用于为 WTF 电子邮件报告生成正文的方法。

参数
`message`	`String`：严重失败的摘要
`cause`	`Throwable`：包含堆栈轨迹信息的抛出对象

返回
`String`	包含要用于电子邮件报告的正文的 `String`

protected IEmail.Message generateEmailMessage (String description, 
                Throwable cause)

根据已收集的属性（主题、发件人、收件人）以及说明和原因（可选）生成新的电子邮件邮件

参数
`description`	`String`：严重失败的摘要
`cause`	`Throwable`：（可选）包含堆栈轨迹信息的 Throwable

返回
`IEmail.Message`	填充了所有电子邮件属性的消息对象

protected String generateEmailSubject ()

用于生成电子邮件报告主题的方法。主题的格式为：“ on ”

返回
`String`	一个 `String`，其中包含要用于电子邮件报告的主题

protected long getCurrentTimeMillis ()

获取当前时间（以毫秒为单位）。

返回
`long`

protected String getLocalHostName ()

获取机器的本地主机名。

返回
`String`	主机的名称，如果未知则为“未知主机”