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

ShardMainResultforwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.Resultforwarder
	↳	com.android.tradefed.invoker.ShardMainResultforwarder

تمثّل هذه السمة ResultForwarder يجمع بين نتائج استدعاءات الاختبار المقسّمة. فقط تُبلغ المستمعين باكتمال الاستدعاء فور اكتمال جميع الاستدعاءات المجزأة.

هذا الصف غير آمن لسلسلة المحادثات. من المتوقّع أن يقفل العملاء في هذا الصف عندما إرسال نتائج الاختبار، لمنع استدعاء استدعاءات الاستدعاء بطريقة غير مرتبة.

ملخّص

شركة إنشاءات عامة
`ShardMainResultForwarder( listeners, int expectedShards)` إنشاء `ShardMainResultForwarder`

الطرق العامة
	`getListeners()` الحصول على قائمة المستمعين.
`void`	`invocationEnded(long elapsedTime)` البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما الشرط.
`void`	`invocationEnded(long elapsedTime, IInvocationContext context)` معاودة الاتصال أكثر تفصيلاً للتمييز بين الجزء الذي انتهى.
`void`	`invocationFailed(FailureDescription failure)` تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.
`void`	`invocationFailed(Throwable cause)` تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.
`void`	`invocationSkipped(SkipReason reason)` يتم الإبلاغ عن استدعاء على أنّه تم تخطّيه.
`void`	`invocationStarted(IInvocationContext context)` يبلِّغ عن بدء الاستدعاء للاختبار.
`void`	`logAssociation(String dataName, LogFile logFile)` في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` المباشر لا يمكن معاودة الاتصال.
`void`	`testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)` عليك إعادة توجيه testLog فقط بدلاً من حفظ السجلّ أولاً.
`void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` يتم استدعاء هذه الدالة عند حفظ سجلّ الاختبار.

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

ShardMainResultforwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

إنشاء ShardMainResultForwarder

المعلمات
`listeners`	: قائمة `ITestInvocationListener` لإعادة توجيه النتائج إلى وقت جميع النتائج الأجزاء مكتملة
`expectedShards`	`int`: عدد الأجزاء

الطرق العامة

مجموعة getListeners

public  getListeners ()

الحصول على قائمة المستمعين. مخصص للاستخدام من قِبل الفئات الفرعية فقط.

المرتجعات
	قائمة `ITestInvocationListener`.

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

public void invocationEnded (long elapsedTime)

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

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

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

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

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

معاودة الاتصال أكثر تفصيلاً للتمييز بين الجزء الذي انتهى.

المعلمات
`elapsedTime`	`long`
`context`	`IInvocationContext`

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

public void invocationFailed (FailureDescription failure)

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

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

المعلمات
`failure`	`FailureDescription`: `FailureDescription` الذي يصف سبب التعذُّر

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

public void invocationFailed (Throwable cause)

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

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

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

تم تخطّي الاستدعاء

public void invocationSkipped (SkipReason reason)

يتم الإبلاغ عن استدعاء على أنّه تم تخطّيه.

المعلمات
`reason`	`SkipReason`

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

public void invocationStarted (IInvocationContext context)

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

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

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

مؤسسة Log Association

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) المباشر لا يمكن معاودة الاتصال. وبالتالي، تسمح معاودة الاتصال هذه بتوفير ارتباط قوي بشكل صريح.

المعلمات
`dataName`	`String`: اسم البيانات
`logFile`	`LogFile`: `LogFile` الذي تم تسجيله سابقًا والذي يجب ربطه حالة الاختبار.

testLog forward (إعادة توجيه الاختبار)

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

عليك إعادة توجيه testLog فقط بدلاً من حفظ السجلّ أولاً.

المعلمات
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

تم حفظ سجلّ الاختبار

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

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

يجب استخدامه بدلاً من ITestInvocationListener#testLog(String, LogDataType, InputStreamSource).

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