InvocationToJUnitResultForwarder
public
class
InvocationToJUnitResultForwarder
extends Object
implements
ITestInvocationListener
| java.lang.Object | |
| ↳ | com.android.tradefed.result.InvocationToJUnitResultForwarder |
فئة تستمع إلى أحداث ITestInvocationListener وتعيد توجيهها إلى TestListener.
ملخّص
طُرق وضع التصميم العامة | |
|---|---|
InvocationToJUnitResultForwarder(TestListener junitListener)
|
|
الإجراءات العامة | |
|---|---|
TestSummary
|
getSummary()
تسمح هذه السمة لـ InvocationListener بعرض ملخّص. |
void
|
invocationEnded(long elapsedTime)
تعرض هذه السمة ما إذا تم إنهاء عملية الاستدعاء بنجاح أو بسبب حدوث خطأ. |
void
|
invocationFailed(Throwable cause)
تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ. |
void
|
invocationStarted(IInvocationContext context)
تسجّل هذه السمة بداية تنفيذ الاختبار. |
void
|
testAssumptionFailure(TestDescription testId, String trace)
يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح |
void
|
testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية. |
void
|
testFailed(TestDescription testId, String trace)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية. |
void
|
testIgnored(TestDescription test)
يتم استدعاؤه عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار تمّت إضافة التعليق التوضيحي org.junit.Ignore إليها. |
void
|
testLog(String dataName, LogDataType logData, InputStreamSource dataStream)
تعرض هذه السمة بيانات السجلّ أو تصحيح الأخطاء المرتبطة بعملية استدعاء الاختبار. |
void
|
testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)
تقارير نهاية عملية الاختبار |
void
|
testRunFailed(String errorMessage)
تعذّر إكمال تشغيل اختبار التقارير بسبب حدوث خطأ فادح. |
void
|
testRunStarted(String runName, int testCount)
تسجّل هذه السمة بداية تشغيل تجريبي. |
void
|
testRunStopped(long elapsedTime)
تم إيقاف التشغيل التجريبي للتقارير قبل اكتماله بناءً على طلب المستخدم. |
void
|
testStarted(TestDescription test)
تسجّل هذه السمة بداية حالة اختبار فردية. |
طُرق محمية | |
|---|---|
TestListener
|
getJUnitListener()
|
طُرق وضع التصميم العامة
InvocationToJUnitResultForwarder
public InvocationToJUnitResultForwarder (TestListener junitListener)
| المعلَمات | |
|---|---|
junitListener |
TestListener |
الإجراءات العامة
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 |
invocationStarted
public void invocationStarted (IInvocationContext context)
تسجّل هذه السمة بداية تنفيذ الاختبار.
سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation. على مقدّمي التقارير إلغاء هذه الطريقة لتفعيل إعداد التقارير على أجهزة متعددة.
| المعلَمات | |
|---|---|
context |
IInvocationContext: معلومات حول طلب التنفيذ |
testAssumptionFailure
public void testAssumptionFailure (TestDescription testId, String trace)
يتم استدعاؤه عندما يشير اختبار ذري إلى أنّه يفترض شرطًا غير صحيح
| المعلَمات | |
|---|---|
testId |
TestDescription: تحدّد الاختبار |
trace |
String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ |
testEnded
public void testEnded (TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)
تسجّل هذه السمة نهاية تنفيذ حالة اختبار فردية.
إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription)، اجتازت هذه الحالة الاختبار. تعرض هذه السمة أيضًا أي مقاييس على شكل مفتاح/قيمة
ربما تم إصدارها أثناء تنفيذ حالة الاختبار.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
testMetrics |
HashMap: Map للمقاييس التي تمّ إرسالها |
testFailed
public void testFailed (TestDescription testId, String trace)
تعرض هذه السمة تعذُّر تنفيذ حالة اختبار فردية.
سيتم استدعاؤها بين testStarted وtestEnded.
| المعلَمات | |
|---|---|
testId |
TestDescription: تحدّد الاختبار |
trace |
String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ |
testIgnored
public void testIgnored (TestDescription test)
يتم استدعاؤه عندما لا يتم تنفيذ اختبار، وعادةً ما يكون ذلك لأنّ طريقة الاختبار تمّت إضافة التعليق التوضيحي org.junit.Ignore إليها.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
testLog
public void testLog (String dataName,
LogDataType logData,
InputStreamSource dataStream)تعرض هذه السمة بيانات السجلّ أو تصحيح الأخطاء المرتبطة بعملية استدعاء الاختبار.
يجب الاتصال قبل ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))
سيستدعي إطار عمل TradeFederation هذه الطريقة تلقائيًا، مع توفير سجلّ المضيف، وسجلّ logcat للجهاز إذا كان ذلك منطبقًا.
| المعلَمات | |
|---|---|
dataName |
String: اسم وصفي String للبيانات، مثل "device_logcat". ملاحظة
قد لا يكون dataName فريدًا لكل استدعاء، أي يجب أن يتمكّن المنفّذون من التعامل مع
عمليات استدعاء متعددة باستخدام dataName نفسه. |
logData |
LogDataType: LogDataType الخاص بالبيانات |
dataStream |
InputStreamSource: InputStreamSource الخاص بالبيانات على المنفّذين استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند الانتهاء. على المتصلين التأكّد من أنّ مصدر البيانات يظل متاحًا ويمكن الوصول إليه إلى أن تكتمل طريقة testLog. |
testRunEnded
public void testRunEnded (long elapsedTime,
HashMap<String, MetricMeasurement.Metric> runMetrics)تقارير نهاية عملية الاختبار FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية |
runMetrics |
HashMap: أزواج المفتاح/القيمة التي يتمّ تسجيلها في نهاية عملية الاختبار باستخدام 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: currently unused, consider removing
| المعلَمات | |
|---|---|
elapsedTime |
long: الوقت المنقضي الذي أبلغ عنه الجهاز، بالمللي ثانية |
testStarted
public void testStarted (TestDescription test)
تسجّل هذه السمة بداية حالة اختبار فردية. واجهة قديمة، يجب استخدام testStarted(TestDescription) كلما أمكن ذلك.
| المعلَمات | |
|---|---|
test |
TestDescription: تحدّد الاختبار |
طُرق محمية
getJUnitListener
protected TestListener getJUnitListener ()
| المرتجعات | |
|---|---|
TestListener |
|