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()