CollectingTestListener

public class CollectingTestListener
extends Object implements ITestInvocationListener, ILogSaverListener

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

الفئات الفرعية المباشرة المعروفة JsonHttpTestResultReporter ، MetricsXMLResultReporter ، ModuleListener ، ReportPassedTests ، ResultAggregator ، ShardListener ، SuiteResultReporter ، XmlResultReporter JsonHttpTestResultReporter مراسل النتائج الذي يقوم بترميز نتائج مقاييس الاختبار والفرع ، ومعلومات الجهاز في JSON و POST في نقطة نهاية خدمة HTTP MetricsXMLResultReporter يكتب MetricsXMLResultReporter مقاييس الاختبار وتشغيل المقاييس إلى ملف XML في مجلد محدد بواسطة معلمة مجلد المقاييس في مرحلة الاستدعاء المنتهية من الاختبار. وحدة الاستماع تعلق المستمع إلى كل IRemoteTest كل وحدة من أجل جمع قائمة النتائج. ReportPassedTests قم بالإبلاغ في ملف عن عوامل التصفية الممكنة لاستبعاد الاختبار الذي تم اجتيازه. النتيجة المجمّع معيد توجيه خاص يقوم بتجميع النتائج عند الحاجة ، استنادًا إلى استراتيجية إعادة المحاولة التي تم اتخاذها. مستمع شارد A ITestInvocationListener التي تقوم بجمع النتائج من قشرة الاحتجاج (ويعرف أيضا باسم انقسام الاحتجاج لتشغيل على موارد متعددة في نفس الوقت)، وتحيلها إلى المستمع آخر. SuiteResultReporter جمع نتائج الاختبار لاستدعاء مجموعة كاملة وإخراج النتائج النهائية. XmlResultReporter يكتب نتائج JUnit إلى ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter الخاص بـ Ant.

الفئات الفرعية غير المباشرة المعروفة FormattedGeneratorReporter ، XmlFormattedGeneratorReporter FormattedGeneratorReporter المراسل الذي يسمح بإنشاء التقارير بتنسيق معين. XmlFormattedGeneratorReporter تنفيذ FormattedGeneratorReporter الذي تنسيق النتائج جناح في شكل أكس أم أل.

---

A ITestInvocationListener من شأنها أن جمع كل نتائج الاختبار.

على الرغم من أن هياكل البيانات المستخدمة في هذا الكائن هي ذات ألوان، و ITestInvocationListener يجب استدعاء الاستدعاء في الترتيب الصحيح.

ملخص

المنشئون العامة
CollectingTestListener ()

الأساليب العامة
IBuildInfo	getBuildInfo () تم إهمال هذه الطريقة. الاعتماد على IBuildInfo من getInvocationContext() .
TestRunResult	getCurrentRunResults () الحصول على نتائج التشغيل الاختباري الحالي.
int	getExpectedTests () إرجاع عدد الاختبارات المتوقعة.
IInvocationContext	getInvocationContext () العودة سياق الاحتجاج التي تم الإبلاغ عنها عن طريق invocationStarted(com.android.tradefed.invoker.IInvocationContext)
	getMergedTestRunResults () قم بإرجاع مجموعة النتائج المدمجة لجميع عمليات التشغيل عبر المحاولات المختلفة.
IInvocationContext	getModuleContextForRunResult (String testRunName) إرجاع IInvocationContext وحدة المرتبطة النتائج.
MultiMap<String, LogFile>	getModuleLogFiles () إرجاع نسخة من الخريطة تحتوي على كل الملفات المسجلة المرتبطة بالوحدة النمطية
MultiMap<String, LogFile>	getNonAssociatedLogFiles () تُرجع نسخة من الخريطة التي تحتوي على كل الملفات المسجلة غير المرتبطة بتشغيل اختباري أو وحدة نمطية.
int	getNumAllFailedTestRuns () تُرجع العدد الإجمالي لعمليات التشغيل الاختبارية في حالة الفشل
int	getNumAllFailedTests () إرجاع العدد الإجمالي للاختبارات في حالة فشل (فشلت فقط ، فشل الافتراضات لا تحسب في ذلك).
int	getNumTestsInState (TestResult.TestStatus status) تُرجع عدد الاختبارات في حالة معينة لهذا التشغيل.
int	getNumTotalTests () تُرجع العدد الإجمالي للاختبارات الكاملة لجميع عمليات التشغيل.
IBuildInfo	getPrimaryBuildInfo () إعادة بناء المعلومات الأولية التي تم الإبلاغ عنها عن طريق invocationStarted(com.android.tradefed.invoker.IInvocationContext) .
	getRunResults () تم إهمال هذه الطريقة. استخدام getMergedTestRunResults()
TestRunResult	getTestRunAtAttempt (String testRunName, int attempt) إعادة TestRunResult لمحاولة واحدة.
int	getTestRunAttemptCount (String testRunName) تُرجع عدد المحاولات لاسم تشغيل اختباري محدد.
	getTestRunAttempts (String testRunName) يحصل كل المحاولات ل TestRunResult من اختبار تشغيل معين.
	getTestRunForAttempts (int attempt) يحصل على جميع النتائج لمحاولة معينة.
	getTestRunNames () أعد جميع الأسماء لجميع عمليات الاختبار.
