النتيجة

public class ResultForwarder
extends Object implements ITestInvocationListener

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

الفئات الفرعية المباشرة المعروفة FilteredResultForwarder ، JarHostTest.HostTestListener ، LogSaverResultForwarder ، LogcatCrashResultForwarder ، PythonBinaryHostTest . FilteredResultForwarder متغير ResultForwarder الذي يسمح فقط بالإبلاغ عن قائمة المسموح بها من TestDescription . JarHostTest.HostTestListener مستمع الغلاف الذي يعيد توجيه جميع الأحداث باستثناء testRunStarted () و testRunEnded () إلى المستمع المضمن. LogSaverResultForwarder A ResultForwarder لحفظ السجلات مع ملف التوقف العام. LogcatCrashResultForwarder مستمع خاص: عند الإخفاقات (تعطل عملية الأجهزة) ، سيحاول استخراج العطل من logcat وإضافته إلى رسالة الفشل المرتبطة بالاختبار. PythonBinaryHostTest.PythonForwarder يؤدي معيد التوجيه إلى استبدال اسم التشغيل بالاسم الثنائي. ResultAndLogForwarder معيد التوجيه للنتائج وسجلات الأحداث. RetryResultForwarder امتداد ResultForwarder الذي يدفع دائمًا إلى رقم محاولة معين. ShardMainResultForwarder A ResultForwarder الذي يجمع نتائج استدعاءات اختبار مجزأة. TestTimeoutEnforcer المستمعون الذين يسمحون بالتحقق من وقت تنفيذ حالة اختبار معينة وفشلها إذا تجاوزت مهلة معينة.

الفئات الفرعية غير المباشرة المعروفة GranularRetriableTestWrapper.StartEndCollector ، RetryLogSaverResultForwarder محبب قابل للاسترداد مساعد الفصل للقبض على البداية والنهاية المفقودة. RetryLogSaverResultForwarder معيد التوجيه الذي يتعامل أيضًا مع اجتياز المحاولة الحالية التي نحن عليها.

---

برنامج 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	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. تجاهل.
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	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) اضبط المستمعين بعد البناء.

المنشأت العامة

النتيجة

public ResultForwarder ( listeners)

إنشاء ResultForwarder .

حدود
listeners	: ITestInvocationListener الحقيقي لإرسال النتائج إليه

النتيجة

public ResultForwarder (ITestInvocationListener... listeners)

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

حدود
listeners	ITestInvocationListener : هو ITestInvocationListener الحقيقي لإرسال النتائج إليه

المنشئون المحميون

النتيجة

protected ResultForwarder ()

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

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

getSummary

public TestSummary getSummary ()

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

عائدات
TestSummary	A 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 : سبب ERROR(/Throwable) للفشل

بدأ الاحتجاج

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 : الوقت الذي انتهى فيه الاختبار ، تم قياسه عبر ERROR(/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 : كومة تتبع الفشل

test تم تجاهله

public void testIgnored (TestDescription test)

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

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

testLog

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

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

يجب استدعاء قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

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

حدود
dataName	String : ERROR(/String) اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم البيانات فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات
dataType	LogDataType : LogDataType للبيانات
dataStream	InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog.

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

public void testModuleEnded ()

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

testModule بدأ

public void testModuleStarted (IInvocationContext moduleContext)

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

حدود
moduleContext	IInvocationContext : IInvocationContext للوحدة النمطية.

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

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

يعلن عن بدء تشغيل اختباري.

حدود
runName	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي
attemptNumber	int : رقم الطلب ، يحدد المحاولات المختلفة لنفس runName التي يتم تشغيلها عدة مرات. tryNumber هو 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 : رقم الطلب ، يحدد المحاولات المختلفة لنفس runName التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.
startTime	long : الوقت الذي بدأ فيه التشغيل ، تم قياسه عبر ERROR(/System#currentTimeMillis())

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

اختبار

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 : الوقت الذي بدأ فيه الاختبار ، تم قياسه عبر ERROR(/System#currentTimeMillis())

اختبار

public void testStarted (TestDescription test)

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

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

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

getListeners

protected  getListeners ()

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

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

مجموعة مستمعين

protected void setListeners (ITestInvocationListener... listeners)

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

حدود
listeners	ITestInvocationListener : هو ITestInvocationListener الحقيقي لإرسال النتائج إليه

مجموعة مستمعين

protected void setListeners ( listeners)

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

حدود
listeners	: ITestInvocationListener الحقيقي لإرسال النتائج إليه