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

public class TestRunResult
extends Object

شیء جاوا
↳ com.android.tradefed.result.TestRunResult

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

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

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

خلاصه

ثابت‌ها

String ERROR_DIVIDER

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

TestRunResult ()

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

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

void addTestResult ( TestDescription test, TestResult testResult)
getCompletedTests ()

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

long getElapsedTime ()

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

int getExpectedTestCount ()

تعداد موارد آزمایشی که TestRunResult انتظار دارد داشته باشد را برمی‌گرداند.

getFailedTests ()

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

String getName ()
int getNumAllFailedTests ()

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

int getNumCompleteTests ()

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

int getNumTests ()

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

int getNumTestsInState ( TestStatus status)

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

int getNumTestsInState ( TestResult.TestStatus ddmlibStatus)

برای سازگاری با وضعیت قدیمی‌تر.

getPassedTests ()

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

FailureDescription getRunFailureDescription ()

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

String getRunFailureMessage ()

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

MultiMap <String, LogFile > getRunLoggedFiles ()

یک کپی از نقشه حاوی تمام فایل‌های ثبت‌شده مرتبط با آن مورد آزمایشی را برمی‌گرداند.

getRunMetrics ()
getRunProtoMetrics ()
long getStartTime ()

زمان شروع اولین فراخوانی testRunStart را برمی‌گرداند.

getTestEntriesInState ( statuses)

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

getTestResults ()

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

getTestsInState ( statuses)

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

getTestsResultsInState ( TestStatus status)

تمام TestResult در یک حالت خاص برمی‌گرداند.

String getTextSummary ()

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

boolean hasFailedTests ()
boolean isRunComplete ()
boolean isRunFailure ()
static TestRunResult merge ( testRunResults)
static TestRunResult merge ( testRunResults, MergeStrategy strategy)

ادغام چندین TestRunResult با نام testRun یکسان.

void resetRunFailure ()

وضعیت خطای اجرا را مجدداً تنظیم کنید.

void setAggregateMetrics (boolean metricAggregation)
void setRunComplete (boolean runComplete)
void testAssumptionFailure ( TestDescription test, String trace)
void testAssumptionFailure ( TestDescription test, FailureDescription failure)
void testEnded ( TestDescription test, long endTime, testMetrics)
void testEnded ( TestDescription test, testMetrics)
void testFailed ( TestDescription test, FailureDescription failure)
void testFailed ( TestDescription test, String trace)
void testIgnored ( TestDescription test)
void testLogSaved (String dataName, LogFile logFile)

اطلاعات مربوط به فایلی که ثبت می‌شود، ذخیره شده و به نمونه آزمایشی یا اجرای آزمایشی در حال انجام مرتبط می‌شود.

void testRunEnded (long elapsedTime, runMetrics)
void testRunFailed ( FailureDescription failureDescription)
void testRunFailed (String errorMessage)
void testRunStarted (String runName, int testCount, long startTime)

اطلاع دهید که یک آزمایش آغاز شده است.

void testRunStarted (String runName, int testCount)

اطلاع دهید که یک آزمایش آغاز شده است.

void testRunStopped (long elapsedTime)
void testSkipped ( TestDescription test, SkipReason reason)
void testStarted ( TestDescription test, long startTime)
void testStarted ( TestDescription test)

ثابت‌ها

جداکننده خطا 

public static final String ERROR_DIVIDER

مقدار ثابت: "====خطای بعدی===="

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

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

public TestRunResult ()

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

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

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

public void addTestResult (TestDescription test, 
                TestResult testResult)

پارامترها
test TestDescription

testResult TestResult

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

public  getCompletedTests ()

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

بازگشت‌ها

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

public long getElapsedTime ()

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

بازگشت‌ها
long

getExpectedTestCount 

public int getExpectedTestCount ()

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

بازگشت‌ها
int

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

public  getFailedTests ()

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

بازگشت‌ها

دریافت نام 

public String getName ()

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

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

public int getNumAllFailedTests ()

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

بازگشت‌ها
int

getNumCompleteTests 

public int getNumCompleteTests ()

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

بازگشت‌ها
int

getNumTests 

public int getNumTests ()

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

بازگشت‌ها
int

دریافتNumTestsInState 

public int getNumTestsInState (TestStatus status)

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

پارامترها
status TestStatus

بازگشت‌ها
int

دریافتNumTestsInState 

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

برای سازگاری با وضعیت‌های قدیمی‌تر، به جای آن از getNumTestsInState(com.android.tradefed.result.TestStatus) استفاده کنید.

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

بازگشت‌ها
int

دریافت آزمون‌های پذیرفته‌شده 

public  getPassedTests ()

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

بازگشت‌ها

توضیحات getRunFailure 

public FailureDescription getRunFailureDescription ()

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

بازگشت‌ها
FailureDescription

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

public String getRunFailureMessage ()

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

بازگشت‌ها
String

فایل‌های ثبت‌شده‌ی اجراشده 

public MultiMap<String, LogFile> getRunLoggedFiles ()

یک کپی از نقشه حاوی تمام فایل‌های ثبت‌شده مرتبط با آن مورد آزمایشی را برمی‌گرداند.

بازگشت‌ها
MultiMap <String, LogFile >

getRunMetrics 

public  getRunMetrics ()

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

