نتیجه اجرای تست

public class TestRunResult
extends Object implements ITestRunListener

شیء جاوا
↳ com.android.ddmlib.testunner.TestRunResult

نتایج حاصل از یک اجرای آزمایشی واحد را در خود نگه می‌دارد.

تعداد دقیق آزمایش‌ها را ثبت می‌کند و آزمایش‌های ناقص را پیگیری می‌کند.

thread safe نیست! فراخوانی‌های test* باید به ترتیب فراخوانی شوند.

خلاصه

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

TestRunResult ()

یک TestRunResult خالی ایجاد کنید.

روش‌های عمومی

getCompletedTests ()

مجموعه تست‌های تکمیل‌شده را دریافت می‌کند.

long getElapsedTime ()

زمان سپری شده از اجرای فعلی را برمی‌گرداند.

String getName ()
int getNumAllFailedTests ()

تعداد کل تست‌ها را در حالت شکست (شکست، شکست فرض) برمی‌گرداند

int getNumCompleteTests ()

تعداد تست‌های کامل شده در این اجرا، یعنی با وضعیت != ناکامل، را برمی‌گرداند.

int getNumTests ()

تعداد تست‌های انجام شده در این اجرا را دریافت می‌کند.

int getNumTestsInState ( TestResult.TestStatus status)

تعداد تست‌ها را در حالت داده شده برای این اجرا دریافت می‌کند.

String getRunFailureMessage ()

پیام خطای عدم موفقیت در اجرا را برمی‌گرداند، در صورتی که اجرا با شکست مواجه نشود، null .

getRunMetrics ()
getTestResults ()

نقشه‌ای از نتایج آزمایش را برمی‌گرداند.

String getTextSummary ()

یک رشته‌ی کاربرپسند که نتایج را توصیف می‌کند، برمی‌گرداند.

boolean hasFailedTests ()
boolean isRunComplete ()
boolean isRunFailure ()
void setAggregateMetrics (boolean metricAggregation)
void setRunComplete (boolean runComplete)
void testAssumptionFailure ( TestIdentifier test, String trace)

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

void testEnded ( TestIdentifier test, testMetrics)

پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.

void testFailed ( TestIdentifier test, String trace)

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

void testIgnored ( TestIdentifier test)

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

void testRunEnded (long elapsedTime, runMetrics)

پایان اجرای آزمایش را گزارش می‌دهد.

void testRunFailed (String errorMessage)

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

void testRunStarted (String runName, int testCount)

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

void testRunStopped (long elapsedTime)

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

void testStarted ( TestIdentifier test)

شروع یک مورد آزمایشی (test case) منفرد را گزارش می‌دهد.

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

نتیجه اجرای تست 

public TestRunResult ()

یک TestRunResult خالی ایجاد کنید.

روش‌های عمومی

دریافت آزمون‌های تکمیل‌شده 

public  getCompletedTests ()

مجموعه تست‌های تکمیل‌شده را دریافت می‌کند.

بازگشت‌ها

دریافت زمان سپری شده 

public long getElapsedTime ()

زمان سپری شده از اجرای فعلی را برمی‌گرداند.

بازگشت‌ها
long

دریافت نام 

public String getName ()

بازگشت‌ها
String نام اجرای آزمایشی

دریافت تعداد همه تست‌های ناموفق 

public int getNumAllFailedTests ()

تعداد کل تست‌ها را در حالت شکست (شکست، شکست فرض) برمی‌گرداند

بازگشت‌ها
int

getNumCompleteTests 

public int getNumCompleteTests ()

تعداد تست‌های کامل شده در این اجرا، یعنی با وضعیت != ناکامل، را برمی‌گرداند.

بازگشت‌ها
int

getNumTests 

public int getNumTests ()

تعداد تست‌های انجام شده در این اجرا را دریافت می‌کند.

بازگشت‌ها
int

دریافتNumTestsInState 

public int getNumTestsInState (TestResult.TestStatus status)

تعداد تست‌ها را در حالت داده شده برای این اجرا دریافت می‌کند.

پارامترها
status TestResult.TestStatus

بازگشت‌ها
int

پیام خطای اجرا شده 

public String getRunFailureMessage ()

