ModuleListener
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)
في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في |
void
|
setAttemptIsolation(CurrentInvocation.IsolationGrade isolation)
لتحديد ما إذا كان يجب الإبلاغ عن المحاولة على أنّها معزولة أم لا. |
void
|
setCollectTestsOnly(boolean collectTestsOnly)
لتحديد ما إذا كان سيتم جمع الاختبارات فقط أم لا. |
void
|
setMarkTestsSkipped(boolean skip)
ما إذا كان سيتم وضع علامة على جميع حالات الاختبار التي تم تخطّيها أم لا |
void
|
setTestMappingSources(
تضبط مصادر ربط الاختبار التي سيتم إدراجها في المقاييس. |
void
|
testAssumptionFailure(TestDescription test, String trace)
يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح. |
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح. |
void
|
testEnded(TestDescription test, long endTime,
بديل |
void
|
testEnded(TestDescription test,
يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي. |
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
|
testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
|
void
|
testRunEnded(long elapsedTime,
الإبلاغ عن نهاية عملية الاختبار |
void
|
testRunFailed(FailureDescription failure)
تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه |
void
|
testRunFailed(String errorMessage)
تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح. |
void
|
testRunStarted(String name, int numTests, int attemptNumber)
الإبلاغ عن بدء عملية تنفيذ اختبار |
void
|
testRunStarted(String name, int numTests, int attemptNumber, long startTime)
الإبلاغ عن بدء عملية تنفيذ اختبار |
void
|
testSkipped(TestDescription test, SkipReason reason)
يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. |
void
|
testStarted(TestDescription test, long startTime)
بديل عن |
وظائف الإنشاء العامة
ModuleListener
public ModuleListener (ITestInvocationListener listener, IInvocationContext moduleContext)
طريقة الإنشاء
المعلمات | |
---|---|
listener |
ITestInvocationListener |
moduleContext |
IInvocationContext |
الطرق العامة
hasLastAttemptFailed
public boolean hasLastAttemptFailed ()
تعرِض هذه السمة ما إذا تعذّر إكمال جلسة إعادة المحاولة الأخيرة للمستمع أم لا.
المرتجعات | |
---|---|
boolean |
logAssociation
public void logAssociation (String dataName, LogFile logFile)
في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)
callback المباشر. وبالتالي، يسمح هذا المرجع العكسي بتوفير ارتباط قوي
بشكل صريح.
المعلمات | |
---|---|
dataName |
String : اسم البيانات |
logFile |
LogFile : LogFile الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار
|
setAttemptIsolation
public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)
لتحديد ما إذا كان يجب الإبلاغ عن المحاولة على أنّها معزولة أم لا.
المعلمات | |
---|---|
isolation |
CurrentInvocation.IsolationGrade |
setCollectTestsOnly
public void setCollectTestsOnly (boolean collectTestsOnly)
لتحديد ما إذا كان سيتم جمع الاختبارات فقط أم لا.
المعلمات | |
---|---|
collectTestsOnly |
boolean |
setMarkTestsSkipped
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 لوصف الخطأ وسياقه |
testEnded
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) من المقاييس التي تمّ قياسها |
testEnded
public void testEnded (TestDescription test,testMetrics)
يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.
إذا لم يتمّ استدعاء testFailed(TestDescription, FailureDescription)
، يعني ذلك أنّ هذا الاختبار قد اجتاز. ويعرض أيضًا أي مقاييس مفتاح/قيمة
قد تم إصدارها أثناء تنفيذ نموذج الاختبار.
المعلمات | |
---|---|
test |
TestDescription : لتحديد الاختبار |
testMetrics |
: ERROR(/Map) من المقاييس التي تمّ قياسها |
testFailed
public void testFailed (TestDescription test, FailureDescription failure)
الإبلاغ عن تعذُّر اختبار فردي
سيتمّ استدعاؤه بين testStarted وtestEnded.
المعلمات | |
---|---|
test |
TestDescription : لتحديد الاختبار |
failure |
FailureDescription : FailureDescription لوصف الخطأ وسياقه |
testFailed
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)
المعلمات | |
---|---|
dataName |
String |
dataType |
LogDataType |
dataStream |
InputStreamSource |
testLogSaved
public void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
المعلمات | |
---|---|
dataName |
String |
dataType |
LogDataType |
dataStream |
InputStreamSource |
logFile |
LogFile |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
الإبلاغ عن نهاية عملية الاختبار
المعلمات | |
---|---|
elapsedTime |
long : الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية |
runMetrics |
: أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار |
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 numTests, int attemptNumber)
الإبلاغ عن بدء عملية تنفيذ اختبار
المعلمات | |
---|---|
name |
String : اسم اختبار التنفيذ |
numTests |
int : إجمالي عدد الاختبارات في اختبار التنفيذ |
attemptNumber |
int : رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل
الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة تتم فيها عملية
تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عدد
عمليات التشغيل 4 عمليات ضمن اسم التشغيل نفسه وأن تتراوح مَعلمة attemptNumber بين 0 و3. |
testRunStarted
public void testRunStarted (String name, int numTests, int attemptNumber, long startTime)
الإبلاغ عن بدء عملية تنفيذ اختبار
المعلمات | |
---|---|
name |
String : اسم اختبار التنفيذ |
numTests |
int : إجمالي عدد الاختبارات في اختبار التنفيذ |
attemptNumber |
int : رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل
الذي تم تنفيذه عدّة مرات. يتمّ ترقيم مَعلمة attemptNumber بدءًا من 0، ويجب أن تزيد كلّ مرّة يتمّ فيها تنفيذ عملية
تشغيل جديدة. على سبيل المثال، إذا تمّت إعادة محاولة إجراء اختبار دقيق 3 مرّات، يجب أن يكون إجمالي عمليات التشغيل
التي تمّ إجراؤها 4 مرّات ضمن اسم التشغيل نفسه، ويجب أن تتراوح مَعلمة attemptNumber بين 0 و3. |
startTime |
long : وقت بدء التنفيذ، يتم قياسه من خلال System.currentTimeMillis() |
testSkipped
public void testSkipped (TestDescription test, SkipReason reason)
يتمّ استدعاؤه عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. سيتمّ إعادة إجراء هذه الاختبارات لمحاولة الحصول على تنفيذ سليم.
المعلمات | |
---|---|
test |
TestDescription : لتحديد الاختبار |
reason |
SkipReason : SkipReason |
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() |