XmlTestRunListener

public class XmlTestRunListener
extends Object implements ITestRunListener

java.lang.Object
   ↳ com.android.ddmlib.testrunner.XmlTestRunListener

כותב תוצאות של JUnit לקובצי XML בפורמט שתואם ל-XMLJUnitResultFormatter של Ant.

יוצר קובץ XML נפרד לכל הרצת בדיקה.

סיכום

‫constructors ציבוריים

XmlTestRunListener()

‫methods ציבוריים

void addSystemError(String systemError)

הוספת הודעת שגיאת מערכת.

TestRunResult getRunResult()

הפונקציה מחזירה את הערך TestRunResult

String getSystemError()

מחזירה את הודעת שגיאת המערכת שתיכתב בקובץ ה-XML ברכיב system-err.

void setHostName(String hostName)
void setReportDir(File file)

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

void testAssumptionFailure(TestIdentifier test, String trace)

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

void testEnded(TestIdentifier test, testMetrics)

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

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

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

void testRunStopped(long elapsedTime)

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

void testStarted(TestIdentifier test)

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

שיטות מוגנות

getPropertiesAttributes()

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

File getResultFile(File reportDir)

יוצרת ERROR(/File) שבו ייווצר הדוח.

String getTestName(TestIdentifier testId)
String getTestSuiteName()

Constructors ציבוריים

XmlTestRunListener

public XmlTestRunListener ()

‫methods ציבוריים

addSystemError

public void addSystemError (String systemError)

הוספת הודעת שגיאת מערכת.

פרמטרים
systemError String

getRunResult

public TestRunResult getRunResult ()

הפונקציה מחזירה את הערך TestRunResult

החזרות
TestRunResult תוצאות הרצת הבדיקה.

getSystemError

public String getSystemError ()

מחזירה את הודעת שגיאת המערכת שתיכתב בקובץ ה-XML ברכיב system-err. אם הפונקציה מחזירה מחרוזת ריקה, הרכיב לא נוצר.

החזרות
String

setHostName

public void setHostName (String hostName)

פרמטרים
hostName String

setReportDir

public void setReportDir (File file)

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

פרמטרים
file File

testAssumptionFailure

public void testAssumptionFailure (TestIdentifier test, 
                String trace)

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

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

testEnded

public void testEnded (TestIdentifier test, 
                 testMetrics)

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

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

פרמטרים
test ‫TestIdentifier: מזהה את הבדיקה
testMetrics ‫: ERROR(/Map) של המדדים שמופקים במהלך ההרצה של תרחיש הבדיקה על ידי android.app.Instrumentation#sendStatus. סדר ההוספה נשמר אלא אם מעבירים את אותו מפתח כמה פעמים. חשוב לשים לב שמפתחות רגילים שמוגדרים ב-IInstrumentationResultParser.StatusKeys מסוננים מהמפה הזו. יכול להיות שספריית Ddmlib תוסיף מדדים נוספים לבדיקה שמוגדרים ב-IInstrumentationResultParser.StatusKeys.

testFailed

public void testFailed (TestIdentifier test, 
                String trace)

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

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

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

testIgnored

public void testIgnored (TestIdentifier test)

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

פרמטרים
elapsedTime ‫long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה
runMetrics ‫: ERROR(/Map) של המדדים שמופקים במהלך ההרצה של תרחיש הבדיקה על ידי android.app.Instrumentation#addResults. סדר ההוספה נשמר אלא אם מעבירים את אותו מפתח כמה פעמים. חשוב לשים לב שמפתחות רגילים שמוגדרים ב-IInstrumentationResultParser.StatusKeys מסוננים מהמפה הזו. יכול להיות שספריית Ddmlib תוסיף מדדים נוספים לבדיקה שמוגדרים ב-IInstrumentationResultParser.StatusKeys.

testRunFailed

public void testRunFailed (String errorMessage)

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

פרמטרים
errorMessage ‫String: String, תיאור הסיבה לכישלון ההרצה.

testRunStarted

public void testRunStarted (String runName, 
                int numTests)

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

testStarted

public void testStarted (TestIdentifier test)

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

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

שיטות מוגנות

getPropertiesAttributes

protected  getPropertiesAttributes ()

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

החזרות

getResultFile

protected File getResultFile (File reportDir)

יוצרת ERROR(/File) שבו ייווצר הדוח.

פרמטרים
reportDir ‫File: ספריית הבסיס של הדוח.
החזרות
File קובץ
זריקות
IOException

getTestName

protected String getTestName (TestIdentifier testId)

פרמטרים
testId TestIdentifier

החזרות
String

getTestSuiteName

protected String getTestSuiteName ()

החזרות
String