‪CollectingTestListener

public class CollectingTestListener
extends Object implements IDisableable, ILogSaverListener, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.CollectingTestListener

ITestInvocationListener שיאסוף את כל תוצאות הבדיקה.

למרות שמבני הנתונים שמשמשים באובייקט הזה הם thread-safe, צריך לקרוא לפונקציות ITestInvocationListener callback בסדר הנכון.

סיכום

‫constructors ציבוריים

CollectingTestListener()

‫methods ציבוריים

IBuildInfo getBuildInfo()

השיטה הזו הוצאה משימוש. אפשר לסמוך על IBuildInfo מ-getInvocationContext().

TestRunResult getCurrentRunResults()

הפונקציה מחזירה את התוצאות של הרצת הבדיקה הנוכחית.

int getExpectedTests()

הפונקציה מחזירה את מספר הבדיקות הצפוי.

IInvocationContext getInvocationContext()

החזרת הקשר של הקריאה לפונקציה שדווחה באמצעות invocationStarted(IInvocationContext)

List<TestRunResult> getMergedTestRunResults()

החזרת אוסף התוצאות הממוזג של כל ההרצות בניסיונות שונים.

IInvocationContext getModuleContextForRunResult(String testRunName)

מחזירה את IInvocationContext של המודול שמשויך לתוצאות.

MultiMap<String, LogFile> getModuleLogFiles()

הפונקציה מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ביומן שמשויך למודול

MultiMap<String, LogFile> getNonAssociatedLogFiles()

הפונקציה מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ולא משויך להרצת בדיקה או למודול.

int getNumAllFailedTestRuns()

הפונקציה מחזירה את המספר הכולל של הרצות בדיקה במצב כשל

int getNumAllFailedTests()

הפונקציה מחזירה את המספר הכולל של הבדיקות במצב של כשל (רק כשלים, כשלים בהנחות לא נספרים).

int getNumTestsInState(TestStatus status)

הפונקציה מחזירה את מספר הבדיקות במצב נתון בהרצה הזו.

int getNumTestsInState(TestResult.TestStatus ddmlibStatus)

לתאימות לסוג סטטוס ישן יותר

int getNumTotalTests()

הפונקציה מחזירה את המספר הכולל של הבדיקות שהושלמו בכל ההרצות.

IBuildInfo getPrimaryBuildInfo()

מחזירה את פרטי הגרסה העיקריים שדווחו באמצעות invocationStarted(IInvocationContext).

Collection<TestRunResult> getRunResults()

השיטה הזו הוצאה משימוש. שימוש ב-getMergedTestRunResults()

TestRunResult getTestRunAtAttempt(String testRunName, int attempt)

מחזירים את TestRunResult לניסיון אחד.

int getTestRunAttemptCount(String testRunName)

הפונקציה מחזירה את מספר הניסיונות של הרצת בדיקה עם שם נתון.

List<TestRunResult> getTestRunAttempts(String testRunName)

מקבל את כל הניסיונות של TestRunResult של הרצת בדיקה נתונה.

List<TestRunResult> getTestRunForAttempts(int attempt)

מקבל את כל התוצאות לניסיון נתון.

Collection<String> getTestRunNames()

מחזירה את כל השמות של כל הרצות הבדיקה.

boolean hasFailedTests()

הפונקציה מחזירה אם היו קריאות שבהן נכשלו בדיקות או הנחות.

boolean hasTestRunResultsForName(String testRunName)

הפונקציה מחזירה תשובה אם יש תוצאות לשם של ריצת בדיקה שצוין.

void invocationEnded(long elapsedTime)

הפונקציה מדווחת שההפעלה הסתיימה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.

void invocationFailed(Throwable cause)

הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.

void invocationSkipped(SkipReason reason)

דיווח על הפעלה שנדלגה

void invocationStarted(IInvocationContext context)

הפונקציה מחזירה את תחילת ההפעלה של הבדיקה.

boolean isDisabled()

הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (דילוג על ההגדרה ועל הניקוי).

void logAssociation(String dataName, LogFile logFile)

במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה testLogSaved(String,LogDataType,InputStreamSource,LogFile).

void setBuildInfo(IBuildInfo buildInfo)

השיטה הזו הוצאה משימוש. אין יותר צורך בבדיקה.

void setDisable(boolean isDisabled)

קובעת אם האובייקט צריך להיות מושבת.

void setMergeStrategy(MergeStrategy strategy)

מגדירה את ה-MergeStrategy שייעשה בו שימוש כשממזגים תוצאות.

void testAssumptionFailure(TestDescription test, String trace)

הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

