NameMangleListener
public abstract class NameMangleListener
extends Object
implements ITestInvocationListener
java.lang.object | |
↳ | com.android.tradefed.result.NameMangleListener |
یک شنونده پروکسی برای ترجمه روش تست، کلاس و نام بسته به عنوان نتایج گزارش می شود.
خلاصه
سازندگان عمومی | |
---|---|
NameMangleListener ( ITestInvocationListener listener) |
روش های عمومی | |
---|---|
TestSummary | getSummary () به InvocationListener اجازه می دهد خلاصه ای را برگرداند. |
void | invocationEnded (long elapsedTime) گزارش می دهد که فراخوانی خاتمه یافته است، چه با موفقیت یا به دلیل برخی شرایط خطا. |
void | invocationFailed (Throwable cause) یک فراخوان ناقص را به دلیل برخی شرایط خطا گزارش می دهد. |
void | invocationStarted ( IInvocationContext context) شروع فراخوانی آزمون را گزارش می دهد. |
void | testAssumptionFailure ( TestDescription test, String trace) زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود |
void | testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) پایان اجرای یک مورد آزمایشی فردی را گزارش می کند. |
void | testFailed ( TestDescription test, String trace) گزارش شکست یک مورد آزمایشی فردی. |
void | testIgnored ( TestDescription test) زمانی که آزمایشی اجرا نمیشود نامیده میشود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیهنویسی میشود. |
void | testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد. |
void | testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) گزارش پایان اجرای آزمایشی |
void | testRunFailed (String errorMessage) اجرای آزمایشی گزارش ها به دلیل یک خطای مهلک انجام نشد. |
void | testRunStarted (String runName, int testCount) شروع اجرای آزمایشی را گزارش می دهد. |
void | testRunStopped (long elapsedTime) اجرای آزمایشی گزارشها قبل از تکمیل به دلیل درخواست کاربر متوقف شد. |
void | testStarted ( TestDescription test) شروع یک مورد آزمایشی فردی را گزارش می دهد. |
روش های محافظت شده | |
---|---|
TestDescription | mangleTestId ( TestDescription test) این روش بر روی تمام |
String | mangleTestRunName (String name) این متد روی همه نامهای اجرای آزمایشی که به callback |
سازندگان عمومی
NameMangleListener
public NameMangleListener (ITestInvocationListener listener)
پارامترها | |
---|---|
listener | ITestInvocationListener |
روش های عمومی
دریافت خلاصه
public TestSummary getSummary ()
به InvocationListener اجازه می دهد خلاصه ای را برگرداند.
برمی گرداند | |
---|---|
TestSummary | یک TestSummary که اجرا یا null را خلاصه می کند |
فراخوان پایان یافت
public void invocationEnded (long elapsedTime)
گزارش می دهد که فراخوانی خاتمه یافته است، چه با موفقیت یا به دلیل برخی شرایط خطا.
به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود.
پارامترها | |
---|---|
elapsedTime | long : زمان سپری شده فراخوانی در ms |
فراخوان ناموفق بود
public void invocationFailed (Throwable cause)
یک فراخوان ناقص را به دلیل برخی شرایط خطا گزارش می دهد.
به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود.
پارامترها | |
---|---|
cause | Throwable : علت Throwable شکست |
invocationStarted
public void invocationStarted (IInvocationContext context)
شروع فراخوانی آزمون را گزارش می دهد.
به طور خودکار توسط چارچوب TradeFederation فراخوانی می شود. گزارشگران باید این روش را نادیده بگیرند تا از گزارش دهی چند دستگاه پشتیبانی کنند.
پارامترها | |
---|---|
context | IInvocationContext : اطلاعاتی در مورد فراخوانی |
آزمون فرض شکست
public void testAssumptionFailure (TestDescription test, String trace)
زمانی که یک آزمایش اتمی نشان می دهد که شرطی نادرست را فرض می کند، نامیده می شود
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
trace | String : ردپای شکست |
تست پایان یافت
public void testEnded (TestDescription test,testMetrics)
پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.
اگر testFailed(TestDescription, FailureDescription)
فراخوانی نمی شد، این آزمایش با موفقیت انجام شد. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد آزمایشی منتشر شده باشد، برمی گرداند.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
testMetrics | ERROR(/Map) از معیارهای منتشر شده |
تست شکست خورد
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 کامل نشود، موجود و قابل دسترسی است. |
testRunEnded
public void testRunEnded (long elapsedTime,runMetrics)
گزارش پایان اجرای آزمایشی
پارامترها | |
---|---|
elapsedTime | long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد |
runMetrics |
testRunFailed
public void testRunFailed (String errorMessage)
اجرای آزمایشی گزارش ها به دلیل یک خطای مهلک انجام نشد.
پارامترها | |
---|---|
errorMessage | String : String که دلیل شکست اجرا را توضیح می دهد. |
testRunStarted
public void testRunStarted (String runName, int testCount)
شروع اجرای آزمایشی را گزارش می دهد.
پارامترها | |
---|---|
runName | String : نام اجرای آزمایشی |
testCount | int : تعداد کل تست ها در اجرای آزمایشی |
testRunStopped
public void testRunStopped (long elapsedTime)
اجرای آزمایشی گزارشها قبل از تکمیل به دلیل درخواست کاربر متوقف شد.
TODO: در حال حاضر استفاده نشده است، حذف را در نظر بگیرید
پارامترها | |
---|---|
elapsedTime | long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد |
تست شروع شد
public void testStarted (TestDescription test)
شروع یک مورد آزمایشی فردی را گزارش می دهد. رابط قدیمیتر، باید در صورت امکان از testStarted(com.android.tradefed.result.TestDescription)
استفاده کند.
پارامترها | |
---|---|
test | TestDescription : تست را مشخص می کند |
روش های محافظت شده
mangleTestId
protected TestDescription mangleTestId (TestDescription test)
این روش بر روی تمام TestDescription
هایی اجرا می شود که به testStarted(com.android.tradefed.result.TestDescription)
، testFailed(com.android.tradefed.result.TestDescription, String)
و ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap))
callbacks. این روش باید TestDescription
احتمالاً متفاوتی را برگرداند که به پاییندست ITestInvocationListener
که در حین ساخت مشخص شده است ارسال میشود.
پیاده سازی باید مراقب باشد که TestDescription
اصلی را تغییر ندهد.
پیاده سازی پیش فرض شناسه ورودی را از طریق اصلاح نشده عبور می دهد.
پارامترها | |
---|---|
test | TestDescription |
برمی گرداند | |
---|---|
TestDescription |
mangleTestRunName
protected String mangleTestRunName (String name)
این متد روی همه نامهای اجرای آزمایشی که به callback testRunStarted(String, int)
ارسال میشوند اجرا میشود. این روش باید نام اجرای آزمایشی متفاوتی را برگرداند که به پاییندستی ITestInvocationListener
که در حین ساخت مشخص شده بود ارسال میشود.
پیاده سازی باید مراقب باشد که نام اجرای اصلی را تغییر ندهید.
پیادهسازی پیشفرض نام اجرای آزمایشی ورودی را بدون تغییر میگذراند.
پارامترها | |
---|---|
name | String |
برمی گرداند | |
---|---|
String |