ShardMainResultForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

شیء جاوا
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.invoker.ShardMainResultForwarder

---

یک ResultForwarder که نتایج فراخوانی‌های آزمایشی sharded را ترکیب می‌کند. این ابزار تنها زمانی تکمیل فراخوانی را به شنوندگان گزارش می‌دهد که تمام فراخوانی‌های sharded تکمیل شده باشند.

این کلاس thread safe نیست. انتظار می‌رود که کلاینت‌ها هنگام ارسال نتایج تست، این کلاس را قفل کنند تا از فراخوانی‌های برگشتی فراخوانی خارج از ترتیب جلوگیری شود.

خلاصه

سازندگان عمومی
ShardMainResultForwarder (List< ITestInvocationListener > listeners, int expectedShards) یک ShardMainResultForwarder ایجاد کنید.

روش‌های عمومی
List< ITestInvocationListener >	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) در برخی موارد، log باید به شدت با یک مورد آزمایشی مرتبط باشد، اما امکان انجام این کار در فراخوانی مستقیم testLogSaved(String,LogDataType,InputStreamSource,LogFile) امکان‌پذیر نیست.
void	testLogForward (String dataName, LogDataType dataType, InputStreamSource dataStream) فقط به جای ذخیره کردن لاگ، testLog را فوروارد کنید.
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) زمانی که گزارش آزمایش ذخیره می‌شود، فراخوانی می‌شود.

سازندگان عمومی

ShardMainResultForwarder

public ShardMainResultForwarder (List<ITestInvocationListener> listeners, 
                int expectedShards)

یک ShardMainResultForwarder ایجاد کنید.

پارامترها
listeners	List : فهرست ITestInvocationListener که قرار است پس از تکمیل تمام Shardها، نتایج به آن ارسال شود.
expectedShards	int : تعداد قطعات (shards)

روش‌های عمومی

دریافت‌کنندگان

public List<ITestInvocationListener> getListeners ()

لیست شنوندگان را دریافت کنید.

بازگشت‌ها
List< ITestInvocationListener >	لیست ITestInvocationListener ها.

فراخوان پایان یافت

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 invocationSkipped (SkipReason reason)

یک فراخوانی را به عنوان رد شده گزارش می‌دهد

پارامترها
reason	SkipReason

فراخوان شروع شد

public void invocationStarted (IInvocationContext context)

شروع فراخوانی تست را گزارش می‌دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود. گزارشگران برای پشتیبانی از گزارش‌دهی چندین دستگاه، باید این متد را بازنویسی کنند.

پارامترها
context	IInvocationContext : اطلاعاتی درباره فراخوانی

انجمن ورود به سیستم

public void logAssociation (String dataName, 
                LogFile logFile)

در برخی موارد، log باید به شدت با یک مورد آزمایشی مرتبط باشد، اما امکان انجام این کار در فراخوانی مستقیم testLogSaved(String,LogDataType,InputStreamSource,LogFile) امکان‌پذیر نیست. بنابراین، این فراخوانی امکان ارائه یک ارتباط قوی را به طور صریح فراهم می‌کند.

پارامترها
dataName	String : نام داده
logFile	LogFile : LogFile که قبلاً لاگ شده و باید با مورد آزمایشی مرتبط باشد.

تست لاگ فوروارد

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". توجه داشته باشید که dataName ممکن است در هر فراخوانی منحصر به فرد نباشد. یعنی پیاده‌سازی‌کنندگان باید بتوانند چندین فراخوانی را با همان dataName مدیریت کنند.
dataType	LogDataType : نوع داده‌ی LogDataType
dataStream	InputStreamSource : InputStreamSource داده‌ها. پیاده‌سازی‌کنندگان باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و مطمئن شوند که InputStream حاصل را پس از اتمام کار ببندند.
logFile	LogFile : LogFile که شامل متا دیتای فایل ذخیره شده است.