void testAssumptionFailure(TestDescription test, FailureDescription failure)

הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

void testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

חלופה ל-testEnded(TestDescription,Map) שבה אפשר לציין את שעת הסיום ישירות.

void testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.

void testFailed(TestDescription test, FailureDescription failure)

הודעה על כשל במקרה בדיקה ספציפי.

void testFailed(TestDescription test, String trace)

הודעה על כשל במקרה בדיקה ספציפי.

void testIgnored(TestDescription test)

הפונקציה מופעלת כשבדיקה לא תופעל, בדרך כלל כי שיטת בדיקה מסומנת ב-org.junit.Ignore.

void testModuleEnded()

הפונקציה מדווחת על סיום של הרצת מודול.

void testModuleStarted(IInvocationContext moduleContext)

האירוע הזה מדווח על תחילת ההפעלה של מודול.

void testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)

דוחות על סיום הרצת הבדיקה.

void testRunFailed(FailureDescription failure)

הפעלת הבדיקה של הדוחות נכשלה בגלל כשל שמתואר ב-FailureDescription.

void testRunFailed(String errorMessage)

הפעלת הבדיקה של הדוחות נכשלה בגלל שגיאה חמורה.

void testRunStarted(String name, int numTests, int attemptNumber)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

void testRunStarted(String name, int numTests)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

void testRunStarted(String name, int numTests, int attemptNumber, long startTime)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

void testRunStopped(long elapsedTime)

הפעלת הבדיקה של הדוחות הופסקה לפני שהסתיימה בגלל בקשה של משתמש.

void testSkipped(TestDescription test, SkipReason reason)

הפונקציה מופעלת כשמדלגים על בדיקה ולא מבצעים אותה מסיבה שבדרך כלל לא צפויה.

void testStarted(TestDescription test, long startTime)

חלופה ל-testStarted(TestDescription) שבה מציינים גם את תאריך ההתחלה של הבדיקה, בשילוב עם testEnded(TestDescription,long,Map) למדידה מדויקת.

void testStarted(TestDescription test)

הפונקציה מדווחת על תחילת בדיקה של תרחיש בדיקה מסוים.

שיטות מוגנות

final void clearModuleLogFiles()

מאפשרת לנקות את קובץ המודול כדי שלא נצטרך לשמור אותו יותר מדי זמן.

final void clearResultsForName(String testRunName)

מאפשר לנקות את התוצאות של הרצה מסוימת.

final void clearTestRunResults()

מאפשר לנקות את כל תוצאות הרצת הבדיקה כדי שלא נשמור אותן יותר מדי זמן.

void setIsAggregrateMetrics(boolean aggregate)

החלפת המצב של האפשרות 'מטריקות מצטברות'

‫constructors ציבוריים

‪CollectingTestListener

public CollectingTestListener ()

‫methods ציבוריים

getBuildInfo

public IBuildInfo getBuildInfo ()

השיטה הזו הוצאה משימוש.
אפשר לסמוך על IBuildInfo מ-getInvocationContext().

מחזירה את פרטי ה-Build.

החזרות
IBuildInfo

getCurrentRunResults

public TestRunResult getCurrentRunResults ()

הפונקציה מחזירה את התוצאות של הרצת הבדיקה הנוכחית.

