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

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

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

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

المعلمات
listener ITestInvocationListener

الطرق العامة

getSummary

public TestSummary getSummary ()

يسمح لـ InvocationListener بإرجاع ملخّص.

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

invocationEnded

public void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationFailed

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

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

public void testIgnored (TestDescription test)

يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.

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

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

يتم توفير السجلّ المرتبط أو بيانات تصحيح الأخطاء من استدعاء الاختبار.

يجب الاتصال قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

سيستدعي إطار عمل TradeFederation هذه الطريقة تلقائيًا، ما يؤدي إلى توفير سجلّ المضيف وlogcat للجهاز، إن أمكن.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

الإبلاغ عن نهاية عملية الاختبار

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

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: currently unused, consider removing

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

testStarted

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