این صفحه به‌وسیله ‏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 ( 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)` در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در `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` : تعداد خرده ها

روش های عمومی

دریافت شنوندگان

public  getListeners ()

لیست شنوندگان را دریافت کنید. فقط برای استفاده توسط زیر کلاس ها در نظر گرفته شده است.

برمی گرداند
	لیست `ITestInvocationListener` s.

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

public void invocationEnded (long elapsedTime)

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

به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود.

پارامترها
`elapsedTime`	`long` : زمان سپری شده فراخوانی در ms

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

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`

invocationStarted

public void invocationStarted (IInvocationContext context)

شروع فراخوانی آزمون را گزارش می دهد.

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در 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` حاوی متا داده های فایل ذخیره شده است.