boolean	hasFailedTests () تُرجع إذا كان الاستدعاء به أي اختبارات فاشلة أو فاشلة.
boolean	hasTestRunResultsForName (String testRunName) تُرجع ما إذا كان لاسم التشغيل الاختباري المحدد أي نتائج.
void	invocationEnded (long elapsedTime)
void	invocationFailed (Throwable cause)
void	invocationStarted (IInvocationContext context)
void	logAssociation (String dataName, LogFile logFile)
void	setBuildInfo (IBuildInfo buildInfo) تم إهمال هذه الطريقة. ليست ضرورية للاختبار بعد الآن.
void	setMergeStrategy (MergeStrategy strategy) يحدد MergeStrategy لاستخدامها عند دمج النتائج.
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)
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 name, int numTests, int attemptNumber)
void	testRunStarted (String name, int numTests)
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime)
void	testRunStopped (long elapsedTime)
void	testStarted (TestDescription test, long startTime)
void	testStarted (TestDescription test)

الطرق المحمية
final void	clearModuleLogFiles () يسمح بتنظيف ملف الوحدة حتى نتجنب حملها لفترة طويلة.
final void	clearResultsForName (String testRunName) يسمح لمسح النتائج لاسم تشغيل معين.
void	setIsAggregrateMetrics (boolean aggregate) بدّل خيار "المقاييس الإجمالية"

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

CollectingTestListener

public CollectingTestListener ()

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

getBuildInfo

public IBuildInfo getBuildInfo ()

تم إهمال هذه الطريقة.
الاعتماد على IBuildInfo من getInvocationContext() .

إرجاع معلومات البناء.

عائدات
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

الحصول على نتائج التشغيل الاختباري الحالي.

