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) في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة 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

invocationEnded

public void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
elapsedTime	‫long: الوقت المنقضي منذ بدء الطلب بالملي ثانية

invocationEnded

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

ردّ اتصال أكثر تفصيلاً للتمييز بين الشريحة التي انتهت

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

invocationFailed

public void invocationFailed (FailureDescription failure)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationFailed

public void invocationFailed (Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

المعلمات
cause	Throwable: Throwable سبب الخطأ

invocationSkipped

public void invocationSkipped (SkipReason reason)

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

المعلمات
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

الإبلاغ عن بدء استدعاء الاختبار

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة 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

testLogSaved

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 لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية.
logFile	‫LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