پیام خطای عدم موفقیت در اجرا را برمی‌گرداند، در صورتی که اجرا با شکست مواجه نشود، null .

بازگشت‌ها
String

getRunMetrics 

public  getRunMetrics ()

بازگشت‌ها
ERROR(/Map) مربوط به معیارهای اجرای تست.

دریافت نتایج آزمون 

public  getTestResults ()

نقشه‌ای از نتایج آزمایش را برمی‌گرداند.

بازگشت‌ها

خلاصه متن 

public String getTextSummary ()

یک رشته‌ی کاربرپسند که نتایج را توصیف می‌کند، برمی‌گرداند.

بازگشت‌ها
String

تست‌های ناموفق 

public boolean hasFailedTests ()

بازگشت‌ها
boolean اگر اجرای آزمایشی، تست‌های ناموفق یا خطایی داشته باشد، true .

isRunComplete 

public boolean isRunComplete ()

بازگشت‌ها
boolean اگر اجرای آزمایشی تمام شود، true .

isRunFailure 

public boolean isRunFailure ()

بازگشت‌ها
boolean اگر اجرای آزمایشی ناموفق بود، true .

setAggregateMetrics 

public void setAggregateMetrics (boolean metricAggregation)

پارامترها
metricAggregation boolean

setRunComplete 

public void setRunComplete (boolean runComplete)

پارامترها
runComplete boolean

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

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

پارامترها
test TestIdentifier : تست را شناسایی می‌کند.

trace String : ردپای پشته از خرابی

آزمون پایان یافت 

public void testEnded (TestIdentifier test, 
                 testMetrics)

پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.

اگر testFailed(TestIdentifier, String) فراخوانی نشده باشد، این تست با موفقیت انجام شده است. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد تست منتشر شده باشد، برمی‌گرداند.

پارامترها
test TestIdentifier : تست را شناسایی می‌کند.

testMetrics : یک ERROR(/Map) از معیارهای منتشر شده در طول اجرای مورد آزمایشی توسط android.app.Instrumentation#sendStatus . ترتیب درج حفظ می‌شود مگر اینکه یک کلید مشابه را چندین بار منتشر کنید. توجه داشته باشید که کلیدهای استاندارد تعریف شده در IInstrumentationResultParser.StatusKeys از این Map فیلتر می‌شوند. Ddmlib ممکن است معیارهای آزمایشی اضافی تعریف شده در IInstrumentationResultParser.StatusKeys را اضافه کند.

تست ناموفق 

public void testFailed (TestIdentifier test, 
                String trace)

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

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

پارامترها
test TestIdentifier : تست را شناسایی می‌کند.

trace String : ردپای پشته از خرابی

آزمون نادیده گرفته شد 

public void testIgnored (TestIdentifier test)

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

پارامترها
test TestIdentifier : تست را شناسایی می‌کند.

تست اجرا شده 

public void testRunEnded (long elapsedTime, 
                 runMetrics)

پایان اجرای آزمایش را گزارش می‌دهد.

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

runMetrics : یک ERROR(/Map) از معیارهای منتشر شده در طول اجرای مورد آزمایشی توسط android.app.Instrumentation#addResults . ترتیب درج حفظ می‌شود مگر اینکه یک کلید مشابه را چندین بار منتشر کنید. توجه داشته باشید که کلیدهای استاندارد تعریف شده در IInstrumentationResultParser.StatusKeys از این Map فیلتر می‌شوند. Ddmlib ممکن است معیارهای آزمایشی اضافی تعریف شده در IInstrumentationResultParser.StatusKeys را اضافه کند.

تست اجرا ناموفق 

public void testRunFailed (String errorMessage)

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

پارامترها
errorMessage String : String دلیل عدم موفقیت در اجرا را توصیف می‌کند.

تست شروع شد 

public void testRunStarted (String runName, 
                int testCount)

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

پارامترها
runName String : نام اجرای آزمایشی

testCount int : تعداد کل تست‌ها در اجرای تست

testRunStopped 

public void testRunStopped (long elapsedTime)

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

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

تست شروع شد 

public void testStarted (TestIdentifier test)

شروع یک مورد آزمایشی (test case) منفرد را گزارش می‌دهد.

پارامترها
test TestIdentifier : تست را شناسایی می‌کند.