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, long endTime, Map<String, String> testMetrics) بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
final void	testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics) بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً.
final void	testEnded(TestDescription test, Map<String, String> testMetrics) تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
final void	testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics) تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
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, HashMap<String, MetricMeasurement.Metric> runMetrics) تقارير نهاية عملية الاختبار
void	testSkipped(TestDescription test, SkipReason reason) يتم استدعاء هذه الطريقة عندما يتم تخطّي اختبار ولم يتم تنفيذه لسبب غير متوقّع عادةً.
final void	testStarted(TestDescription test, long startTime) بديل testStarted(TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى testEnded(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, 
                long endTime, 
                Map<String, String> testMetrics)

بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بينها وبين testStarted(TestDescription,long) للحصول على قياس دقيق.

المعلَمات
test	‫TestDescription: تحدّد الاختبار
endTime	‫long: الوقت الذي انتهى فيه الاختبار، ويتم قياسه باستخدام System.currentTimeMillis()
testMetrics	Map: Map للمقاييس التي تمّ إرسالها

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

بديل testEnded(TestDescription,Map) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بينها وبين testStarted(TestDescription,long) للحصول على قياس دقيق.

المعلَمات
test	‫TestDescription: تحدّد الاختبار
endTime	‫long: الوقت الذي انتهى فيه الاختبار، ويتم قياسه باستخدام System.currentTimeMillis()
testMetrics	HashMap: Map للمقاييس التي تمّ إرسالها

testEnded

public final void testEnded (TestDescription test, 
                Map<String, String> testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

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

المعلَمات
test	‫TestDescription: تحدّد الاختبار
testMetrics	Map: Map للمقاييس التي تمّ إرسالها

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

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

المعلَمات
test	‫TestDescription: تحدّد الاختبار
testMetrics	HashMap: 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, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

تقارير نهاية عملية الاختبار FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

المعلَمات
test	‫TestDescription: تحدّد الاختبار
reason	SkipReason: SkipReason

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

بديل testStarted(TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار، بالإضافة إلى testEnded(TestDescription,long,Map) للحصول على قياس دقيق.

المعلَمات
test	‫TestDescription: تحدّد الاختبار
startTime	‫long: الوقت الذي بدأت فيه التجربة، ويتم قياسه باستخدام System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

تسجّل هذه السمة بداية حالة اختبار فردية. واجهة قديمة، يجب استخدام testStarted(TestDescription) كلما أمكن ذلك.

المعلَمات
test	‫TestDescription: تحدّد الاختبار