تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

InvocationToJUnitResultForwarder

public class InvocationToJUnitResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.InvocationToJUnitResultForwarder

الفئات الفرعية المباشرة المعروفة

TextResultReporter

TextResultReporter مراسل نتائج الاختبار الذي يعيد توجيه النتائج إلى طابعة نتائج النص JUnit.

فئة تستمع إلى أحداث 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, testMetrics)` `testEnded ( TestDescription test, testMetrics)` يُبلغ عن نهاية تنفيذ حالة اختبار فردية.
`void`	`testFailed ( TestDescription testId, String trace)` يبلغ عن فشل حالة الاختبار الفردية.
`void`	`testIgnored ( TestDescription test)` يتم استدعاؤه في حالة عدم إجراء اختبار ، بشكل عام بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.
`void`	`testLog (String dataName, LogDataType logData, 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)` يُبلغ عن بداية حالة اختبار فردية.

الطرق المحمية
`TestListener`	`getJUnitListener ()`

المنشأت العامة

InvocationToJUnitResultForwarder

public InvocationToJUnitResultForwarder (TestListener junitListener)

حدود
`junitListener`	`TestListener`

الأساليب العامة

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 testId, 
                String trace)

يُستدعى عندما يشير اختبار ذري إلى أنه يفترض وجود شرط خاطئ

حدود
`testId`	`TestDescription` : يحدد الاختبار
`trace`	`String` : كومة تتبع الفشل

انتهى الاختبار

public void testEnded (TestDescription test, 
                 testMetrics)

يُبلغ عن نهاية تنفيذ حالة اختبار فردية.

إذا لم يتم استدعاء testFailed(TestDescription, FailureDescription) ، فإن هذا الاختبار نجح. يُرجع أيضًا أي مقاييس مفتاح / قيمة قد تكون انبعثت أثناء تنفيذ حالة الاختبار.

حدود
`test`	`TestDescription` : يحدد الاختبار
`testMetrics`	: `ERROR(/Map)` المقاييس المنبعثة

فشل الاختبار

public void testFailed (TestDescription testId, 
                String trace)

يبلغ عن فشل حالة الاختبار الفردية.

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

حدود
`testId`	`TestDescription` : يحدد الاختبار
`trace`	`String` : كومة تتبع الفشل

test تم تجاهله

public void testIgnored (TestDescription test)

يتم استدعاؤه في حالة عدم إجراء اختبار ، بشكل عام بسبب إضافة تعليق توضيحي على طريقة الاختبار باستخدام org.junit. تجاهل.

حدود
`test`	`TestDescription` : يحدد الاختبار

testLog

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

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

يجب استدعاء قبل ERROR(/ITestInvocationListener#invocationFailed(Throwable)) أو ERROR(/ITestInvocationListener#invocationEnded(long))

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

حدود
`dataName`	`String` : `String` اسم وصفي للبيانات. على سبيل المثال "device_logcat". ملاحظة قد لا يكون اسم dataName فريدًا لكل طلب. على سبيل المثال ، يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات
`logData`	`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` : يحدد الاختبار

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

getJUnitListener

protected TestListener getJUnitListener ()

عائدات
`TestListener`