LogSaverResultForwarder

public class LogSaverResultForwarder
extends ResultForwarder implements ILogSaverListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder
	↳	com.android.tradefed.result.LogSaverResultForwarder

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

---

ResultForwarder לשמירת יומנים עם שומר הקבצים הגלובלי.

סיכום

בנאים ציבוריים
LogSaverResultForwarder ( ILogSaver logSaver, listeners) LogSaverResultForwarder ( ILogSaver logSaver, listeners)

שיטות ציבוריות
void	invocationEnded (long elapsedTime) מדווח שהפנייה הסתיימה, בין אם בהצלחה ובין אם עקב מצב שגיאה כלשהו.
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) התקשרות חוזרת אינה אפשרית.
static void	logFile ( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type) logFile ( listeners, ILogSaver saver, InputStreamSource source, String name, LogDataType type) רישום קובץ סופי לפני השלמתו
static void	reportEndHostLog ( listeners, ILogSaver saver, String name) reportEndHostLog ( listeners, ILogSaver saver, String name) מדווח על host_log מההפעלה בתהליך.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) מספק את היומן המשויך או נתוני ניפוי באגים מקריאת הבדיקה. כמו כן, שמור את קובץ היומן עם ILogSaver הגלובלי וקרא ל- ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) עבור המאזינים המיישמים את ממשק ILogSaverListener .
void	testLogForward (String dataName, LogDataType dataType, InputStreamSource dataStream) העבר רק את testLog במקום לשמור את היומן תחילה.
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) נקרא כאשר יומן הבדיקה נשמר. אם LogSaverResultForwarder עטוף באחד אחר, ודא שנעביר את ההתקשרות חזרה של testLogSaved למאזינים שמתחתיו.

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

LogSaverResultForwarder

public LogSaverResultForwarder (ILogSaver logSaver, 
                 listeners)

פרמטרים
logSaver	ILogSaver
listeners

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

הקריאה הסתיימה

public void invocationEnded (long elapsedTime)

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

ייקרא אוטומטית על ידי מסגרת TradeFederation.

פרמטרים
elapsedTime	long : הזמן שחלף של הקריאה ב-ms

התראה התחילה

public void invocationStarted (IInvocationContext context)

מדווח על תחילת הזמנת הבדיקה.

ייקרא אוטומטית על ידי מסגרת 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 שנרשם קודם לכן ואמור להיות משויך למקרה הבדיקה.

קובץ לוג

public static void logFile ( listeners, 
                ILogSaver saver, 
                InputStreamSource source, 
                String name, 
                LogDataType type)

רישום קובץ סופי לפני השלמתו

פרמטרים
listeners
saver	ILogSaver
source	InputStreamSource
name	String
type	LogDataType

reportEndHostLog

public static void reportEndHostLog ( listeners, 
                ILogSaver saver, 
                String name)

מדווח על host_log מההפעלה בתהליך.

פרמטרים
listeners
saver	ILogSaver
name	String

testLog

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

מספק את היומן המשויך או נתוני ניפוי באגים מקריאת הבדיקה.

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

המסגרת של TradeFederation תקרא אוטומטית לשיטה זו, תספק את יומן המארח ואם רלוונטי, את logcat המכשיר.

כמו כן, שמור את קובץ היומן עם ILogSaver הגלובלי וקרא ל- ILogSaverListener#testLogSaved(String, LogDataType, InputStreamSource, LogFile) עבור המאזינים המיישמים את ממשק ILogSaverListener .

פרמטרים
dataName	String : שם String של המחרוזת של הנתונים. למשל "device_logcat". הערה ייתכן ש-dataName אינו ייחודי לכל הזמנה. כלומר, המיישמים חייבים להיות מסוגלים לטפל במספר שיחות עם אותו dataName
dataType	LogDataType : LogDataType של הנתונים
dataStream	InputStreamSource : InputStreamSource של הנתונים. על המיישמים להתקשר ל-createInputStream כדי להתחיל לקרוא את הנתונים, ולהבטיח לסגור את ה-InputStream שהתקבל לאחר השלמתו. המתקשרים צריכים לוודא שמקור הנתונים נשאר קיים ונגיש עד להשלמת שיטת testLog.

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

אם LogSaverResultForwarder עטוף באחד אחר, ודא שנעביר את ההתקשרות חזרה של testLogSaved למאזינים שמתחתיו.

פרמטרים
dataName	String : שם String של המחרוזת של הנתונים. למשל "device_logcat". הערה ייתכן ש-dataName אינו ייחודי לכל הזמנה. כלומר, המיישמים חייבים להיות מסוגלים לטפל במספר שיחות עם אותו dataName
dataType	LogDataType : LogDataType של הנתונים
dataStream	InputStreamSource : InputStreamSource של הנתונים. על המיישמים להתקשר ל-createInputStream כדי להתחיל לקרוא את הנתונים, ולהבטיח לסגור את ה-InputStream שהתקבל לאחר השלמתו.
logFile	LogFile : ה- LogFile המכיל את המטא נתונים של הקובץ השמור.