ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.object
com.android.tradefed.result.ResultForwarder


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

خلاصه

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

ResultForwarder ( listeners) ResultForwarder ( listeners)

یک ResultForwarder ایجاد کنید.

ResultForwarder ( ITestInvocationListener... listeners)

سازنده متغیر arg برای ResultForwarder .

سازندگان محافظت شده

ResultForwarder ()

یک ResultForwarder با تنظیمات شنونده معوق ایجاد کنید.

روش های عمومی

TestSummary getSummary ()

به InvocationListener اجازه می دهد خلاصه ای را برگرداند.

void invocationEnded (long elapsedTime)

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

void invocationFailed ( FailureDescription failure)

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

void invocationFailed (Throwable cause)

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

void invocationSkipped ( SkipReason reason)

یک فراخوان را به عنوان نادیده گرفته شده گزارش می کند

void invocationStarted ( IInvocationContext context)

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

void testAssumptionFailure ( TestDescription test, String trace)

زمانی که یک آزمایش اتمی مشخص می کند که شرطی نادرست را فرض می کند، نامیده می شود

void testAssumptionFailure ( TestDescription test, FailureDescription failure)

زمانی که یک آزمایش اتمی مشخص می کند که شرطی نادرست را فرض می کند، نامیده می شود

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)

پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.

void testFailed ( TestDescription test, FailureDescription failure)

گزارش شکست یک مورد آزمایشی فردی.

void testFailed ( TestDescription test, String trace)

گزارش شکست یک مورد آزمایشی فردی.

void testIgnored ( TestDescription test)

زمانی که آزمایشی اجرا نمی‌شود نامیده می‌شود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیه‌نویسی می‌شود.

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

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

void testModuleEnded ()

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

void testModuleStarted ( IInvocationContext moduleContext)

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

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

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

void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount, int attemptNumber)

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

void testRunStarted (String runName, int testCount)

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

void testRunStarted (String runName, int testCount, int attemptNumber, long startTime)

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

void testRunStopped (long elapsedTime)

اجرای آزمایشی گزارش‌ها قبل از تکمیل به دلیل درخواست کاربر متوقف شد.

void testSkipped ( TestDescription test, SkipReason reason)

زمانی فراخوانی می‌شود که آزمایشی نادیده گرفته می‌شود و به دلیلی که معمولاً انتظار نمی‌رود اجرا نمی‌شود.

void testStarted ( TestDescription test, long startTime)

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

void testStarted ( TestDescription test)

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

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

getListeners ()

لیست شنوندگان را دریافت کنید.

void setListeners ( ITestInvocationListener... listeners)

شنوندگان را پس از ساخت تنظیم کنید.

void setListeners ( listeners) setListeners ( listeners)

شنوندگان را پس از ساخت تنظیم کنید.

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

ResultForwarder

public ResultForwarder ( listeners)

یک ResultForwarder ایجاد کنید.

مولفه های
listeners : ITestInvocationListener واقعی برای ارسال نتایج به آن است

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

سازنده متغیر arg برای ResultForwarder .

مولفه های
listeners ITestInvocationListener : ITestInvocationListener واقعی برای ارسال نتایج به

سازندگان محافظت شده

ResultForwarder

protected ResultForwarder ()

یک ResultForwarder با تنظیمات شنونده معوق ایجاد کنید. فقط برای استفاده توسط زیر کلاس ها در نظر گرفته شده است.

روش های عمومی

دریافت خلاصه

public TestSummary getSummary ()

به InvocationListener اجازه می دهد خلاصه ای را برگرداند.

برمی گرداند
TestSummary یک TestSummary که اجرا یا null را خلاصه می کند

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

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 : اطلاعاتی در مورد فراخوانی

آزمون فرض شکست

public void testAssumptionFailure (TestDescription test, 
                String trace)

زمانی که یک آزمایش اتمی مشخص می کند که شرطی نادرست را فرض می کند، نامیده می شود

مولفه های
test TestDescription : تست را مشخص می کند

trace String : ردپای شکست

آزمون فرض شکست

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

زمانی که یک آزمایش اتمی مشخص می کند که شرطی نادرست را فرض می کند، نامیده می شود

مولفه های
test TestDescription : تست را مشخص می کند

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

تست پایان یافت

public 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 void testFailed (TestDescription test, 
                FailureDescription failure)

گزارش شکست یک مورد آزمایشی فردی.

بین testStarted و testEnded فراخوانی خواهد شد.

مولفه های
test TestDescription : تست را مشخص می کند

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

تست شکست خورد

public void testFailed (TestDescription test, 
                String trace)

گزارش شکست یک مورد آزمایشی فردی.

بین testStarted و testEnded فراخوانی خواهد شد.

مولفه های
test TestDescription : تست را مشخص می کند

trace String : ردپای شکست

تست نادیده گرفته شد

public void testIgnored (TestDescription test)

زمانی که آزمایشی اجرا نمی‌شود نامیده می‌شود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیه‌نویسی می‌شود.

مولفه های
test TestDescription : تست را مشخص می کند

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 کامل نشود، موجود و قابل دسترسی است.

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

testRunStopped

public void testRunStopped (long elapsedTime)

اجرای آزمایشی گزارش‌ها قبل از تکمیل به دلیل درخواست کاربر متوقف شد.

TODO: در حال حاضر استفاده نشده است، حذف را در نظر بگیرید

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

تست رد شد

public void testSkipped (TestDescription test, 
                SkipReason reason)

زمانی فراخوانی می‌شود که آزمایشی نادیده گرفته می‌شود و به دلیلی که معمولاً انتظار نمی‌رود اجرا نمی‌شود. سعی می شود این تست ها دوباره امتحان شوند تا اجرای مناسبی انجام شود.

مولفه های
test TestDescription : تست را مشخص می کند

reason SkipReason : SkipReason

تست شروع شد

public 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 void testStarted (TestDescription test)

شروع یک مورد آزمایشی فردی را گزارش می دهد. رابط قدیمی‌تر، باید در صورت امکان testStarted(com.android.tradefed.result.TestDescription) استفاده کند.

مولفه های
test TestDescription : تست را مشخص می کند

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

دریافت شنوندگان

protected  getListeners ()

لیست شنوندگان را دریافت کنید. فقط برای استفاده توسط زیر کلاس ها در نظر گرفته شده است.

برمی گرداند
لیست ITestInvocationListener s.

setListeners

protected void setListeners (ITestInvocationListener... listeners)

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

مولفه های
listeners ITestInvocationListener : ITestInvocationListener واقعی برای ارسال نتایج به

setListeners

protected void setListeners ( listeners)

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

مولفه های
listeners : ITestInvocationListener واقعی برای ارسال نتایج به آن است