ResultForwarder
public class ResultForwarder
extends Object
implements ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.ResultForwarder |
ITestInvocationListener
الذي يعيد توجيه نتائج الاستدعاء إلى قائمة المستمعين الآخرين.
ملخص
المقاولين العامة | |
---|---|
ResultForwarder ( listeners) ResultForwarder ( listeners) إنشاء | |
ResultForwarder ( ITestInvocationListener... listeners) مُنشئ وسيطة متغيرة بديلة لـ |
بناة المحمية | |
---|---|
ResultForwarder () قم بإنشاء |
الأساليب العامة | |
---|---|
TestSummary | getSummary () يسمح لـ InvocationListener بإرجاع ملخص. |
void | invocationEnded (long elapsedTime) تقارير تفيد بأن الاستدعاء قد تم إنهاؤه، سواء بنجاح أو بسبب خطأ ما. |
void | invocationFailed ( FailureDescription failure) يُبلغ عن استدعاء غير مكتمل بسبب بعض حالات الخطأ. |
void | invocationFailed (Throwable cause) يُبلغ عن استدعاء غير مكتمل بسبب بعض حالات الخطأ. |
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) بديل لـ |
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) فشل تشغيل اختبار التقارير في الاكتمال بسبب الفشل الموصوف بواسطة |
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 | testStarted ( TestDescription test, long startTime) بديل لـ |
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 للفشل |
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 : أبلغ الجهاز عن الوقت المنقضي، بالمللي ثانية |
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
protectedgetListeners ()
الحصول على قائمة المستمعين. مخصص فقط للاستخدام من قبل الفئات الفرعية.
عائدات | |
---|---|
قائمة ITestInvocationListener s. |
setListeners
protected void setListeners (ITestInvocationListener... listeners)
ضبط المستمعين بعد البناء. مخصص فقط للاستخدام من قبل الفئات الفرعية.
حدود | |
---|---|
listeners | ITestInvocationListener : برنامج ITestInvocationListener الحقيقي لإعادة توجيه النتائج إليه |
setListeners
protected void setListeners (listeners)
ضبط المستمعين بعد البناء. مخصص فقط للاستخدام من قبل الفئات الفرعية.
حدود | |
---|---|
listeners | ITestInvocationListener الحقيقي لإعادة توجيه النتائج إليه |