NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.NameMangleListener

---

مستمع وكيل لترجمة طريقة الاختبار والفئة وأسماء الحزم عند الإبلاغ عن النتائج.

ملخص

المنشئون العامة
NameMangleListener ( ITestInvocationListener listener)

الأساليب العامة
TestSummary	getSummary () يسمح لـ InvocationListener بإرجاع ملخص.
void	invocationEnded (long elapsedTime) التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.
void	invocationFailed (Throwable cause) يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.
void	invocationStarted ( IInvocationContext context) يُبلغ عن بدء استدعاء الاختبار.
void	testAssumptionFailure ( TestDescription test, String trace) يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) يُبلغ عن نهاية تنفيذ حالة اختبار فردية.
void	testFailed ( TestDescription test, String trace) يبلغ عن فشل حالة اختبار فردية.
void	testIgnored ( TestDescription test) يتم استدعاؤها عندما لا يتم تشغيل الاختبار ، وذلك عمومًا بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) يوفر السجل المرتبط أو بيانات التصحيح من استدعاء الاختبار.
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) يبلغ عن نهاية التشغيل التجريبي.
void	testRunFailed (String errorMessage) تقارير فشل التشغيل الاختباري بسبب خطأ فادح.
void	testRunStarted (String runName, int testCount) يعلن عن بدء تشغيل اختباري.
void	testRunStopped (long elapsedTime) تم إيقاف تشغيل الاختبار التجريبي قبل الإكمال بناءً على طلب المستخدم.
void	testStarted ( TestDescription test) يُبلغ عن بداية حالة اختبار فردية.

الطرق المحمية
TestDescription	mangleTestId ( TestDescription test) يتم تشغيل هذه الطريقة على جميع TestDescription التي تم تمريرها إلى testStarted(com.android.tradefed.result.TestDescription) و testFailed(com.android.tradefed.result.TestDescription, String) و ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) رد النداء.
String	mangleTestRunName (String name) يتم تشغيل هذه الطريقة على جميع أسماء التشغيل الاختباري التي تم تمريرها إلى رد الاتصال testRunStarted(String, int) .

المنشئون العامة

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

المعلمات
listener	ITestInvocationListener

الأساليب العامة

getSummary

public TestSummary getSummary ()

يسمح لـ InvocationListener بإرجاع ملخص.

عائدات
TestSummary	A TestSummary يلخص المدى ، أو لا شيء

انتهى الدعاء

public void invocationEnded (long elapsedTime)

التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

المعلمات
elapsedTime	long : الوقت المنقضي للاستدعاء بالمللي ثانية

الدعاء فشل

public void invocationFailed (Throwable cause)

يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.

المعلمات
cause	Throwable : Throwable الفشل

بدأ الاحتجاج

public void invocationStarted (IInvocationContext context)

يُبلغ عن بدء استدعاء الاختبار.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم تقارير الأجهزة المتعددة.

المعلمات
context	IInvocationContext : معلومات حول الاستدعاء

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ

المعلمات
test	TestDescription : يحدد الاختبار
trace	String : كومة تتبع الفشل

انتهى الاختبار

public void testEnded (TestDescription test, 
                 testMetrics)

يُبلغ عن نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription) ، فإن هذا الاختبار نجح. يقوم أيضًا بإرجاع أي مقاييس مفتاح / قيمة قد تكون قد انبعثت أثناء تنفيذ حالة الاختبار.

المعلمات
test	TestDescription : يحدد الاختبار
testMetrics	: ERROR(/Map) المقاييس المنبعثة

فشل الاختبار

public void testFailed (TestDescription test, 
                String trace)

يبلغ عن فشل حالة اختبار فردية.

سيتم استدعاؤه بين testStarted و testEnded.

المعلمات
test	TestDescription : يحدد الاختبار
trace	String : كومة تتبع الفشل

test تم تجاهله

public void testIgnored (TestDescription test)

يتم استدعاؤها عندما لا يتم تشغيل الاختبار ، وذلك عمومًا بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.

المعلمات
test	TestDescription : يحدد الاختبار

testLog

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

يوفر السجل المرتبط أو بيانات التصحيح من استدعاء الاختبار.

يجب استدعاء قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سيقوم إطار عمل TradeFederation باستدعاء هذه الطريقة تلقائيًا ، مع توفير سجل المضيف وإذا أمكن ، تسجيل الجهاز.

المعلمات
dataName	String : String اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم البيانات فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات
dataType	LogDataType : LogDataType للبيانات
dataStream	InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog.

انتهى الاختبار

public void testRunEnded (long elapsedTime, 
                 runMetrics)

يبلغ عن نهاية التشغيل التجريبي. FIXME: لا يمكن أن يكون لدينا واجهتان لخريطة <> بنوع مختلف ، لذلك علينا استخدام HashMap هنا.

المعلمات
elapsedTime	long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية
runMetrics	: تم الإبلاغ عن أزواج المفتاح والقيمة في نهاية تشغيل اختباري باستخدام Metric .

testRunFailed

public void testRunFailed (String errorMessage)

تقارير فشل التشغيل الاختباري بسبب خطأ فادح.

المعلمات
errorMessage	String : String تصف سبب فشل التشغيل.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

يعلن عن بدء تشغيل اختباري.

المعلمات
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي

testRunStopped

public void testRunStopped (long elapsedTime)

تم إيقاف تشغيل الاختبار التجريبي قبل الإكمال بناءً على طلب المستخدم.

TODO: غير مستخدم حاليًا ، جرب الإزالة

المعلمات
elapsedTime	long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية

اختبار

public void testStarted (TestDescription test)

يُبلغ عن بداية حالة اختبار فردية. الواجهة الأقدم ، يجب أن تستخدم testStarted(com.android.tradefed.result.TestDescription) كلما أمكن ذلك.

المعلمات
test	TestDescription : يحدد الاختبار

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

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

يتم تشغيل هذه الطريقة على جميع TestDescription التي تم تمريرها إلى testStarted(com.android.tradefed.result.TestDescription) و testFailed(com.android.tradefed.result.TestDescription, String) و ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) رد النداء. يجب أن تقوم الطريقة بإرجاع TestDescription ربما يكون مختلفًا والذي سيتم تمريره إلى ITestInvocationListener المتلقين للمعلومات والذي تم تحديده أثناء الإنشاء.

يجب أن يكون التنفيذ حريصًا على عدم تعديل TestDescription الأصلي.

يمرر التطبيق الافتراضي المعرف الوارد عبر غير معدل.

المعلمات
test	TestDescription

عائدات
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

يتم تشغيل هذه الطريقة على جميع أسماء التشغيل الاختباري التي تم تمريرها إلى رد الاتصال testRunStarted(String, int) . يجب أن تُرجع الطريقة اسم تشغيل اختباري ربما يكون مختلفًا والذي سيتم تمريره إلى ITestInvocationListener المتلقين للمعلومات والذي تم تحديده أثناء الإنشاء.

يجب أن يكون التطبيق حريصًا على عدم تعديل اسم التشغيل الأصلي.

يمرر التطبيق الافتراضي اسم التشغيل التجريبي الوارد عبر اسم غير معدل.

المعلمات
name	String

عائدات
String