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 باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) امکان پذیر نیست.

void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

از رکورد فراخوانی برای ارسال یک به یک تمام لاگ های نهایی فراخوان استفاده کنید.

void processFinalProto (TestRecordProto.TestRecord finalRecord)

رسیدگی به پروتو نهایی با همه نتایج.

void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

رسیدگی به پروتوی رکورد آزمون فراخوانی جزئی پس از وقوع invocationStarted(com.android.tradefed.invoker.IInvocationContext) .

void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

رسیدگی به پرونده پرونده آزمایشی نهایی شده پس از ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) رخ داد.

void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

پس از testStarted(com.android.tradefed.result.TestDescription, long) پروتوی ثبت پرونده آزمایشی جزئی انجام شد.

void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

مدیریت پروتو رکورد ماژول نهایی پس از testModuleEnded() رخ داد.

void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

پس از testModuleStarted(com.android.tradefed.invoker.IInvocationContext) پروتو رکورد ماژول جزئی انجام شد.

void processTestRunEnded (TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

مدیریت پروتو رکورد اجرای نهایی پس از ERROR(/#testRunEnded(long,HashMap)) رخ داد.

void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

مدیریت پروتو رکورد اجرای آزمایشی جزئی پس از testRunStarted(String, int) .

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)

جایگزینی برای ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) که می‌توانیم زمان پایان را مستقیماً مشخص کنیم.

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)

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

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)

جایگزینی برای testStarted(com.android.tradefed.result.TestDescription) که در آن زمان شروع آزمایش را نیز مشخص می کنیم، همراه با ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) برای اندازه گیری دقیق .

final void testStarted ( TestDescription test)

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

روش های محافظت شده

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)

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

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

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

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 : تست را مشخص می کند

روش های محافظت شده

createModuleChildReference 

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

یک مرجع فرزند برای یک ماژول ایجاد می کند.

پارامترها
record TestRecordProto.TestRecord

برمی گرداند
TestRecordProto.ChildReference