ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
com.android.tradefed.result.ResultForwarder


ITestInvocationListener الذي يعيد توجيه نتائج الاستدعاء إلى قائمة المستمعين الآخرين.

ملخص

المقاولين العامة

ResultForwarder ( listeners) ResultForwarder ( listeners)

إنشاء ResultForwarder .

ResultForwarder ( ITestInvocationListener... listeners)

مُنشئ وسيطة متغيرة بديلة لـ ResultForwarder .

بناة المحمية

ResultForwarder ()

قم بإنشاء ResultForwarder مع إعداد المستمع المؤجل.

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

TestSummary getSummary ()

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

void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

يُبلغ عن استدعاء تم تخطيه

void invocationStarted ( IInvocationContext context)

تقارير بداية استدعاء الاختبار.

void testAssumptionFailure ( TestDescription test, String trace)

يتم استدعاؤها عندما يشير الاختبار الذري إلى أنها تفترض حالة خاطئة

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

يتم استدعاؤها عندما يشير الاختبار الذري إلى أنها تفترض حالة خاطئة

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

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

void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

void testFailed ( TestDescription test, FailureDescription failure)

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

void testFailed ( TestDescription test, String trace)

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

void testIgnored ( TestDescription test)

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

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

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

void testModuleEnded ()

تقارير نهاية تشغيل الوحدة النمطية.

void testModuleStarted ( IInvocationContext moduleContext)

يُبلغ عن بداية تشغيل الوحدة النمطية.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

تقارير نهاية التشغيل التجريبي.

void testRunFailed ( FailureDescription failure)

فشل تشغيل اختبار التقارير في الاكتمال بسبب الفشل الموصوف بواسطة FailureDescription .

void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount, int attemptNumber)

يُعلن عن بداية التشغيل التجريبي.

void testRunStarted (String runName, int testCount)

يُعلن عن بداية التشغيل التجريبي.

void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

يُعلن عن بداية التشغيل التجريبي.

void testRunStopped (long elapsedTime)

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

void testSkipped ( TestDescription test, SkipReason reason)

يتم استدعاؤه عند تخطي الاختبار وعدم تنفيذه لسبب غير متوقع عادةً.

void testStarted ( TestDescription test, long startTime)

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

void testStarted ( TestDescription test)

تقارير بداية حالة اختبار فردية.

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

getListeners ()

الحصول على قائمة المستمعين.

void setListeners ( ITestInvocationListener... listeners)

ضبط المستمعين بعد البناء.

void setListeners ( listeners) setListeners ( listeners)

ضبط المستمعين بعد البناء.

المقاولين العامة

ResultForwarder

public ResultForwarder ( listeners)

إنشاء ResultForwarder .

حدود
listeners : برنامج ITestInvocationListener الحقيقي لإعادة توجيه النتائج إليه

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

منشئ وسيطة متغيرة بديلة لـ ResultForwarder .

حدود
listeners ITestInvocationListener : برنامج ITestInvocationListener الحقيقي لإعادة توجيه النتائج إليه

بناة المحمية

ResultForwarder

protected ResultForwarder ()

قم بإنشاء ResultForwarder مع إعداد المستمع المؤجل. مخصص فقط للاستخدام من قبل الفئات الفرعية.

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

getSummary

public TestSummary getSummary ()

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

عائدات
TestSummary TestSummary يلخص التشغيل، أو فارغ

انتهت الدعوة

public void invocationEnded (long elapsedTime)

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

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

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

فشل الاستدعاء

public void invocationFailed (FailureDescription failure)

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

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

حدود
failure FailureDescription : FailureDescription الذي يصف سبب الفشل

فشل الاستدعاء

public void invocationFailed (Throwable cause)

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

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

حدود
cause Throwable : السبب Throwable للفشل

invocationSkipped

public void invocationSkipped (SkipReason reason)

يُبلغ عن استدعاء تم تخطيه

حدود
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

تقارير بداية استدعاء الاختبار.

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

يتم استدعاؤها عندما يشير الاختبار الذري إلى أنها تفترض حالة خاطئة

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

trace String : تتبع مكدس الفشل

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يتم استدعاؤها عندما يشير الاختبار الذري إلى أنها تفترض حالة خاطئة

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

failure FailureDescription : FailureDescription الذي يصف الفشل وسياقه.

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

public 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) للمقاييس المنبعثة

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

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testMetrics : ERROR(/Map) للمقاييس المنبعثة

فشل الاختبار

public void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

failure FailureDescription : FailureDescription الذي يصف الفشل وسياقه.

فشل الاختبار

public void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String : تتبع مكدس الفشل

testIgnored

public void testIgnored (TestDescription test)

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

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

testLog

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

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

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

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

حدود
dataName String : اسم وصفي String البيانات. على سبيل المثال "device_logcat". لاحظ أن dataName قد لا يكون فريدًا لكل استدعاء. أي يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات

dataType LogDataType : LogDataType للبيانات

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

testModuleEnded

public void testModuleEnded ()

تقارير نهاية تشغيل الوحدة النمطية.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

يُبلغ عن بداية تشغيل الوحدة النمطية. يرتبط رد الاتصال هذا بـ testModuleEnded() وهو اختياري في التسلسل. يتم استخدامه فقط أثناء التشغيل الذي يستخدم الوحدات النمطية: العدائين المعتمدين على المجموعة.

حدود
moduleContext IInvocationContext : IInvocationContext للوحدة.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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

فشل تشغيل الاختبار

public void testRunFailed (FailureDescription failure)

فشل تشغيل اختبار التقارير في الاكتمال بسبب الفشل الموصوف بواسطة FailureDescription .

حدود
failure FailureDescription : FailureDescription الذي يصف الفشل وسياقه.

فشل تشغيل الاختبار

public void testRunFailed (String errorMessage)

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

حدود
errorMessage String : String تصف سبب فشل التشغيل.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

يُعلن عن بداية التشغيل التجريبي.

حدود
runName String : اسم التشغيل التجريبي

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

attemptNumber int : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

يُعلن عن بداية التشغيل التجريبي.

حدود
runName String : اسم التشغيل التجريبي

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

يُعلن عن بداية التشغيل التجريبي.

حدود
runName String : اسم التشغيل التجريبي

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

attemptNumber int : رقم الطلب، لتحديد المحاولات المختلفة لنفس اسم التشغيل والتي يتم تشغيلها عدة مرات. رقم المحاولة مفهرس بـ 0 ويجب أن يتزايد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال، تتم إعادة محاولة الاختبار 3 مرات، ويجب أن يحتوي على 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.

startTime long : الوقت الذي بدأ فيه التشغيل، ويتم قياسه عبر System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

reason SkipReason : SkipReason

testStarted

public 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 void testStarted (TestDescription test)

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

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

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

getListeners

protected  getListeners ()

الحصول على قائمة المستمعين. مخصص فقط للاستخدام من قبل الفئات الفرعية.

عائدات
قائمة ITestInvocationListener s.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

ضبط المستمعين بعد البناء. مخصص فقط للاستخدام من قبل الفئات الفرعية.

حدود
listeners ITestInvocationListener : برنامج ITestInvocationListener الحقيقي لإعادة توجيه النتائج إليه

setListeners

protected void setListeners ( listeners)

ضبط المستمعين بعد البناء. مخصص فقط للاستخدام من قبل الفئات الفرعية.

حدود
listeners : برنامج ITestInvocationListener الحقيقي لإعادة توجيه النتائج إليه