ResultReporter

public class ResultReporter
extends Object implements IConfigurationReceiver, ILogSaverListener, ISupportGranularResults, ITestSummaryListener

java.lang.Object
   ↳ com.google.android.tradefed.result.teststorage.ResultReporter

סיכום

כיתות במבנה היררכי

class ResultReporter.ListBuilder<T>

 

ערכים קבועים

String DEFAULT_BUILDPROVIDER

String EXPERIMENTAL

String SYSTEM_CHECKER

String TRADEFED

Constructors ציבוריים

ResultReporter()

‫methods ציבוריים

void enableFilterProperty(boolean enableFilterProperty)
IConfiguration getConfiguration()
TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

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

void invocationStarted(IInvocationContext context)

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

void logAssociation(String dataName, LogFile log)

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

void putEarlySummary( summaries)

הפונקציה מעבירה ERROR(/List) של TestSummarys שאינם null, שיכול להיות שהוחזרו מכל ITestInvocationListeners שנוצרו כמופע כחלק מההגדרה.

void setConfiguration(IConfiguration configuration)

הוספת IConfiguration בשימוש.

void setLogSaver(ILogSaver logSaver)

מגדירים את ILogSaver כדי לאפשר למטמיע לשמור קבצים.

boolean supportGranularResults()

הפונקציה מחזירה את הערך True אם הדוח תומך בתוצאות מפורטות, אחרת היא מחזירה את הערך False.

void testAssumptionFailure(TestDescription test, String trace)

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

void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

void testEnded(TestDescription test, long endTime, testMetrics)

חלופה ל-ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) שבה אפשר לציין את שעת הסיום ישירות.

void testEnded(TestDescription test, metrics)

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

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 elapsedTimeMillis, runMetrics)

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

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String errorMessage)

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

void testRunStarted(String runName, int testCount, int attemptNumber)

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

void testRunStarted(String runName, int testCount)

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

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

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

void testSkipped(TestDescription test, SkipReason reason)

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

void testStarted(TestDescription test, long startTime)

חלופה ל-testStarted(com.android.tradefed.result.TestDescription) שבה מציינים גם מתי הבדיקה התחילה, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) למדידה מדויקת.

void testStarted(TestDescription test)

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

שיטות מוגנות

ITestStorageClient createTestStorageClient(IInvocationContext context)
String getVersion()

ערכים קבועים

DEFAULT_BUILDPROVIDER

public static final String DEFAULT_BUILDPROVIDER

ערך קבוע: ‎"androidbuild"‎

ניסיוני

public static final String EXPERIMENTAL

ערך קבוע: "experimental"

SYSTEM_CHECKER

public static final String SYSTEM_CHECKER

ערך קבוע: "system_checker"

TRADEFED

public static final String TRADEFED

ערך קבוע: tradefed

Constructors ציבוריים

ResultReporter

public ResultReporter ()

‫methods ציבוריים

enableFilterProperty

public void enableFilterProperty (boolean enableFilterProperty)

פרמטרים
enableFilterProperty boolean

getConfiguration

public IConfiguration getConfiguration ()

החזרות
IConfiguration

getSummary

public TestSummary getSummary ()

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

החזרות
TestSummary TestSummary סיכום של הריצה, או ערך null

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

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

פרמטרים
failure ‫FailureDescription: FailureDescription שמתארת את הסיבה לכשל

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: מידע על הקריאה

logAssociation

public void logAssociation (String dataName, 
                LogFile log)

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

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

putEarlySummary

public void putEarlySummary ( summaries)

הפונקציה מעבירה ERROR(/List) של TestSummarys שאינם null, שיכול להיות שהוחזרו מכל ITestInvocationListeners שנוצרו כמופע כחלק מההגדרה. הסיכומים המוקדמים נוצרים אחרי ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) ואפשר להשלים אותם בסוף ההפעלה באמצעות ERROR(/#putSummary(List)).

הפונקציה הזו נקראת לפני ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) והיא מכילה את כל הסיכומים מהמאזינים שהוגדרו לפני כן.

פרמטרים
summaries ‫: ERROR(/List) של TestSummarys שאינם null מתוך ITestInvocationListeners שמשויכים להגדרה הנוכחית.

setConfiguration

public void setConfiguration (IConfiguration configuration)

הוספת IConfiguration בשימוש.

פרמטרים
configuration IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

מגדירים את ILogSaver כדי לאפשר למטמיע לשמור קבצים.

פרמטרים
logSaver ‫ILogSaver: ILogSaver

supportGranularResults

public boolean supportGranularResults ()

הפונקציה מחזירה את הערך True אם הדוח תומך בתוצאות מפורטות, אחרת היא מחזירה את הערך False.

החזרות
boolean

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

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

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

testEnded

public void testEnded (TestDescription test, 
                 metrics)

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

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

פרמטרים
test ‫TestDescription: מזהה את הבדיקה
metrics : ERROR(/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() והיא אופציונלית ברצף. הוא נמצא בשימוש רק במהלך הרצה שמשתמשת במודולים: רצים מבוססי-חבילה.

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

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

פרמטרים
failure ‫FailureDescription: FailureDescription תיאור הכשל וההקשר שלו.

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

testRunStarted

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

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

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

חלופה ל-testStarted(com.android.tradefed.result.TestDescription) שבה מציינים גם מתי הבדיקה התחילה, בשילוב עם ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) למדידה מדויקת.

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

testStarted

public void testStarted (TestDescription test)

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

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

שיטות מוגנות

createTestStorageClient

protected ITestStorageClient createTestStorageClient (IInvocationContext context)

פרמטרים
context IInvocationContext

החזרות
ITestStorageClient

getVersion

protected String getVersion ()

החזרות
String