TerribleFailureEmailHandler

public class TerribleFailureEmailHandler
extends Object implements ITerribleFailureHandler

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

---

فئة معالِج بسيطة تُرسِل رسالة إلكترونية إلى المستخدمين المهتمين عند حدوث خطأ WTF (What a Terrible Failure) ضمن مثيل Trade Federation.

ملخّص

وظائف الإنشاء العامة
TerribleFailureEmailHandler() إنشاء TerribleFailureEmailHandler

وظائف الإنشاء المحمية
TerribleFailureEmailHandler(IEmail mailer) أنشئ TerribleFailureEmailHandler باستخدام مثيل IEmail مخصّص لاستخدامه.

الطرق العامة
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() تحصل على اسم المضيف المحلي للجهاز.

وظائف الإنشاء العامة

TerribleFailureEmailHandler

public TerribleFailureEmailHandler ()

إنشاء TerribleFailureEmailHandler

وظائف الإنشاء المحمية

TerribleFailureEmailHandler

protected TerribleFailureEmailHandler (IEmail mailer)

أنشئ TerribleFailureEmailHandler باستخدام مثيل IEmail مخصّص لاستخدامه.

تمّ عرضها لاختبار الوحدة.

المعلمات
mailer	‫IEmail: مثيل IEmail المطلوب استخدامه.

الطرق العامة

addDestination

public void addDestination (String dest)

تُضيف عنوان وجهة بريد إلكتروني.

onTerribleFailure

public boolean onTerribleFailure (String description, 
                Throwable cause)

يتم تشغيله عند حدوث خطأ جسيم في LogUtil.CLog.wtf(String, Throwable)

المعلمات
description	String: ملخّص عن الخطأ الفادح الذي حدث
cause	Throwable: (اختياري) يحتوي على تتبع تسلسل استدعاء الدوال البرمجية للخطأ الخطير

المرتجعات
boolean	صحيح عند التعامل مع الطلب بنجاح، وخطأ في الحالات الأخرى

setMinEmailInterval

public void setMinEmailInterval (long interval)

تُستخدَم لضبط الحد الأدنى للفاصل الزمني بين الرسائل الإلكترونية.

setSender

public void setSender (String sender)

لضبط عنوان مُرسِل الرسالة الإلكترونية.

الطرق المحمية

generateEmailBody

protected String generateEmailBody (String message, 
                Throwable cause)

طريقة لإنشاء نص تقارير البريد الإلكتروني من WTF

المعلمات
message	String: ملخّص عن الخطأ الفادح
cause	Throwable: عنصر throwable يحتوي على معلومات تتبُّع تسلسل استدعاء الدوال البرمجية

المرتجعات
String	String يحتوي على النص المراد استخدامه في تقرير البريد الإلكتروني

generateEmailMessage

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

إنشاء رسالة إلكترونية جديدة استنادًا إلى السمات التي تم جمعها سابقًا (الموضوع والمُرسِل والوجهات) بالإضافة إلى الوصف والسبب (اختياري)

المعلمات
description	String: ملخّص عن الخطأ الخطير
cause	Throwable: (اختياري) Throwable الذي يتضمّن معلومات عن تتبع تسلسل استدعاء الدوال البرمجية

المرتجعات
IEmail.Message	عنصر الرسالة مع تعبئة جميع سمات البريد الإلكتروني

generateEmailSubject

protected String generateEmailSubject ()

طريقة لإنشاء موضوع الرسائل الإلكترونية للتقارير سيتم تنسيق الموضوع على النحو التالي: " في "

المرتجعات
String	String يحتوي على الموضوع المطلوب استخدامه لإعداد تقرير عبر البريد الإلكتروني

getCurrentTimeMillis

protected long getCurrentTimeMillis ()

تحصل على الوقت الحالي بالمللي ثانية.

المرتجعات
long

getLocalHostName

protected String getLocalHostName ()

تحصل على اسم المضيف المحلي للجهاز.

المرتجعات
String	اسم الجهاز المضيف، أو "مضيف غير معروف" إذا كان غير معروف