لاحظ أن النتائج قد لا تكون كاملة. فمن المستحسن لاختبار قيمة TestRunResult.isRunComplete() و / أو (link TestRunResult # isRunFailure ()} حسب الاقتضاء قبل معالجة النتائج.

عائدات
TestRunResult	و TestRunResult تمثيل البيانات التي تم جمعها خلال الاختبار الأخير المدى

getExpectedTests

public int getExpectedTests ()

إرجاع عدد الاختبارات المتوقعة. يمكن أن تختلف من getNumTotalTests() وإذا كان بعض الاختبارات لم يتم تشغيل.

عائدات
int

getInvocationContext

public IInvocationContext getInvocationContext ()

العودة سياق الاحتجاج التي تم الإبلاغ عنها عن طريق invocationStarted(com.android.tradefed.invoker.IInvocationContext)

عائدات
IInvocationContext

getMergedTestRunResults

public  getMergedTestRunResults ()

قم بإرجاع مجموعة النتائج المدمجة لجميع عمليات التشغيل عبر المحاولات المختلفة.

في حالة وجود عدة نتائج ، يتم دمج كل تشغيل اختباري ، مع الكتابة فوق نتائج الاختبار الأخيرة للتشغيلات السابقة. يتم ترتيب عمليات التشغيل التجريبية حسب رقم المحاولة.

سيتم دمج المقاييس لنفس المحاولة استنادا إلى مجموعة من تفضيل aggregate-metrics . ستكون المقاييس النهائية هي مقاييس المحاولة الأخيرة.

عائدات

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

إرجاع IInvocationContext وحدة المرتبطة النتائج.

العوامل
testRunName	String : اسم قدمها { testRunStarted(String, int) .

عائدات
IInvocationContext	و IInvocationContext وحدة لإعطاء اختبار اسم المدى null إذا لم تكن هناك نتائج لهذا الاسم.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

إرجاع نسخة من الخريطة تحتوي على كل الملفات المسجلة المرتبطة بالوحدة النمطية

عائدات
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

تُرجع نسخة من الخريطة التي تحتوي على كل الملفات المسجلة غير المرتبطة بتشغيل اختباري أو وحدة نمطية.

عائدات
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

تُرجع العدد الإجمالي لعمليات التشغيل الاختبارية في حالة الفشل

عائدات
int

getNumAllFailedTests

public int getNumAllFailedTests ()

إرجاع العدد الإجمالي للاختبارات في حالة فشل (فشلت فقط ، فشل الافتراضات لا تحسب في ذلك).

عائدات
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus status)

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

العوامل
status	TestResult.TestStatus

عائدات
int

getNumTotalTests

public int getNumTotalTests ()

تُرجع العدد الإجمالي للاختبارات الكاملة لجميع عمليات التشغيل.

عائدات
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

إعادة بناء المعلومات الأولية التي تم الإبلاغ عنها عن طريق invocationStarted(com.android.tradefed.invoker.IInvocationContext) . البناء الأساسي هو البناء الذي يعيده موفر البناء الأول للتكوين الجاري تشغيله. إرجاع القيمة فارغة إذا لم يكن هناك سياق (لا يوجد بناء لاختبار الحالة).

عائدات
IBuildInfo

getRunResults

public  getRunResults ()

تم إهمال هذه الطريقة.
استخدام getMergedTestRunResults()

تُرجع نتائج كافة عمليات التشغيل الاختبارية.

عائدات

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

إعادة TestRunResult لمحاولة واحدة.

العوامل
testRunName	String : اسم قدمها { testRunStarted(String, int) .
attempt	int : معرف المحاولة.

عائدات
TestRunResult	و TestRunResult لاسم ومحاولة إعطاء هوية أو null إذا كان غير موجود.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

تُرجع عدد المحاولات لاسم تشغيل اختباري محدد.

العوامل
testRunName	String : اسم قدمها { testRunStarted(String, int) .

عائدات
int

getTestRunAttempts

public  getTestRunAttempts (String testRunName)

يحصل كل المحاولات ل TestRunResult من اختبار تشغيل معين.

العوامل
testRunName	String : اسم قدمها { testRunStarted(String, int) .

عائدات
	كل TestRunResult لاختبار معين، بأمر من المحاولات.

getTestRunForAttempts

public  getTestRunForAttempts (int attempt)

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

العوامل
attempt	int : محاولة نريد نتائج.

عائدات
	كل TestRunResult عن محاولة معين.

getTestRunNames

public  getTestRunNames ()

أعد جميع الأسماء لجميع عمليات الاختبار.

قد يتم تشغيل هذه الاختبارات التجريبية عدة مرات مع محاولات مختلفة.

عائدات

hasFailedTests

public boolean hasFailedTests ()

تُرجع إذا كان الاستدعاء به أي اختبارات فاشلة أو فاشلة.

عائدات
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

تُرجع ما إذا كان لاسم التشغيل الاختباري المحدد أي نتائج أم لا.

العوامل
testRunName	String : اسم قدمها { testRunStarted(String, int) .

عائدات
boolean

انتهى الدعاء

public void invocationEnded (long elapsedTime)

العوامل
elapsedTime	long

الدعاء فشل

public void invocationFailed (Throwable cause)

العوامل
cause	Throwable

بدأ الاحتجاج

public void invocationStarted (IInvocationContext context)

العوامل
context	IInvocationContext

جمعية السجل

public void logAssociation (String dataName, 
                LogFile logFile)

العوامل
dataName	String
logFile	LogFile

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

تم إهمال هذه الطريقة.
ليست ضرورية للاختبار بعد الآن.

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

العوامل
buildInfo	IBuildInfo

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

يحدد MergeStrategy لاستخدامها عند دمج النتائج.

العوامل
strategy	MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

العوامل
test	TestDescription
trace	String

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

العوامل
test	TestDescription
failure	FailureDescription

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

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

العوامل
test	TestDescription
endTime	long
testMetrics

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

public void testEnded (TestDescription test, 
                 testMetrics)

العوامل
test	TestDescription
testMetrics

فشل الاختبار

public void testFailed (TestDescription test, 
                FailureDescription failure)

العوامل
test	TestDescription
failure	FailureDescription

فشل الاختبار

public void testFailed (TestDescription test, 
                String trace)

العوامل
test	TestDescription
trace	String

test تم تجاهله

public void testIgnored (TestDescription test)

العوامل
test	TestDescription

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

public void testModuleEnded ()

testModule بدأ

public void testModuleStarted (IInvocationContext moduleContext)

العوامل
moduleContext	IInvocationContext

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

public void testRunEnded (long elapsedTime, 
                 runMetrics)

العوامل
elapsedTime	long
runMetrics

testRunFailed

public void testRunFailed (FailureDescription failure)

العوامل
failure	FailureDescription

testRunFailed

public void testRunFailed (String errorMessage)

العوامل
errorMessage	String

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber)

العوامل
name	String
numTests	int
attemptNumber	int

testRunStarted

public void testRunStarted (String name, 
                int numTests)

العوامل
name	String
numTests	int

testRunStarted

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

العوامل
name	String
numTests	int
attemptNumber	int
startTime	long

testRunStopped

public void testRunStopped (long elapsedTime)

العوامل
elapsedTime	long

اختبار

public void testStarted (TestDescription test, 
                long startTime)

العوامل
test	TestDescription
startTime	long

اختبار

public void testStarted (TestDescription test)

العوامل
test	TestDescription

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

clearModuleLogFiles

protected final void clearModuleLogFiles ()

يسمح بتنظيف ملف الوحدة حتى نتجنب حملها لفترة طويلة.

clearResultsForName

protected final void clearResultsForName (String testRunName)

يسمح لمسح النتائج لاسم تشغيل معين. يجب استخدامه فقط في بعض الحالات مثل مُجمّع النتائج.

العوامل
testRunName	String

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

بدّل خيار "المقاييس الإجمالية"

العوامل
aggregate	boolean