InvocationToJUnitResultForwarder

public class InvocationToJUnitResultForwarder
extends Object implements ITestInvocationListener

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

فئة تستمع إلى أحداث ITestInvocationListener وتعيد توجيهها إلى TestListener.

ملخّص

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

InvocationToJUnitResultForwarder(TestListener junitListener)

الطرق العامة

TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

void invocationFailed(Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

void invocationStarted(IInvocationContext context)

الإبلاغ عن بدء استدعاء الاختبار

void testAssumptionFailure(TestDescription testId, String trace)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

void testEnded(TestDescription test, testMetrics)

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

void testFailed(TestDescription testId, String trace)

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

void testIgnored(TestDescription test)

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

void testLog(String dataName, LogDataType logData, InputStreamSource dataStream)

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

void testRunEnded(long elapsedTime, runMetrics)

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

void testRunFailed(String errorMessage)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.

void testRunStarted(String runName, int testCount)

تبلّغ عن بدء إجراء اختبار.

void testRunStopped(long elapsedTime)

توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.

void testStarted(TestDescription test)

الإبلاغ عن بدء حالة اختبار فردية

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

TestListener getJUnitListener()

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

استدعاء ToJUnitResultResulter

public InvocationToJUnitResultForwarder (TestListener junitListener)

المعلمات
junitListener TestListener

الطرق العامة

getSummary

public TestSummary getSummary ()

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

المرتجعات
TestSummary TestSummary تلخيص عملية التنفيذ أو قيمة فارغة

invocationEnded

public void invocationEnded (long elapsedTime)

تشير هذه العلامة إلى البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
cause Throwable: السبب Throwable للتعذُّر

invocationStarted

public void invocationStarted (IInvocationContext context)

الإبلاغ عن بدء استدعاء الاختبار

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

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

تعذُّر اختبار الافتراض

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.

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

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

testFailed

public void testFailed (TestDescription testId, 
                String trace)

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

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

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

testIgnored

public void testIgnored (TestDescription test)

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

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

testLog

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

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

يجب الاتصال به قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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: currently unused, consider removing

المعلمات
elapsedTime ‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية

testStarted

public void testStarted (TestDescription test)

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

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

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

getJUnitListener

protected TestListener getJUnitListener ()

المرتجعات
TestListener