النتيجة المجمّع

public class ResultAggregator
extends CollectingTestListener

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.retry.ResultAggregator

---

معيد توجيه خاص يقوم بتجميع النتائج عند الحاجة ، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها.

ملخص

المنشئون العامة
ResultAggregator ( listeners, RetryStrategy strategy) ResultAggregator ( listeners, RetryStrategy strategy)

الطرق العامة
void	cleanEventsFiles ()
final void	forwardAggregatedInvocationLogs () قم بإعادة توجيه كافة سجلات مستوى الاستدعاء إلى محرري النتائج الذين لا يدعمون النتائج التفصيلية.
void	invocationEnded (long elapsedTime) التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.
void	invocationFailed ( FailureDescription failure)
void	invocationFailed (Throwable cause) يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.
void	invocationStarted ( IInvocationContext context) يُبلغ عن بدء استدعاء الاختبار.
void	logAssociation (String dataName, LogFile logFile) في بعض الحالات ، يجب أن يكون السجل مرتبطًا بقوة بحالات الاختبار ، ولكن الفرصة للقيام بذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) غير ممكن.
void	setLogSaver ( ILogSaver logSaver)
void	setUpdatedReporting (boolean updatedReporting) يعين التقارير الجديدة.
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	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	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
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 name, int testCount, int attemptNumber, long startTime) يعلن عن بدء تشغيل اختباري.
void	testStarted ( TestDescription test, long startTime) بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدد أيضًا وقت بدء الاختبار ، جنبًا إلى جنب مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لقياس دقيق .

الطرق المحمية
File[]	getEventsLogs ()

المنشئون العامة

النتيجة المجمّع

public ResultAggregator ( listeners, 
                RetryStrategy strategy)

المعلمات
listeners
strategy	RetryStrategy

الطرق العامة

CleanEventsFiles

public void cleanEventsFiles ()

forwardAggregatedInvocationLogs

public final void forwardAggregatedInvocationLogs ()

قم بإعادة توجيه كافة سجلات مستوى الاستدعاء إلى محرري النتائج الذين لا يدعمون النتائج التفصيلية.

انتهى الدعاء

public void invocationEnded (long elapsedTime)

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

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

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

الدعاء فشل

public void invocationFailed (FailureDescription failure)

المعلمات
failure	FailureDescription

الدعاء فشل

public void invocationFailed (Throwable cause)

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

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

المعلمات
cause	Throwable : Throwable الفشل

بدأ الاحتجاج

public void invocationStarted (IInvocationContext context)

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

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

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

جمعية السجل

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات ، يجب أن يكون السجل مرتبطًا بقوة بحالات الاختبار ، ولكن الفرصة للقيام بذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) غير ممكن. وبالتالي ، فإن رد الاتصال هذا يسمح بتوفير ارتباط قوي بشكل صريح.

المعلمات
dataName	String : اسم البيانات
logFile	ملف LogFile : ملف LogFile الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

المعلمات
logSaver	ILogSaver

setUpdatedReporting

public void setUpdatedReporting (boolean updatedReporting)

يعين التقارير الجديدة.

المعلمات
updatedReporting	boolean

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 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)

المعلمات
dataName	String
dataType	LogDataType
dataStream	InputStreamSource

testLog تم الحفظ

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

المعلمات
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

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

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 : String تصف سبب فشل التشغيل.

testRunStarted

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

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

المعلمات
name	String : اسم التشغيل التجريبي
testCount	int : إجمالي عدد الاختبارات في التشغيل التجريبي
attemptNumber	int : رقم الطلب ، وتحديد المحاولات المختلفة لنفس runName التي يتم تشغيلها عدة مرات. tryNumber هو 0 مفهرس ويجب أن يزداد في كل مرة يحدث فيها تشغيل جديد. على سبيل المثال ، تمت إعادة محاولة الاختبار المحبب 3 مرات ، ويجب أن يكون له 4 عمليات تشغيل إجمالية تحت نفس اسم التشغيل ويكون رقم المحاولة من 0 إلى 3.
startTime	long : الوقت الذي بدأ فيه التشغيل ، ويتم قياسه عبر System.currentTimeMillis()

اختبار

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()

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

getEventsLogs

protected File[] getEventsLogs ()

عائدات
File[]