דף זה תורגם על ידי Cloud Translation API.

InvocationToJUnitresultsForwarder

public class InvocationToJUnitResultForwarder
extends Object implements ITestInvocationListener

JavaScript.lang.Object
↳	com.android.tradefed.result.InvocationToJUnitUnitForwarder

מחלקות משנה ישירות ידועות

TextresultsReporter (דיווח על תוצאות טקסט)

TextresultsReporter (דיווח על תוצאות טקסט) כתבי תוצאות בדיקה שמעבירים את התוצאות למדפסת תוצאות הטקסט של JUnit.

כיתה שמקשיבה לאירועים של ITestInvocationListener ומעבירה אותם TestListener.

סיכום

בנאים ציבוריים
`InvocationToJUnitResultForwarder(TestListener junitListener)`

שיטות ציבוריות
`TestSummary`	`getSummary()` מאפשר ל-InvocationListener להחזיר סיכום.
`void`	`invocationEnded(long elapsedTime)` דיווחים שההפעלה הסתיימה, בין אם בהצלחה או בגלל שגיאה כלשהי תנאי.
`void`	`invocationFailed(Throwable cause)` מדווח על הפעלה שלא הושלמה עקב מצב שגיאה כלשהו.
`void`	`invocationStarted(IInvocationContext context)` מדווח על התחלת ההפעלה של הבדיקה.
`void`	`testAssumptionFailure(TestDescription testId, String trace)` מופעלת כשבדיקה אטומית מסמנת שהיא מניחה שהתנאי לא נכון
`void`	`testEnded(TestDescription test, testMetrics)` מדווח על סיום ההפעלה של מקרה בדיקה ספציפי.
`void`	`testFailed(TestDescription testId, String trace)` מדווח על כשל במקרה בדיקה ספציפי.
`void`	`testIgnored(TestDescription test)` נשלחת קריאה כאשר בדיקה לא תבוצע, בדרך כלל מפני שלשיטת בדיקה יש הערות עם org.junit.ignore.
`void`	`testLog(String dataName, LogDataType logData, InputStreamSource dataStream)` מספקת את נתוני היומן או נתוני ניפוי הבאגים המשויכים מהפעלת הבדיקה.
`void`	`testRunEnded(long elapsedTime, runMetrics)` הדוחות הסתיימו של הרצת הבדיקה.
`void`	`testRunFailed(String errorMessage)` הפעלת בדיקת הדוחות נכשלה עקב שגיאה חמורה.
`void`	`testRunStarted(String runName, int testCount)` מדווח על התחלה של הרצת בדיקה.
`void`	`testRunStopped(long elapsedTime)` הרצת בדיקת הדוחות הופסקה לפני שהסתיימה עקב בקשה של משתמש.
`void`	`testStarted(TestDescription test)` מדווח על ההתחלה של מקרה בדיקה ספציפי.

שיטות מוגנות
`TestListener`	`getJUnitListener()`

בנאים ציבוריים

InvocationToJUnitresultsForwarder

public InvocationToJUnitResultForwarder (TestListener junitListener)

פרמטרים
`junitListener`	`TestListener`

שיטות ציבוריות

getSummary

public TestSummary getSummary ()

מאפשר ל-InvocationListener להחזיר סיכום.

החזרות
`TestSummary`	`TestSummary` שמסכם את הריצה, או null

ההפעלה הסתיימה

public void invocationEnded (long elapsedTime)

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

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

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

ההפעלה נכשלה

public void invocationFailed (Throwable cause)

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

תתבצע קריאה אוטומטית על ידי framework של TradeFederation.

פרמטרים
`cause`	`Throwable`: הסיבה `Throwable` לכשל

ההפעלה התחילה

public void invocationStarted (IInvocationContext context)

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

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

פרמטרים
`context`	`IInvocationContext`: מידע על ההפעלה

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

הבדיקה הסתיימה

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

פרמטרים
`test`	`TestDescription`: מזהה את הבדיקה
`testMetrics`	: `ERROR(/Map)` מהמדדים שנפלטו

הבדיקה נכשלה

public void testFailed (TestDescription testId, 
                String trace)

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

הקריאה תתבצע בין testStarted ל-testEnded.

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

התעלמות מבדיקה

public void testIgnored (TestDescription test)

נשלחת קריאה כאשר בדיקה לא תבוצע, בדרך כלל מפני שלשיטת בדיקה יש הערות עם org.junit.ignore.

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

יומן בדיקה

public void testLog (String dataName, 
                LogDataType logData, 
                InputStreamSource dataStream)

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

חובה להתקשר לפני ERROR(/ITestInvocationListener#invocationFailed(Throwable)) או ERROR(/ITestInvocationListener#invocationEnded(long))

מערכת TradeFederation תקרא באופן אוטומטי לשיטה הזו, ותספק את יומן המארח ואם רלוונטי, את ה-Logcat של המכשיר.

פרמטרים
`dataName`	`String`: שם תיאורי של הנתונים `String`. לדוגמה 'device_logcat'. הערה dataName לא יכול להיות ייחודי בכל הפעלה. כלומר, הטמעות צריכות להיות מסוגלות לטפל כמה קריאות עם אותו dataName
`logData`	`LogDataType`: ה-`LogDataType` של הנתונים
`dataStream`	`InputStreamSource`: ה-`InputStreamSource` של הנתונים. מטמיעים צריכים להתקשר CreateInputStream כדי להתחיל לקרוא את הנתונים, ולוודא לסגור את StreamStream לאחר השלמת הפעולה. המתקשרים צריכים לוודא שמקור הנתונים יישאר קיימים ונגישים עד לסיום שיטת testLog.

הבדיקה הסתיימה

public void testRunEnded (long elapsedTime, 
                 runMetrics)

הדוחות הסתיימו של הרצת הבדיקה. FIXME: אנחנו לא יכולים ליצור שתי מפות<> עם סוגים שונים, כאן צריך להשתמש ב-HashMap.

פרמטרים
`elapsedTime`	`long`: דיווח על הזמן שחלף במכשיר, באלפיות השנייה
`runMetrics`	: צמדי מפתח/ערך מדווחים בסיום הרצת בדיקה עם `Metric`.

הבדיקה נכשלה

public void testRunFailed (String errorMessage)

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

פרמטרים
`errorMessage`	`String`: `String` מתארת את הסיבה לכשל בהפעלה.

בדיקת ההרצה

public void testRunStarted (String runName, 
                int testCount)

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

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

TestRunSStop

public void testRunStopped (long elapsedTime)

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

TODO: לא בשימוש כרגע, כדאי להסיר

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

הבדיקה התחילה

public void testStarted (TestDescription test)

מדווח על ההתחלה של מקרה בדיקה ספציפי. בממשק ישן, צריך להשתמש ב-testStarted(com.android.tradefed.result.TestDescription) כשהדבר אפשרי.

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

שיטות מוגנות

getJUnitListener

protected TestListener getJUnitListener ()

החזרות
`TestListener`