getRunProtoMetrics 

public  getRunProtoMetrics ()

بازگشت‌ها
ERROR(/Map) در معیارهای اجرای آزمایشی با قالب اولیه جدید.

زمان شروع را دریافت کنید 

public long getStartTime ()

زمان شروع اولین فراخوانی testRunStart را برمی‌گرداند.

بازگشت‌ها
long

getTestEntriesInState 

public  getTestEntriesInState ( statuses)

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

پارامترها
statuses

بازگشت‌ها

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

public  getTestResults ()

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

بازگشت‌ها

دریافت تست‌ها در حالت عادی 

public  getTestsInState ( statuses)

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

پارامترها
statuses

بازگشت‌ها

دریافت نتایج آزمون‌ها در حالت عادی 

public  getTestsResultsInState (TestStatus status)

تمام TestResult در یک حالت خاص برمی‌گرداند.

پارامترها
status TestStatus

بازگشت‌ها

خلاصه متن 

public String getTextSummary ()

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

بازگشت‌ها
String

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

public boolean hasFailedTests ()

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

isRunComplete 

public boolean isRunComplete ()

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

isRunFailure 

public boolean isRunFailure ()

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

ادغام 

public static TestRunResult merge ( testRunResults)

پارامترها
testRunResults

بازگشت‌ها
TestRunResult

همچنین ببینید:

ادغام 

public static TestRunResult merge ( testRunResults, 
                MergeStrategy strategy)

ادغام چندین TestRunResult با نام testRun یکسان. اگر یک مورد آزمایشی در چندین TestRunResult نمایش داده شود اما نتایج متفاوتی داشته باشد (مثلاً "boottest-device" سه بار با نتیجه FAIL-FAIL-PASS اجرا شود)، تمام ردپاهای پشته را از اجراهای FAILED به هم پیوند می‌دهیم و به نتیجه نهایی اجرا برای وضعیت، معیارها، فایل‌های لاگ، زمان شروع/پایان اعتماد می‌کنیم.

پارامترها
testRunResults : لیستی از TestRunResult برای ادغام.

strategy MergeStrategy : استراتژی ادغام اتخاذ شده برای ادغام نتایج.

بازگشت‌ها
TestRunResult TestRunResult نهایی حاوی داده‌های ادغام‌شده از testRunResults.

resetRunFailure 

public void resetRunFailure ()

وضعیت خطای اجرا را مجدداً تنظیم کنید.

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

setAggregateMetrics 

public void setAggregateMetrics (boolean metricAggregation)

پارامترها
metricAggregation boolean

setRunComplete 

public void setRunComplete (boolean runComplete)

پارامترها
runComplete boolean

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

public void testAssumptionFailure (TestDescription test, 
                String trace)

پارامترها
test TestDescription

trace String

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

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

پارامترها
test TestDescription

failure FailureDescription

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

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

پارامترها
test TestDescription

endTime long

testMetrics

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

public void testEnded (TestDescription test, 
                 testMetrics)

پارامترها
test TestDescription

testMetrics

تست ناموفق 

public void testFailed (TestDescription test, 
                FailureDescription failure)

پارامترها
test TestDescription

failure FailureDescription

تست ناموفق 

public void testFailed (TestDescription test, 
                String trace)

پارامترها
test TestDescription

trace String

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

public void testIgnored (TestDescription test)

پارامترها
test TestDescription

testLogذخیره شده 

public void testLogSaved (String dataName, 
                LogFile logFile)

اطلاعات مربوط به فایلی که ثبت می‌شود، ذخیره شده و به نمونه آزمایشی یا اجرای آزمایشی در حال انجام مرتبط می‌شود.

پارامترها
dataName String : نامی که به داده‌ها ارجاع می‌دهد.

logFile LogFile : شیء LogFile که نشان دهنده محل ذخیره شیء و اطلاعات مربوط به آن است.

تست اجرا شده 

public void testRunEnded (long elapsedTime, 
                 runMetrics)

پارامترها
elapsedTime long

runMetrics

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

public void testRunFailed (FailureDescription failureDescription)

پارامترها
failureDescription FailureDescription

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

public void testRunFailed (String errorMessage)

پارامترها
errorMessage String

تست شروع شد 

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

اطلاع دهید که یک آزمایش آغاز شده است.

پارامترها
runName String : نامی که برای ردیابی به اجرای آزمایشی اختصاص داده شده است.

testCount int : تعداد موارد آزمون مورد انتظار مرتبط با اجرای آزمون.

startTime long

تست شروع شد 

public void testRunStarted (String runName, 
                int testCount)

اطلاع دهید که یک آزمایش آغاز شده است.

پارامترها
runName String : نامی که برای ردیابی به اجرای آزمایشی اختصاص داده شده است.

testCount int : تعداد موارد آزمون مورد انتظار مرتبط با اجرای آزمون.

testRunStopped 

public void testRunStopped (long elapsedTime)

پارامترها
elapsedTime long

آزمون رد شد 

public void testSkipped (TestDescription test, 
                SkipReason reason)

پارامترها
test TestDescription

reason SkipReason

تست شروع شد 

public void testStarted (TestDescription test, 
                long startTime)

پارامترها
test TestDescription

startTime long

تست شروع شد 

public void testStarted (TestDescription test)

پارامترها
test TestDescription