NameMangleListener
public abstract class NameMangleListener
extends Object
implements ITestInvocationListener
java.lang.Object | |
↳ | com.android.tradefed.result.NameMangleListener |
مستمع وكيل لترجمة طريقة الاختبار والفئة وأسماء الحزم عند الإبلاغ عن النتائج.
ملخص
المنشأت العامة | |
---|---|
NameMangleListener ( ITestInvocationListener listener) |
الأساليب العامة | |
---|---|
TestSummary | getSummary () يسمح لـ InvocationListener بإرجاع ملخص. |
void | invocationEnded (long elapsedTime) التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما. |
void | invocationFailed (Throwable cause) يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما. |
void | invocationStarted ( IInvocationContext context) يُبلغ عن بدء استدعاء الاختبار. |
void | testAssumptionFailure ( TestDescription test, String trace) يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) يُبلغ عن نهاية تنفيذ حالة اختبار فردية. |
void | testFailed ( TestDescription test, String trace) يبلغ عن فشل حالة الاختبار الفردية. |
void | testIgnored ( TestDescription test) يتم استدعاؤه في حالة عدم إجراء اختبار ، بشكل عام بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) يوفر السجل المرتبط أو بيانات التصحيح من استدعاء الاختبار. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) يبلغ عن نهاية التشغيل التجريبي. |
void | testRunFailed (String errorMessage) تقارير فشل التشغيل الاختباري بسبب خطأ فادح. |
void | testRunStarted (String runName, int testCount) يعلن عن بدء تشغيل اختباري. |
void | testRunStopped (long elapsedTime) تم إيقاف تشغيل اختبار التقارير قبل الإكمال بناءً على طلب المستخدم. |
void | testStarted ( TestDescription test) يُبلغ عن بداية حالة اختبار فردية. |
الطرق المحمية | |
---|---|
TestDescription | mangleTestId ( TestDescription test) يتم تشغيل هذه الطريقة على جميع وحدات |
String | mangleTestRunName (String name) يتم تشغيل هذه الطريقة على جميع أسماء التشغيل الاختباري التي تم تمريرها إلى رد الاتصال |
المنشأت العامة
NameMangleListener
public NameMangleListener (ITestInvocationListener listener)
حدود | |
---|---|
listener | ITestInvocationListener |
الأساليب العامة
getSummary
public TestSummary getSummary ()
يسمح لـ InvocationListener بإرجاع ملخص.
عائدات | |
---|---|
TestSummary | A TestSummary يلخص المدى ، أو لا شيء |
انتهى الدعاء
public void invocationEnded (long elapsedTime)
التقارير التي تفيد بانتهاء الاستدعاء ، سواء بنجاح أو بسبب حالة خطأ ما.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.
حدود | |
---|---|
elapsedTime | long : الوقت المنقضي للاستدعاء بالمللي ثانية |
الدعاء فشل
public void invocationFailed (Throwable cause)
يُبلغ عن استدعاء غير مكتمل بسبب حالة خطأ ما.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation.
حدود | |
---|---|
cause | Throwable : سبب Throwable |
بدأ الاحتجاج
public void invocationStarted (IInvocationContext context)
يُبلغ عن بدء استدعاء الاختبار.
سيتم استدعاؤه تلقائيًا بواسطة إطار عمل TradeFederation. يحتاج المراسلون إلى تجاوز هذه الطريقة لدعم تقارير الأجهزة المتعددة.
حدود | |
---|---|
context | IInvocationContext : معلومات حول الاستدعاء |
testAssumptionFailure
public void testAssumptionFailure (TestDescription test, String trace)
يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
trace | String : كومة تتبع الفشل |
انتهى الاختبار
public void testEnded (TestDescription test,testMetrics)
يُبلغ عن نهاية تنفيذ حالة اختبار فردية.
إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription)
، فإن هذا الاختبار نجح. يُرجع أيضًا أي مقاييس مفتاح / قيمة قد تكون انبعثت أثناء تنفيذ حالة الاختبار.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
testMetrics | ERROR(/Map) المقاييس المنبعثة |
فشل الاختبار
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 : String اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم dataName فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات |
dataType | LogDataType : LogDataType للبيانات |
dataStream | InputStreamSource : مصدر البيانات InputStreamSource . يجب على المنفذين استدعاء createInputStream لبدء قراءة البيانات ، والتأكد من إغلاق InputStream الناتج عند الانتهاء. يجب على المتصلين التأكد من أن مصدر البيانات يظل موجودًا ويمكن الوصول إليه حتى تكتمل طريقة testLog. |
انتهى الاختبار
public void testRunEnded (long elapsedTime,runMetrics)
يبلغ عن نهاية التشغيل التجريبي. FIXME: لا يمكن أن يكون لدينا واجهتان لخريطة <> بنوع مختلف ، لذلك علينا استخدام HashMap هنا.
حدود | |
---|---|
elapsedTime | long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية |
runMetrics | Metric . |
testRunFailed
public void testRunFailed (String errorMessage)
تقارير فشل التشغيل الاختباري بسبب خطأ فادح.
حدود | |
---|---|
errorMessage | String : String تصف سبب فشل التشغيل. |
testRunStarted
public void testRunStarted (String runName, int testCount)
يعلن عن بدء تشغيل اختباري.
حدود | |
---|---|
runName | String : اسم التشغيل التجريبي |
testCount | int : إجمالي عدد الاختبارات في التشغيل التجريبي |
testRunStopped
public void testRunStopped (long elapsedTime)
تم إيقاف تشغيل اختبار التقارير قبل الإكمال بناءً على طلب المستخدم.
TODO: غير مستخدم حاليًا ، جرب الإزالة
حدود | |
---|---|
elapsedTime | long : أبلغ الجهاز عن الوقت المنقضي بالمللي ثانية |
اختبار
public void testStarted (TestDescription test)
يُبلغ عن بداية حالة اختبار فردية. الواجهة الأقدم ، يجب أن تستخدم testStarted(com.android.tradefed.result.TestDescription)
كلما أمكن ذلك.
حدود | |
---|---|
test | TestDescription : يحدد الاختبار |
الطرق المحمية
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
يتم تشغيل هذه الطريقة على جميع وحدات TestDescription
التي تم تمريرها إلى testStarted(com.android.tradefed.result.TestDescription)
و testFailed(com.android.tradefed.result.TestDescription, String)
و ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
عمليات رد النداء. يجب أن تقوم الطريقة بإرجاع TestDescription
ربما يكون مختلفًا والذي سيتم تمريره إلى ITestInvocationListener
المتلقين للمعلومات والذي تم تحديده أثناء الإنشاء.
يجب أن يكون التنفيذ حريصًا على عدم تعديل TestDescription
الأصلي.
يمرر التطبيق الافتراضي المعرف الوارد عبر غير معدل.
حدود | |
---|---|
test | TestDescription |
عائدات | |
---|---|
TestDescription |
mangleTestRunName
protected String mangleTestRunName (String name)
يتم تشغيل هذه الطريقة على جميع أسماء التشغيل الاختباري التي تم تمريرها إلى رد الاتصال testRunStarted(String, int)
. يجب أن تُرجع الطريقة اسم تشغيل اختباري ربما يكون مختلفًا والذي سيتم تمريره إلى ITestInvocationListener
المتلقين للمعلومات والذي تم تحديده أثناء الإنشاء.
يجب أن يكون التطبيق حريصًا على عدم تعديل اسم التشغيل الأصلي.
يمرر التطبيق الافتراضي اسم التشغيل التجريبي الوارد عبر اسم غير معدل.
حدود | |
---|---|
name | String |
عائدات | |
---|---|
String |