自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

TerribleFailureEmailHandler

public class TerribleFailureEmailHandler
extends Object implements ITerribleFailureHandler

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

簡單的處理常式類別，可在 Trade Federation 例項中發生 WTF (What a Terrible Failure) 錯誤時，向相關人員傳送電子郵件。

摘要

公用建構函式
`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`	主機名稱，如果不明則為「unknown host」