XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.XmlTestRunListener

يكتب نتائج JUnit في ملفات XML بتنسيق متوافق مع XMLJUnitResultFormatter في Ant.

ينشئ ملف XML منفصلاً لكل عملية اختبار.

ملخّص

طُرق وضع التصميم العامة

XmlTestRunListener()

الإجراءات العامة

void addSystemError(String systemError)

إضافة رسالة خطأ في النظام

TestRunResult getRunResult()

تعرض هذه الدالة TestRunResult.

String getSystemError()

تعرض هذه السمة رسالة خطأ النظام التي سيتمّ إدراجها في ملف XML في العنصر "system-err".

void setHostName(String hostName)
void setReportDir(File file)

تضبط هذه السمة ملف التقرير الذي سيتم استخدامه.

void testAssumptionFailure(TestIdentifier test, String trace)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

void testEnded(TestIdentifier test, Map<String, String> testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

void testFailed(TestIdentifier test, String trace)

تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

void testIgnored(TestIdentifier test)

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

void testRunEnded(long elapsedTime, Map<String, String> runMetrics)

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

void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int numTests)

تسجّل هذه السمة بداية تشغيل تجريبي.

void testRunStopped(long elapsedTime)

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

void testStarted(TestIdentifier test)

تسجّل هذه السمة بداية حالة اختبار فردية.

طُرق محمية

Map<String, String> getPropertiesAttributes()

احصل على سمات الخصائص كأزواج مفتاح/قيمة ليتم تضمينها في تقرير الاختبار.

File getResultFile(File reportDir)

تُنشئ File حيث سيتم إنشاء التقرير.

String getTestName(TestIdentifier testId)
String getTestSuiteName()

طُرق وضع التصميم العامة

XmlTestRunListener

public XmlTestRunListener ()

الإجراءات العامة

addSystemError

public void addSystemError (String systemError)

إضافة رسالة خطأ في النظام

المعلَمات
systemError String

getRunResult

public TestRunResult getRunResult ()

تعرض هذه الدالة TestRunResult.

المرتجعات
TestRunResult نتائج عملية الاختبار

getSystemError

public String getSystemError ()

تعرض هذه السمة رسالة خطأ النظام التي سيتمّ إدراجها في ملف XML في العنصر "system-err". لا يتم إنشاء العنصر إذا عرضت هذه السمة سلسلة فارغة.

المرتجعات
String

setHostName

public void setHostName (String hostName)

المعلَمات
hostName String

setReportDir

public void setReportDir (File file)

تضبط هذه السمة ملف التقرير الذي سيتم استخدامه.

المعلَمات
file File

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح

المعلَمات
test ‫TestIdentifier: تحدّد الاختبار
trace ‫String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testEnded

public void testEnded (TestIdentifier test, 
                Map<String, String> testMetrics)

تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء testFailed(TestIdentifier, String)، اجتازت هذه الحالة الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة ربما تم إصدارها أثناء تنفيذ حالة الاختبار.

المعلَمات
test ‫TestIdentifier: تحدّد الاختبار
testMetrics Map: Map من المقاييس التي يتم إرسالها أثناء تنفيذ حالة الاختبار بواسطة android.app.Instrumentation#sendStatus يتم الاحتفاظ بترتيب الإدراج ما لم يتم إصدار المفتاح نفسه عدة مرات. يُرجى العلم أنّه يتم استبعاد المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذه الخريطة. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية.

سيتم استدعاؤها بين testStarted وtestEnded.

المعلَمات
test ‫TestIdentifier: تحدّد الاختبار
trace ‫String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public void testIgnored (TestIdentifier test)

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

المعلَمات
test ‫TestIdentifier: تحدّد الاختبار

testRunEnded

public void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

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

المعلَمات
elapsedTime ‫long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية
runMetrics Map: Map من المقاييس التي يتم إرسالها أثناء تنفيذ حالة الاختبار بواسطة android.app.Instrumentation#addResults يتم الاحتفاظ بترتيب الإدراج ما لم يتم إصدار المفتاح نفسه عدة مرات. يُرجى العلم أنّه يتم استبعاد المفاتيح العادية المحدّدة في IInstrumentationResultParser.StatusKeys من هذه الخريطة. قد تضيف Ddmlib مقاييس اختبار إضافية محدّدة في IInstrumentationResultParser.StatusKeys.

testRunFailed

public void testRunFailed (String errorMessage)

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

المعلَمات
errorMessage String: String تصف سبب تعذُّر تنفيذ عملية التشغيل.

testRunStarted

public void testRunStarted (String runName, 
                int numTests)

تسجّل هذه السمة بداية تشغيل تجريبي.

المعلَمات
runName ‫String: اسم عملية التشغيل التجريبي
numTests ‫int: إجمالي عدد الاختبارات في عملية التشغيل التجريبي

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

testStarted

public void testStarted (TestIdentifier test)

تسجّل هذه السمة بداية حالة اختبار فردية.

المعلَمات
test ‫TestIdentifier: تحدّد الاختبار

طُرق محمية

getPropertiesAttributes

protected Map<String, String> getPropertiesAttributes ()

احصل على سمات الخصائص كأزواج مفتاح/قيمة ليتم تضمينها في تقرير الاختبار.

المرتجعات
Map<String, String>

getResultFile

protected File getResultFile (File reportDir)

تُنشئ File حيث سيتم إنشاء التقرير.

المعلَمات
reportDir File: الدليل الجذر للتقرير.
المرتجعات
File ملفّ واحد
عمليات الطرح
java.io.IOException
IOException

getTestName

protected String getTestName (TestIdentifier testId)

المعلَمات
testId TestIdentifier

المرتجعات
String

getTestSuiteName

protected String getTestSuiteName ()

المرتجعات
String