وحدة الاستماع

public class ModuleListener
extends CollectingTestListener

java.lang.Object
↳ com.android.tradefed.result.CollectingTestListener
↳ com.android.tradefed.testtype.suite.ModuleListener

يتم إرفاق المستمع بكل IRemoteTest لكل وحدة من أجل تجميع قائمة النتائج.

ملخص

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

ModuleListener ( ITestInvocationListener listener, IInvocationContext moduleContext)

البناء.

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

boolean hasLastAttemptFailed ()

إرجاع ما إذا كانت جلسة إعادة المحاولة الأخيرة للمستمع قد فشلت أم لا.

void logAssociation (String dataName, LogFile logFile)

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

void setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation)

يحدد ما إذا كان يجب الإبلاغ عن المحاولة على أنها منعزلة أم لا.

void setCollectTestsOnly (boolean collectTestsOnly)

يحدد ما إذا كنا نجمع الاختبارات فقط أم لا.

void setMarkTestsSkipped (boolean skip)

ما إذا كان سيتم وضع علامة على جميع حالات الاختبار التي تم تخطيها أم لا.

void setTestMappingSources ( testMappingSources) setTestMappingSources ( testMappingSources)

يعيّن مصادر تعيين الاختبار التي سيتم إدراجها في المقاييس.

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 testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

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

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

void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String errorMessage)

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

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

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

void testRunStarted (String name, int numTests, 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)) لقياس دقيق .

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

وحدة الاستماع

public ModuleListener (ITestInvocationListener listener, 
                IInvocationContext moduleContext)

البناء.

حدود
listener ITestInvocationListener

moduleContext IInvocationContext

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

hasLastAttemptFailed

public boolean hasLastAttemptFailed ()

إرجاع ما إذا كانت جلسة إعادة المحاولة الأخيرة للمستمع قد فشلت أم لا.

عائدات
boolean

جمعية السجل

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 الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار.

تعيين المحاولة

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

يحدد ما إذا كان يجب الإبلاغ عن المحاولة على أنها منعزلة أم لا.

حدود
isolation CurrentInvocation.IsolationGrade

setCollectTestsOnly

public void setCollectTestsOnly (boolean collectTestsOnly)

يحدد ما إذا كنا نجمع الاختبارات فقط أم لا.

حدود
collectTestsOnly boolean

تم تخطي setMarkTests

public void setMarkTestsSkipped (boolean skip)

ما إذا كان سيتم وضع علامة على جميع حالات الاختبار التي تم تخطيها أم لا.

حدود
skip boolean

setTestMappingSources

public void setTestMappingSources ( testMappingSources)

يعيّن مصادر تعيين الاختبار التي سيتم إدراجها في المقاييس.

حدود
testMappingSources

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)

حدود
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 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 name, 
                int numTests, 
                int attemptNumber)

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

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

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

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

testRunStarted

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

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

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

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

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

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