ShardMainתוצאהForwarder

public class ShardMainResultForwarder
extends ResultForwarder implements ILogSaverListener

JavaScript.lang.Object
↳ com.android.tradefed.result.resultForwarder
  ↳ com.android.tradefed.invoker.ShardDefaultForwarder

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

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

סיכום

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

ShardMainResultForwarder( listeners, int expectedShards)

יוצרים ShardMainResultForwarder.

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

getListeners()

לקבל את רשימת המאזינים.

void invocationEnded(long elapsedTime)

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

void invocationEnded(long elapsedTime, IInvocationContext context)

קריאה חוזרת (callback) מפורטת יותר כדי להבחין איזה פיצול הסתיים.

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

void invocationSkipped(SkipReason reason)

דיווח על הפעלה כתוכן שדילגת עליו

void invocationStarted(IInvocationContext context)

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

void logAssociation(String dataName, LogFile logFile)

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

void testLogForward(String dataName, LogDataType dataType, InputStreamSource dataStream)

צריך להעביר את קובץ ה-testLog במקום לשמור את היומן קודם.

void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

בוצעה קריאה כשיומן הבדיקה נשמר.

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

ShardMainתוצאהForwarder

public ShardMainResultForwarder ( listeners, 
                int expectedShards)

יוצרים ShardMainResultForwarder.

פרמטרים
listeners : רשימה של ITestInvocationListener שאליהם יועברו התוצאות כאשר הכול הפיצולים הושלמו
expectedShards int: מספר הפיצולים

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

getListeners

public  getListeners ()

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

החזרות
הרשימה של ITestInvocationListener.

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

public void invocationEnded (long elapsedTime)

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

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

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

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

public void invocationEnded (long elapsedTime, 
                IInvocationContext context)

קריאה חוזרת (callback) מפורטת יותר כדי להבחין איזה פיצול הסתיים.

פרמטרים
elapsedTime long

context IInvocationContext

ההפעלה נכשלה

public void invocationFailed (FailureDescription failure)

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

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

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

ההפעלה נכשלה

public void invocationFailed (Throwable cause)

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

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

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

המערכת דילגה על ההפעלה

public void invocationSkipped (SkipReason reason)

דיווח על הפעלה כתוכן שדילגת עליו

פרמטרים
reason SkipReason

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

public void invocationStarted (IInvocationContext context)

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

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

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

שיוך (logAssociation)

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

testLogForward

public void testLogForward (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

צריך להעביר את קובץ ה-testLog במקום לשמור את היומן קודם.

פרמטרים
dataName String

dataType LogDataType

dataStream InputStreamSource

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

בוצעה קריאה כשיומן הבדיקה נשמר.

יש להשתמש בו במקום ITestInvocationListener#testLog(String, LogDataType, InputStreamSource).

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