שימו לב שהתוצאות עשויות להיות חלקיות. מומלץ לבדוק את הערך של TestRunResult.isRunComplete() או של (@link TestRunResult#isRunFailure()} בהתאם לצורך לפני עיבוד התוצאות.

החזרות
TestRunResult ‫TestRunResult שמייצג נתונים שנאספו במהלך ההרצה האחרונה של הבדיקה

getExpectedTests

public int getExpectedTests ()

הפונקציה מחזירה את מספר הבדיקות הצפוי. יכול להיות שיהיה שונה מ-getNumTotalTests() אם חלק מהבדיקות לא הופעלו.

החזרות
int

getInvocationContext

public IInvocationContext getInvocationContext ()

החזרת הקשר של הקריאה לפונקציה שדווחה באמצעות invocationStarted(IInvocationContext)

החזרות
IInvocationContext

getMergedTestRunResults

public List<TestRunResult> getMergedTestRunResults ()

החזרת אוסף התוצאות הממוזג של כל ההרצות בניסיונות שונים.

אם יש כמה תוצאות, כל הרצת בדיקה תמוזג, והתוצאה האחרונה של הבדיקה תחליף את תוצאות הבדיקה של הרצות קודמות. הפעלות של בדיקות מסודרות לפי מספר הניסיון.

המדדים של אותו ניסיון ימוזגו על סמך ההעדפה שהוגדרה על ידי aggregate-metrics. המדדים הסופיים יהיו המדדים של הניסיון האחרון.

החזרות
List<TestRunResult>

getModuleContextForRunResult

public IInvocationContext getModuleContextForRunResult (String testRunName)

מחזירה את IInvocationContext של המודול שמשויך לתוצאות.

פרמטרים
testRunName ‫String: השם שניתן על ידי {testRunStarted(String,int).
החזרות
IInvocationContext הערך IInvocationContext של המודול עבור שם מסוים של הרצת בדיקה null אם אין תוצאות לשם הזה.

getModuleLogFiles

public MultiMap<String, LogFile> getModuleLogFiles ()

הפונקציה מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ביומן שמשויך למודול

החזרות
MultiMap<String, LogFile>

getNonAssociatedLogFiles

public MultiMap<String, LogFile> getNonAssociatedLogFiles ()

הפונקציה מחזירה עותק של המפה שמכילה את כל הקובץ שנרשם ולא משויך להרצת בדיקה או למודול.

החזרות
MultiMap<String, LogFile>

getNumAllFailedTestRuns

public int getNumAllFailedTestRuns ()

הפונקציה מחזירה את המספר הכולל של הרצות בדיקה במצב כשל

החזרות
int

getNumAllFailedTests

public int getNumAllFailedTests ()

הפונקציה מחזירה את המספר הכולל של הבדיקות במצב של כשל (רק כשלים, כשלים בהנחות לא נספרים).

החזרות
int

getNumTestsInState

public int getNumTestsInState (TestStatus status)

הפונקציה מחזירה את מספר הבדיקות במצב נתון בהרצה הזו.

פרמטרים
status TestStatus

החזרות
int

getNumTestsInState

public int getNumTestsInState (TestResult.TestStatus ddmlibStatus)

לתאימות לסוג סטטוס ישן יותר

פרמטרים
ddmlibStatus TestResult.TestStatus

החזרות
int

getNumTotalTests

public int getNumTotalTests ()

הפונקציה מחזירה את המספר הכולל של הבדיקות שהושלמו בכל ההרצות.

החזרות
int

getPrimaryBuildInfo

public IBuildInfo getPrimaryBuildInfo ()

מחזירה את פרטי הגרסה העיקריים שדווחו באמצעות invocationStarted(IInvocationContext). ה-build הראשי הוא ה-build שמוחזר על ידי ספק ה-build הראשון של התצורה הפועלת. הפונקציה מחזירה ערך null אם אין הקשר (אין בנייה למקרה הבדיקה).

החזרות
IBuildInfo

getRunResults

public Collection<TestRunResult> getRunResults ()

השיטה הזו הוצאה משימוש.
שימוש ב-getMergedTestRunResults()

מחזירה את התוצאות של כל הרצות הבדיקה.

החזרות
Collection<TestRunResult>

getTestRunAtAttempt

public TestRunResult getTestRunAtAttempt (String testRunName, 
                int attempt)

מחזירים את TestRunResult לניסיון אחד.

פרמטרים
testRunName ‫String: השם שניתן על ידי {testRunStarted(String,int).
attempt ‫int: מזהה הניסיון.
החזרות
TestRunResult הערך TestRunResult עבור השם שצוין ומזהה הניסיון או null אם הוא לא קיים.

getTestRunAttemptCount

public int getTestRunAttemptCount (String testRunName)

הפונקציה מחזירה את מספר הניסיונות של הרצת בדיקה עם שם נתון.

פרמטרים
testRunName ‫String: השם שניתן על ידי {testRunStarted(String,int).
החזרות
int

getTestRunAttempts

public List<TestRunResult> getTestRunAttempts (String testRunName)

מקבל את כל הניסיונות של TestRunResult של הרצת בדיקה נתונה.

פרמטרים
testRunName ‫String: השם שניתן על ידי {testRunStarted(String,int).
החזרות
List<TestRunResult> כל TestRunResult עבור הרצת בדיקה נתונה, מסודרים לפי ניסיונות.

getTestRunForAttempts

public List<TestRunResult> getTestRunForAttempts (int attempt)

מקבל את כל התוצאות לניסיון נתון.

פרמטרים
attempt ‫int: הניסיון שאנחנו רוצים לקבל לגביו תוצאות.
החזרות
List<TestRunResult> כל TestRunResult בניסיון נתון.

getTestRunNames

public Collection<String> getTestRunNames ()

מחזירה את כל השמות של כל הרצות הבדיקה.

יכול להיות שהרצת הבדיקות האלה בוצעה כמה פעמים עם ניסיונות שונים.

החזרות
Collection<String>

hasFailedTests

public boolean hasFailedTests ()

הפונקציה מחזירה אם היו קריאות שבהן נכשלו בדיקות או הנחות.

החזרות
boolean

hasTestRunResultsForName

public boolean hasTestRunResultsForName (String testRunName)

הפונקציה מחזירה תשובה אם יש תוצאות לשם של ריצת בדיקה שצוין.

פרמטרים
testRunName ‫String: השם שניתן על ידי {testRunStarted(String,int).
החזרות
boolean

invocationEnded

public void invocationEnded (long elapsedTime)

הפונקציה מדווחת שההפעלה הסתיימה, בין אם בהצלחה ובין אם בגלל שגיאה כלשהי.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
elapsedTime ‫long: הזמן שחלף מאז ההפעלה במילישניות

invocationFailed

public void invocationFailed (Throwable cause)

הפונקציה מחזירה קריאה לא שלמה בגלל תנאי שגיאה מסוים.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
cause ‫Throwable: הסיבה לכישלון Throwable

invocationSkipped

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה שנדלגה

פרמטרים
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

הפונקציה מחזירה את תחילת ההפעלה של הבדיקה.

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation. כדי לתמוך בדיווח ממספר מכשירים, צריך להגדיר מחדש את השיטה הזו.

פרמטרים
context ‫IInvocationContext: מידע על הקריאה

isDisabled

public boolean isDisabled ()

הפונקציה מחזירה את הערך True אם האובייקט כולו מושבת (דילוג על ההגדרה ועל הניקוי). אחרת, הפלט הוא False.

החזרות
boolean

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

במקרים מסוימים, צריך לשייך את היומן באופן חזק לתרחישי בדיקה, אבל אי אפשר לעשות את זה באמצעות הקריאה החוזרת הישירה testLogSaved(String,LogDataType,InputStreamSource,LogFile). לכן, פונקציית הקריאה החוזרת הזו מאפשרת לספק שיוך חזק באופן מפורש.

פרמטרים
dataName String: שם הנתונים
logFile ‫LogFile: LogFile שנרשם קודם וצריך להיות משויך לתרחיש הבדיקה.

setBuildInfo

public void setBuildInfo (IBuildInfo buildInfo)

השיטה הזו הוצאה משימוש.
כבר לא צריך את זה לבדיקה.

הגדרת פרטי הגרסה. היא מיועדת לבדיקה בלבד.

פרמטרים
buildInfo IBuildInfo

setDisable

public void setDisable (boolean isDisabled)

קובעת אם האובייקט צריך להיות מושבת. ההגדרה Disabled (מושבת) פירושה שצריך לדלג על שלבי ההגדרה וההסרה. אפשר להשתמש בה כדי להשבית אובייקט כברירת מחדל בבונה ברירת המחדל.

פרמטרים
isDisabled ‫boolean: המצב שאליו צריך להעביר את האובייקט.

setMergeStrategy

public void setMergeStrategy (MergeStrategy strategy)

מגדירה את ה-MergeStrategy שייעשה בו שימוש כשממזגים תוצאות.

פרמטרים
strategy MergeStrategy

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
trace ‫String: דוח קריסות של הכשל

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

הפונקציה מופעלת כשבדיקה אטומית מסמנת שהיא מניחה תנאי שהוא שקר

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
failure ‫FailureDescription: FailureDescription תיאור הכשל וההקשר שלו.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

חלופה ל-testEnded(TestDescription,Map) שבה אפשר לציין את שעת הסיום ישירות. אפשר לשלב עם testStarted(TestDescription,long) כדי לקבל מדידה מדויקת.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
endTime ‫long: השעה שבה הבדיקה הסתיימה, נמדדת באמצעות System.currentTimeMillis()
testMetrics HashMap: Map של המדדים שנפלטים

testEnded

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

הדוח מציג את סיום ההרצה של תרחיש בדיקה ספציפי.

אם לא בוצעה קריאה לפונקציה testFailed(TestDescription, FailureDescription), הבדיקה הזו עברה. הפונקציה מחזירה גם מדדים של מפתח/ערך שאולי הופקו במהלך ההפעלה של תרחיש הבדיקה.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
testMetrics HashMap: Map של המדדים שנפלטים

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

הודעה על כשל במקרה בדיקה ספציפי.

הפונקציה הזו תופעל בין testStarted לבין testEnded.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
failure ‫FailureDescription: FailureDescription תיאור הכשל וההקשר שלו.

testFailed

public void testFailed (TestDescription test, 
                String trace)

הודעה על כשל במקרה בדיקה ספציפי.

הפונקציה הזו תופעל בין testStarted לבין testEnded.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
trace ‫String: דוח קריסות של הכשל

testIgnored

public void testIgnored (TestDescription test)

הפונקציה מופעלת כשבדיקה לא תופעל, בדרך כלל כי שיטת בדיקה מסומנת ב-org.junit.Ignore.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה

testModuleEnded

public void testModuleEnded ()

הפונקציה מדווחת על סיום של הרצת מודול.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

האירוע הזה מדווח על תחילת ההפעלה של מודול. הקריאה החוזרת הזו משויכת ל-testModuleEnded() והיא אופציונלית ברצף. הוא נמצא בשימוש רק במהלך הרצה שמשתמשת במודולים: suite based runners.

פרמטרים
moduleContext ‫IInvocationContext: IInvocationContext של המודול.

testRunEnded

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

דוחות על סיום הרצת הבדיקה. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

פרמטרים
elapsedTime ‫long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה
runMetrics ‫HashMap: צמדי מפתח/ערך שמדווחים בסוף הרצת בדיקה עם 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 name, 
                int numTests, 
                int attemptNumber)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

פרמטרים
name ‫String: השם של הרצת הבדיקה
numTests ‫int: המספר הכולל של הבדיקות בהרצת הבדיקה
attemptNumber ‫int: מספר ההזמנה, שמזהה את הניסיונות השונים של אותו runName שמופעל מספר פעמים. הערך של attemptNumber מתחיל מ-0 וצריך לעלות בכל פעם שמתבצעת הרצה חדשה. לדוגמה, אם מבצעים ניסיון חוזר של בדיקה 3 פעמים, צריכות להיות 4 הרצות בסך הכול באותו runName, והערך של attemptNumber יהיה מ-0 עד 3.

testRunStarted

public void testRunStarted (String name, 
                int numTests)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

פרמטרים
name ‫String: השם של הרצת הבדיקה
numTests ‫int: המספר הכולל של הבדיקות בהרצת הבדיקה

testRunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

הפונקציה מדווחת על התחלה של הרצת בדיקה.

פרמטרים
name ‫String: השם של הרצת הבדיקה
numTests ‫int: המספר הכולל של הבדיקות בהרצת הבדיקה
attemptNumber ‫int: מספר ההזמנה, שמזהה את הניסיונות השונים של אותו runName שמופעל מספר פעמים. הערך של attemptNumber מתחיל מ-0 וצריך לעלות בכל פעם שמבוצעת ריצה חדשה. לדוגמה, אם מבצעים 3 ניסיונות חוזרים של בדיקה, צריכות להיות 4 ריצות בסך הכול עם אותו runName, והערך של attemptNumber יהיה מ-0 עד 3.
startTime ‫long: השעה שבה ההפעלה התחילה, נמדדת באמצעות System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

הפעלת הבדיקה של הדוחות הופסקה לפני שהסתיימה בגלל בקשה של משתמש.

TODO: currently unused, consider removing

פרמטרים
elapsedTime ‫long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

הפונקציה מופעלת כשמדלגים על בדיקה ולא מבצעים אותה מסיבה שבדרך כלל לא צפויה. המערכת תנסה להריץ מחדש את הבדיקות האלה כדי לנסות לבצע אותן בצורה תקינה.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
reason SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

חלופה ל-testStarted(TestDescription) שבה מציינים גם את תאריך ההתחלה של הבדיקה, בשילוב עם testEnded(TestDescription,long,Map) למדידה מדויקת.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
startTime ‫long: השעה שבה הבדיקה התחילה, נמדדת באמצעות System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

הפונקציה מדווחת על תחילת בדיקה של תרחיש בדיקה מסוים. בממשק הישן, מומלץ להשתמש ב-testStarted(TestDescription) בכל הזדמנות.

פרמטרים
test ‫TestDescription: מזהה את הבדיקה

שיטות מוגנות

clearModuleLogFiles

protected final void clearModuleLogFiles ()

מאפשרת לנקות את קובץ המודול כדי שלא נצטרך לשמור אותו יותר מדי זמן.

clearResultsForName

protected final void clearResultsForName (String testRunName)

מאפשר לנקות את התוצאות של הרצה מסוימת. צריך להשתמש בה רק במקרים מסוימים, כמו במצטבר של התוצאות.

פרמטרים
testRunName String

clearTestRunResults

protected final void clearTestRunResults ()

מאפשר לנקות את כל תוצאות הרצת הבדיקה כדי שלא נשמור אותן יותר מדי זמן.

setIsAggregrateMetrics

protected void setIsAggregrateMetrics (boolean aggregate)

החלפת המצב של האפשרות 'מטריקות מצטברות'

פרמטרים
aggregate boolean