ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.object
com.android.tradefed.result.CollectingTestListener
com.android.tradefed.invoker.ShardListener


یک ITestInvocationListener که نتایج را از یک فراخوان جمع‌آوری می‌کند (معروف به تقسیم فراخوانی برای اجرای موازی منابع متعدد)، و آنها را به شنونده دیگری ارسال می‌کند.

خلاصه

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

ShardListener ( ITestInvocationListener main)

یک ShardListener ایجاد کنید.

روش های عمومی

getUnderlyingResultReporter ()
void invocationEnded (long elapsedTime)

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

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 setSupportGranularResults (boolean enableGranularResults)
boolean supportGranularResults ()

اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است.

void testLog (String dataName, LogDataType dataType, InputStreamSource dataStream)

گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد.

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

void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می دهد.

void testModuleStarted ( IInvocationContext moduleContext)

شروع یک ماژول در حال اجرا را گزارش می دهد.

void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

گزارش پایان اجرای آزمایشی

void testRunFailed ( FailureDescription failure)

اجرای آزمایشی گزارش‌ها به دلیل نقصی که توسط FailureDescription توصیف شده است، کامل نشد.

void testRunFailed (String failureMessage)

اجرای آزمایشی گزارش‌ها به دلیل یک خطای مهلک انجام نشد.

void testRunStarted (String name, int numTests, int attemptNumber, long startTime)

شروع اجرای آزمایشی را گزارش می دهد.

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

ShardListener

public ShardListener (ITestInvocationListener main)

یک ShardListener ایجاد کنید.

مولفه های
main ITestInvocationListener : ITestInvocationListener نتایج باید ارسال شوند. برای جلوگیری از برخورد با دیگر ShardListener ها، این شیء در هنگام ارسال نتایج در main همگام می شود. و نتایج فقط زمانی ارسال می‌شوند که بخش فراخوانی کامل شود.

روش های عمومی

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

برمی گرداند

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

public void invocationEnded (long elapsedTime)

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

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

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

فراخوان ناموفق بود

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 که قبلاً ثبت شده است و باید با پرونده آزمایشی مرتبط شود.

setSupportGranular Results

public void setSupportGranularResults (boolean enableGranularResults)

مولفه های
enableGranularResults boolean

supportGranular Results

public boolean supportGranularResults ()

اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است.

برمی گرداند
boolean

testLog

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

گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد.

باید قبل از ERROR(/ITestInvocationListener#invocationFailed(Throwable)) یا ERROR(/ITestInvocationListener#invocationEnded(long)) فراخوانی شود

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

مولفه های
dataName String : نام توصیفی String از داده ها. به عنوان مثال "device_logcat". توجه داشته باشید dataName ممکن است در هر فراخوان منحصر به فرد نباشد. یعنی پیاده‌کننده‌ها باید بتوانند چندین تماس را با dataName یکسان مدیریت کنند

dataType LogDataType : LogDataType داده ها

dataStream InputStreamSource : InputStreamSource داده ها. پیاده‌کننده‌ها باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و از بسته شدن InputStream حاصل پس از تکمیل اطمینان حاصل کنند. تماس‌گیرندگان باید اطمینان حاصل کنند که منبع داده‌ها تا زمانی که روش testLog کامل نشود، موجود و قابل دسترسی است.

testLogSaved

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

مولفه های
dataName String

dataType LogDataType

dataStream InputStreamSource

logFile LogFile

testModuleEnded

public void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می دهد.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

شروع یک ماژول در حال اجرا را گزارش می دهد. این فراخوانی با testModuleEnded() مرتبط است و در دنباله اختیاری است. این فقط در طول اجرا استفاده می شود که از ماژول ها استفاده می کند: دونده های مبتنی بر مجموعه.

مولفه های
moduleContext IInvocationContext : IInvocationContext ماژول.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

گزارش پایان اجرای آزمایشی FIXME: ما نمی توانیم دو رابط Map<> با نوع متفاوت داشته باشیم، بنابراین باید از HashMap در اینجا استفاده کنیم.

مولفه های
elapsedTime long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد

runMetrics : جفت های کلید-مقدار در پایان اجرای آزمایشی با Metric گزارش شده است.

testRunFailed

public void testRunFailed (FailureDescription failure)

اجرای آزمایشی گزارش‌ها به دلیل نقصی که توسط FailureDescription توصیف شده است، کامل نشد.

مولفه های
failure FailureDescription : FailureDescription که شکست و زمینه آن را توصیف می کند.

testRunFailed

public void testRunFailed (String failureMessage)

اجرای آزمایشی گزارش‌ها به دلیل یک خطای مهلک انجام نشد.

مولفه های
failureMessage String : String که دلیل شکست اجرا را توضیح می دهد.

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

شروع اجرای آزمایشی را گزارش می دهد.

مولفه های
name String : نام اجرای آزمایشی

numTests int : تعداد کل تست ها در اجرای آزمایشی

attemptNumber int : شماره سفارش، شناسایی تلاش‌های مختلف یک runName که چندین بار اجرا می‌شوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 0 تا 3 باشد.

startTime long : زمان شروع اجرا، اندازه‌گیری شده از طریق System.currentTimeMillis()