TestResultListener

public abstract class TestResultListener
extends Object implements ITestLifeCycleReceiver

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

الفئات الفرعية المباشرة المعروفة ConsoleResultReporter وCountingTestResultListener وPassingTestFileReporter ConsoleResultReporter أداة إعداد التقارير لطباعة نتائج الاختبار في وحدة التحكّم  CountingTestResultListener TestResultListener تتتبّع إجمالي عدد الاختبارات حسب TestStatus  PassingTestFileReporter ITestInvocationListener لحفظ قائمة حالات الاختبار التي اجتازت الاختبار في ملف اختبار

---

تبسيط واجهة برمجة التطبيقات ITestLifecycleListener للمنفِّذِين الذين لا يهتمون إلا بنتائج الاختبار الفردية

وهي تصفّل أحداث دورة الحياة المختلفة إلى طريقة testResult.

وهي ليست آمنة لتعدد المواضيع، وعلى وجه الخصوص، تفترض أنّه يتم تلقّي أحداث ITestLifecycleListener بالترتيب.

ملخّص

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

الطرق العامة
final void	testAssumptionFailure(TestDescription test, String trace) يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.
final void	testEnded(TestDescription test, testMetrics) يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.
final void	testEnded(TestDescription test, long endTime, testMetrics) بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
final void	testFailed(TestDescription test, String trace) الإبلاغ عن تعذُّر اختبار فردي
final void	testIgnored(TestDescription test) يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.
abstract void	testResult(TestDescription test, TestResult result)
void	testRunEnded(long elapsedTimeMillis, runMetrics) الإبلاغ عن نهاية عملية الاختبار
void	testSkipped(TestDescription test, SkipReason reason) يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً.
final void	testStarted(TestDescription test, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.
final void	testStarted(TestDescription test) الإبلاغ عن بدء حالة اختبار فردية

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

TestResultListener

public TestResultListener ()

الطرق العامة

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.

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

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

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بين testStarted(com.android.tradefed.result.TestDescription, long) لقياس الأداء بدقة.

المعلمات
test	TestDescription: لتحديد الاختبار
endTime	‫long: وقت انتهاء الاختبار، يتم قياسه من خلال System.currentTimeMillis()
testMetrics	: ERROR(/Map) من المقاييس التي تمّ قياسها

testFailed

public final void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر اختبار فردي

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

المعلمات
test	TestDescription: لتحديد الاختبار
trace	String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public final void testIgnored (TestDescription test)

يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.

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

testResult

public abstract void testResult (TestDescription test, 
                TestResult result)

المعلمات
test	TestDescription
result	TestResult

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

الإبلاغ عن نهاية عملية الاختبار

المعلمات
elapsedTimeMillis	‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية
runMetrics	: أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. سيتمّ إعادة إجراء هذه الاختبارات لمحاولة الحصول على تنفيذ سليم.

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

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.

المعلمات
test	TestDescription: لتحديد الاختبار
startTime	long: وقت بدء الاختبار، يتم قياسه من خلال System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

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

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