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

ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.invoker.ShardMainResultForwarder

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

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

ملخص

المنشأت العامة
`ShardMainResultForwarder ( listeners, int expectedShards)` `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`	`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` s.

انتهى الدعاء

public void invocationEnded (long elapsedTime)

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

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

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

انتهى الدعاء

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

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

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

الدعاء فشل

public void invocationFailed (FailureDescription failure)

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

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

المعلمات
`failure`	`FailureDescription` : وصف `FailureDescription` في وصف سبب الفشل

الدعاء فشل

public void invocationFailed (Throwable cause)

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

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

المعلمات
`cause`	`Throwable` : `Throwable` الفشل

بدأ الاحتجاج

public void invocationStarted (IInvocationContext context)

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

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

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

جمعية السجل

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` الذي تم تسجيله من قبل ويجب أن يكون مرتبطًا بحالة الاختبار.

testLogForward

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

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

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

testLog تم الحفظ

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

يتم الاتصال به عند حفظ سجل الاختبار.

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

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