ProtoResultReporter
public abstract class ProtoResultReporter
extends Object
implements ILogSaverListener , ISupportGranularResults , ITestInvocationListener
java.lang.object | |
↳ | com.android.tradefed.result.proto.ProtoResultReporter |
گزارشگر نتیجه یک پروتوباف TestRecord
با تمام نتایج داخل آن میسازد. باید برای رسیدگی به کارهایی که باید با پروتو نهایی در processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord)
انجام شود گسترش داده شود.
خلاصه
سازندگان عمومی | |
---|---|
ProtoResultReporter () |
روش های عمومی | |
---|---|
final void | invocationEnded (long elapsedTime) گزارش می دهد که فراخوانی خاتمه یافته است، چه با موفقیت یا به دلیل برخی شرایط خطا. |
void | invocationFailed ( FailureDescription failure) یک فراخوان ناقص را به دلیل برخی شرایط خطا گزارش می دهد. |
void | invocationFailed (Throwable cause) یک فراخوان ناقص را به دلیل برخی شرایط خطا گزارش می دهد. |
void | invocationSkipped ( SkipReason reason) یک فراخوان را به عنوان نادیده گرفته شده گزارش می کند |
final void | invocationStarted ( IInvocationContext context) شروع فراخوانی آزمون را گزارش می دهد. |
final void | logAssociation (String dataName, LogFile logFile) در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در |
void | processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs) از رکورد فراخوانی برای ارسال یک به یک تمام لاگ های نهایی فراخوان استفاده کنید. |
void | processFinalProto (TestRecordProto.TestRecord finalRecord) رسیدگی به پروتو نهایی با همه نتایج. |
void | processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext) رسیدگی به پروتوی رکورد آزمون فراخوانی جزئی پس از وقوع |
void | processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord) رسیدگی به پرونده پرونده آزمایشی نهایی شده پس از |
void | processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord) پس از |
void | processTestModuleEnd (TestRecordProto.TestRecord moduleRecord) مدیریت پروتو رکورد ماژول نهایی پس از |
void | processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord) پس از |
void | processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress) مدیریت پروتو رکورد اجرای نهایی پس از |
void | processTestRunStarted (TestRecordProto.TestRecord runStartedRecord) مدیریت پروتو رکورد اجرای آزمایشی جزئی پس از اجرای |
void | setGranularResults (boolean granularResults) |
void | setInlineRecordOfChildren (boolean inline) |
boolean | supportGranularResults () اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است. |
final void | testAssumptionFailure ( TestDescription test, String trace) زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود |
final void | testAssumptionFailure ( TestDescription test, FailureDescription failure) زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود |
final void | testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) جایگزینی برای |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) پایان اجرای یک مورد آزمایشی فردی را گزارش می کند. |
final void | testFailed ( TestDescription test, FailureDescription failure) گزارش شکست یک مورد آزمایشی فردی. |
final void | testFailed ( TestDescription test, String trace) گزارش شکست یک مورد آزمایشی فردی. |
final void | testIgnored ( TestDescription test) زمانی که آزمایشی اجرا نمیشود نامیده میشود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیهنویسی میشود. |
final void | testModuleEnded () پایان اجرای یک ماژول را گزارش می دهد. |
final void | testModuleStarted ( IInvocationContext moduleContext) شروع یک ماژول در حال اجرا را گزارش می دهد. |
final void | testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) گزارش پایان اجرای آزمایشی |
final void | testRunFailed ( FailureDescription failure) اجرای آزمایشی گزارشها به دلیل نقصی که توسط |
final void | testRunFailed (String errorMessage) اجرای آزمایشی گزارش ها به دلیل یک خطای مهلک انجام نشد. |
void | testRunStarted (String runName, int testCount, int attemptNumber) شروع اجرای آزمایشی را گزارش می دهد. |
final void | testRunStarted (String runName, int testCount) شروع اجرای آزمایشی را گزارش می دهد. |
void | testRunStarted (String runName, int testCount, int attemptNumber, long startTime) شروع اجرای آزمایشی را گزارش می دهد. |
final void | testSkipped ( TestDescription test, SkipReason reason) زمانی فراخوانی میشود که آزمایشی نادیده گرفته میشود و به دلیلی که معمولاً انتظار نمیرود اجرا نمیشود. |
final void | testStarted ( TestDescription test, long startTime) جایگزینی برای |
final void | testStarted ( TestDescription test) شروع یک مورد آزمایشی فردی را گزارش می دهد. |
روش های محافظت شده | |
---|---|
void | afterModuleEnd () |
void | beforeModuleStart () |
TestRecordProto.ChildReference | createModuleChildReference (TestRecordProto.TestRecord record) یک مرجع فرزند برای یک ماژول ایجاد می کند. |
سازندگان عمومی
ProtoResultReporter
public ProtoResultReporter ()
روش های عمومی
فراخوان پایان یافت
public final 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 final void invocationStarted (IInvocationContext context)
شروع فراخوانی آزمون را گزارش می دهد.
به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود. گزارشگران باید این روش را نادیده بگیرند تا از گزارش دهی چند دستگاه پشتیبانی کنند.
پارامترها | |
---|---|
context | IInvocationContext : اطلاعاتی در مورد فراخوانی |
logAssociation
public final 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 که قبلاً ثبت شده است و باید با پرونده آزمایشی مرتبط شود. |
processFinalInvocationLogs
public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)
از رکورد فراخوانی برای ارسال یک به یک تمام لاگ های نهایی فراخوان استفاده کنید.
پارامترها | |
---|---|
invocationLogs | TestRecordProto.TestRecord : پروتوی نهایی که فراخوانی را نشان می دهد. |
processFinalProto
public void processFinalProto (TestRecordProto.TestRecord finalRecord)
رسیدگی به پروتو نهایی با همه نتایج.
پارامترها | |
---|---|
finalRecord | TestRecordProto.TestRecord : پروتو نهایی شده با تمام نتایج فراخوانی. |
processStartInvocation
public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)
رسیدگی به پروتوی رکورد آزمون فراخوانی جزئی پس از وقوع invocationStarted(com.android.tradefed.invoker.IInvocationContext)
.
پارامترها | |
---|---|
invocationStartRecord | TestRecordProto.TestRecord : پروتوی جزئی که پس از invocationStart پر شده است. |
invocationContext | IInvocationContext : فراخوان IInvocationContext . |
processTestCaseEnded
public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)
رسیدگی به پرونده پرونده آزمایشی نهایی شده پس از ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap))
رخ داد.
پارامترها | |
---|---|
testCaseRecord | TestRecordProto.TestRecord : پروتو نهایی شده که یک مورد آزمایشی را نشان می دهد. |
processTestCaseStarted
public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)
پس از testStarted(com.android.tradefed.result.TestDescription, long)
پروتوی ثبت پرونده آزمایشی جزئی انجام شد.
پارامترها | |
---|---|
testCaseStartedRecord | TestRecordProto.TestRecord : پروتوی جزئی که نمونه آزمایشی را نشان می دهد. |
processTestModuleEnd
public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)
مدیریت پروتو رکورد ماژول نهایی پس از testModuleEnded()
رخ داد.
پارامترها | |
---|---|
moduleRecord | TestRecordProto.TestRecord : پروتو نهایی که نشان دهنده ماژول است. |
processTestModuleStarted
public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)
پس از testModuleStarted(com.android.tradefed.invoker.IInvocationContext)
پروتو رکورد ماژول جزئی انجام شد.
پارامترها | |
---|---|
moduleStartRecord | TestRecordProto.TestRecord : پروتوی جزئی که ماژول را نشان می دهد. |
processTestRunEnded
public void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)
مدیریت پروتو رکورد اجرای نهایی پس از ERROR(/#testRunEnded(long,HashMap))
رخ داد.
پارامترها | |
---|---|
runRecord | TestRecordProto.TestRecord : پروتو نهایی که اجرا را نشان می دهد. |
moduleInProgress | boolean : آیا یک ماژول در حال پیشرفت است یا خیر. |
processTestRunStarted
public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)
مدیریت پروتو رکورد اجرای آزمایشی جزئی پس از اجرای testRunStarted(String, int)
.
پارامترها | |
---|---|
runStartedRecord | TestRecordProto.TestRecord : پروتوی جزئی که اجرا را نشان می دهد. |
setGranular Results
public void setGranularResults (boolean granularResults)
پارامترها | |
---|---|
granularResults | boolean |
setInlineRecordOfChildren
public void setInlineRecordOfChildren (boolean inline)
پارامترها | |
---|---|
inline | boolean |
supportGranular Results
public boolean supportGranularResults ()
اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است.
برمی گرداند | |
---|---|
boolean |
آزمون فرض شکست
public final void testAssumptionFailure (TestDescription test, String trace)
زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
trace | String : ردپای شکست |
آزمون فرض شکست
public final void testAssumptionFailure (TestDescription test, FailureDescription failure)
زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
failure | FailureDescription : FailureDescription که شکست و زمینه آن را توصیف می کند. |
تست پایان یافت
public final void testEnded (TestDescription test, long endTime,testMetrics)
جایگزینی برای ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))
که میتوانیم زمان پایان را مستقیماً مشخص کنیم. برای اندازه گیری دقیق، با testStarted(com.android.tradefed.result.TestDescription, long)
ترکیب کنید.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
endTime | long : زمان پایان آزمایش، اندازهگیری شده از طریق System.currentTimeMillis() |
testMetrics | ERROR(/Map) از معیارهای منتشر شده |
تست پایان یافت
public void testEnded (TestDescription test,testMetrics)
پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.
اگر testFailed(TestDescription, FailureDescription)
فراخوانی نمی شد، این آزمایش با موفقیت انجام شد. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد آزمایشی منتشر شده باشد، برمی گرداند.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
testMetrics | ERROR(/Map) از معیارهای منتشر شده |
تست شکست خورد
public final void testFailed (TestDescription test, FailureDescription failure)
گزارش شکست یک مورد آزمایشی فردی.
بین testStarted و testEnded فراخوانی خواهد شد.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
failure | FailureDescription : FailureDescription که شکست و زمینه آن را توصیف می کند. |
تست شکست خورد
public final void testFailed (TestDescription test, String trace)
گزارش شکست یک مورد آزمایشی فردی.
بین testStarted و testEnded فراخوانی خواهد شد.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
trace | String : ردپای شکست |
تست نادیده گرفته شد
public final void testIgnored (TestDescription test)
زمانی که آزمایشی اجرا نمیشود نامیده میشود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیهنویسی میشود.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
testModuleEnded
public final void testModuleEnded ()
پایان اجرای یک ماژول را گزارش می دهد.
testModuleStarted
public final void testModuleStarted (IInvocationContext moduleContext)
شروع یک ماژول در حال اجرا را گزارش می دهد. این فراخوانی با testModuleEnded()
مرتبط است و در دنباله اختیاری است. این فقط در طول اجرا استفاده می شود که از ماژول ها استفاده می کند: دونده های مبتنی بر مجموعه.
پارامترها | |
---|---|
moduleContext | IInvocationContext : IInvocationContext ماژول. |
testRunEnded
public final void testRunEnded (long elapsedTimeMillis,runMetrics)
گزارش پایان اجرای آزمایشی
پارامترها | |
---|---|
elapsedTimeMillis | long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد |
runMetrics |
testRunFailed
public final void testRunFailed (FailureDescription failure)
اجرای آزمایشی گزارشها به دلیل نقصی که توسط FailureDescription
توصیف شده است، انجام نشد.
پارامترها | |
---|---|
failure | FailureDescription : FailureDescription که شکست و زمینه آن را توصیف می کند. |
testRunFailed
public final void testRunFailed (String errorMessage)
اجرای آزمایشی گزارش ها به دلیل یک خطای مهلک انجام نشد.
پارامترها | |
---|---|
errorMessage | String : String که دلیل شکست اجرا را توضیح می دهد. |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber)
شروع اجرای آزمایشی را گزارش می دهد.
پارامترها | |
---|---|
runName | String : نام اجرای آزمایشی |
testCount | int : تعداد کل تست ها در اجرای آزمایشی |
attemptNumber | int : شماره سفارش، شناسایی تلاشهای مختلف یک runName که چندین بار اجرا میشوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 0 تا 3 باشد. |
testRunStarted
public final void testRunStarted (String runName, int testCount)
شروع اجرای آزمایشی را گزارش می دهد.
پارامترها | |
---|---|
runName | String : نام اجرای آزمایشی |
testCount | int : تعداد کل تست ها در اجرای آزمایشی |
testRunStarted
public void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)
شروع اجرای آزمایشی را گزارش می دهد.
پارامترها | |
---|---|
runName | String : نام اجرای آزمایشی |
testCount | int : تعداد کل تست ها در اجرای آزمایشی |
attemptNumber | int : شماره سفارش، شناسایی تلاشهای مختلف یک runName که چندین بار اجرا میشوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 0 تا 3 باشد. |
startTime | long : زمان شروع اجرا، اندازهگیری شده از طریق System.currentTimeMillis() |
تست رد شد
public final void testSkipped (TestDescription test, SkipReason reason)
زمانی فراخوانی میشود که آزمایشی نادیده گرفته میشود و به دلیلی که معمولاً انتظار نمیرود اجرا نمیشود. سعی می شود این تست ها مجددا امتحان شوند تا اجرای مناسبی انجام شود.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
reason | SkipReason : SkipReason |
تست شروع شد
public final void testStarted (TestDescription test, long startTime)
جایگزینی برای testStarted(com.android.tradefed.result.TestDescription)
که در آن زمان شروع آزمایش را نیز مشخص می کنیم، همراه با ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))
برای اندازه گیری دقیق .
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
startTime | long : زمان شروع آزمایش، اندازهگیری شده از طریق System.currentTimeMillis() |
تست شروع شد
public final void testStarted (TestDescription test)
شروع یک مورد آزمایشی فردی را گزارش می دهد. رابط قدیمیتر، باید در صورت امکان از testStarted(com.android.tradefed.result.TestDescription)
استفاده کند.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
روش های محافظت شده
afterModuleEnd
protected void afterModuleEnd ()
قبل از ModuleStart
protected void beforeModuleStart ()
createModuleChildReference
protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)
یک مرجع فرزند برای یک ماژول ایجاد می کند.
پارامترها | |
---|---|
record | TestRecordProto.TestRecord |
برمی گرداند | |
---|---|
TestRecordProto.ChildReference |