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 حاوی متا داده های فایل ذخیره شده است.