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, Map<String, String> testMetrics)

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

void testFailed(TestIdentifier test, String trace)

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

void testIgnored(TestIdentifier test)

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

void testRunEnded(long elapsedTime, Map<String, String> runMetrics)

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

void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int numTests)

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

void testRunStopped(long elapsedTime)

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

void testStarted(TestIdentifier test)

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

שיטות מוגנות

Map<String, String> getPropertiesAttributes()

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

File getResultFile(File reportDir)

יוצרת 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, 
                Map<String, String> testMetrics)

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

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

פרמטרים
test ‫TestIdentifier: מזהה את הבדיקה
testMetrics ‫Map: 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, 
                Map<String, String> runMetrics)

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

פרמטרים
elapsedTime ‫long: הזמן שחלף שדווח על ידי המכשיר, באלפיות השנייה
runMetrics ‫Map: 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 Map<String, String> getPropertiesAttributes ()

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

החזרות
Map<String, String>

getResultFile

protected File getResultFile (File reportDir)

יוצרת File שבו ייווצר הדוח.

פרמטרים
reportDir ‫File: ספריית הבסיס של הדוח.
החזרות
File קובץ
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

getTestName

protected String getTestName (TestIdentifier testId)

פרמטרים
testId TestIdentifier

החזרות
String

getTestSuiteName

protected String getTestSuiteName ()

החזרות
String