قائمة 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)

تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.

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)

نهاية تشغيل اختبار التقارير

void testRunFailed(String errorMessage)

تعذّر إكمال عملية اختبار التقارير بسبب خطأ فادح.

void testRunStarted(String runName, int testCount)

تبلّغ عن بدء إجراء اختبار.

void testRunStopped(long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بسبب طلب من المستخدم.

void testStarted(TestDescription test)

تعمل على الإبلاغ عن بداية حالة اختبار فردية.

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

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

String mangleTestRunName(String name)

يتم تشغيل هذه الطريقة على جميع أسماء اختبارات الاختبار التي يتم تمريرها إلى معاودة الاتصال "testRunStarted(String, int)"

شركة إنشاءات عامة

قائمة NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

المعلمات
listener ITestInvocationListener

الطرق العامة

الحصول على الملخص

public TestSummary getSummary ()

يسمح هذا الإذن لـ InvocationListener بعرض ملخص.

المرتجعات
TestSummary علامة TestSummary تلخّص تمرين الجري أو قيمة خالية

تم إنهاء الاستدعاء

public void invocationEnded (long elapsedTime)

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

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

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

تعذّر الاستدعاء

public void invocationFailed (Throwable cause)

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

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

المعلمات
cause Throwable: السبب Throwable للتعذُّر

تم بدء الاستدعاء

public void invocationStarted (IInvocationContext context)

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

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

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

تعذُّر اختبار الافتراض

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: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تم تجاهل الاختبار

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

سيستدعي إطار التجارة الفيدرالية هذه الطريقة تلقائيًا، مما يوفر سجل المضيف وأيضًا، Logcat.

المعلمات
dataName String: اسم String وصفي للبيانات. مثلاً: "device_logcat". ملاحظة قد لا يكون dataName فريدًا في كل استدعاء. أي أنّ القائمين على التنفيذ يجب أن يكونوا قادرين على التعامل مكالمات متعددة باستخدام dataName نفسها
dataType LogDataType: LogDataType للبيانات
dataStream InputStreamSource: InputStreamSource للبيانات. يجب على الجهات التنفيذية استدعاء createInputStream لبدء قراءة البيانات، والتأكد من إغلاق EnterStream عند الاكتمال. على المتصلين التأكّد من بقاء مصدر البيانات. موجودة ويمكن الوصول إليها حتى تكتمل طريقة testLog.

اختبار RunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام HashMap هنا.

المعلمات
elapsedTime long: الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية
runMetrics : يتم الإبلاغ عن أزواج المفتاح/القيمة في نهاية عملية اختبار باستخدام Metric.

اختبار التشغيل فاشل

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)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بسبب طلب من المستخدم.

قائمة المهام: غير مستخدمة حاليًا، يمكنك إزالتها

المعلمات
elapsedTime long: الوقت المنقضي الذي تم الإبلاغ عنه للجهاز، بالمللي ثانية

تم بدء الاختبار

public void testStarted (TestDescription test)

تعمل على الإبلاغ عن بداية حالة اختبار فردية. واجهة قديمة، ويجب استخدام testStarted(com.android.tradefed.result.TestDescription) كلما أمكن ذلك.

المعلمات
test TestDescription: يحدد الاختبار

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

معرّف mangleTest

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