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) یک |
روش های عمومی | |
---|---|
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 باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در |
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) اجرای آزمایشی گزارشها به دلیل نقصی که توسط |
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
publicgetUnderlyingResultReporter ()
برمی گرداند | |
---|---|
فراخوان پایان یافت
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)
گزارش پایان اجرای آزمایشی
پارامترها | |
---|---|
elapsedTime | long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد |
runMetrics |
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() |