ILogSaver

public interface ILogSaver

com.android.tradefed.result.ILogSaver

תתי-מחלקות עקיפות ידועות ATestFileSystemLogSaver, ClusterLogSaver, FileSystemLogSaver ATestFileSystemLogSaver המחלקה הזו של LogSaver משמשת את ATest לשמירת יומנים בנתיב ספציפי.  ClusterLogSaver מחלקה ILogSaver להעלאת פלטי בדיקה אל TFC.  FileSystemLogSaver שמירת יומנים במערכת קבצים.

---

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

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

סיכום

שיטות ציבוריות
abstract LogFile	getLogReportDir() מוצאים את קובץ ה-LogFile שמכיל את הנתיב או את כתובת ה-URL של הספרייה שבה נשמרים היומנים.
default void	init(IInvocationContext context) התראה מוקדמת של האתחול, לפני שהמידע על ה-build יהיה זמין.
abstract void	invocationEnded(long elapsedTime) דיווחים שההפעלה הסתיימה, בין אם בהצלחה או בגלל שגיאה כלשהי תנאי.
abstract void	invocationStarted(IInvocationContext context) מדווח על התחלת ההפעלה של הבדיקה.
abstract LogFile	saveLogData(String dataName, LogDataType dataType, InputStream dataStream) שומרים את נתוני היומן.
default LogFile	saveLogDataRaw(String dataName, LogDataType dataType, InputStream dataStream) השיטה הזו הוצאה משימוש. שימוש ב-saveLogData(String, com.android.tradefed.result.LogDataType, InputStream) במקום זאת
default LogFile	saveLogFile(String dataName, LogDataType dataType, File fileToLog) שומרים את קובץ היומן.

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

getLogReportDir

public abstract LogFile getLogReportDir ()

מוצאים את קובץ ה-LogFile שמכיל את הנתיב או את כתובת ה-URL של הספרייה שבה נשמרים היומנים.

החזרות
LogFile	LogFile.

להתחיל

public void init (IInvocationContext context)

התראה מוקדמת של האתחול, לפני שהמידע על ה-build יהיה זמין. כך אפשר כדי להגדיר דרישות לקבלת יומנים.

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

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

public abstract void invocationEnded (long elapsedTime)

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

תיקרא באופן אוטומטי על ידי framework של TradeFederation לאחר מתבצעת שיחה אל ITestInvocationListener#invocationEnded(long).

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

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

public abstract void invocationStarted (IInvocationContext context)

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

תיקרא באופן אוטומטי על ידי framework של TradeFederation לפני מתבצעת שיחה אל ITestInvocationListener#invocationStarted(IInvocationContext).

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

SaveLogData

public abstract LogFile saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

שומרים את נתוני היומן.

במסגרת TradeFederation, תישלח באופן אוטומטי קריאה בכל פעם שתבוצע קריאה ל-ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource). ייתכן לשמש גם כשיטה מסייעת לשמירת נתוני יומן נוספים.

בהתאם ליישום ולמדיניות, יכול להיות שהיומנים יישמרו בפורמט דחוס. יכול להיות גם שהיומנים יהיו מאוחסנים במיקום שלא נגיש ל-Trended.

פרמטרים
dataName	String: שם תיאורי של הנתונים String. לדוגמה 'device_logcat'
dataType	LogDataType: ה-LogDataType של הקובץ.
dataStream	InputStream: ה-ERROR(/InputStream) של הנתונים.

החזרות
LogFile	השדה LogFile שמכיל את הנתיב ואת כתובת ה-URL של הקובץ שנשמר.

קליעות
	אם לא ניתן ליצור קובץ יומן

SaveLogDataRaw

public LogFile saveLogDataRaw (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

השיטה הזו הוצאה משימוש.
שימוש ב-saveLogData(String, com.android.tradefed.result.LogDataType, InputStream) במקום זאת

שיטה מסייעת לשמירת נתוני היומן ללא שינויים.

יכול להיות שהיומנים יהיו מאוחסנים במיקום שלא נגיש ל-Trended.

פרמטרים
dataName	String: שם תיאורי של הנתונים String. לדוגמה 'device_logcat'.
dataType	LogDataType: LogDataType שמכיל את הסוג והסיומת של הקובץ
dataStream	InputStream: ה-ERROR(/InputStream) של הנתונים.

החזרות
LogFile	השדה LogFile שמכיל את הנתיב ואת כתובת ה-URL של הקובץ שנשמר.

קליעות
	אם לא ניתן ליצור קובץ יומן

SaveLogFile

public LogFile saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

שומרים את קובץ היומן.

תקבל קריאה אוטומטית על ידי framework של TradeFederation בכל פעם שתתבצע קריאה ל-ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) שידור מפנה לקובץ.

בהתאם ליישום ולמדיניות, יכול להיות שהיומנים יישמרו בפורמט דחוס. יכול להיות גם שהיומנים יהיו מאוחסנים במיקום שלא נגיש ל-Trended.

פרמטרים
dataName	String: שם תיאורי של הנתונים String. לדוגמה 'device_logcat'
dataType	LogDataType: ה-LogDataType של הקובץ.
fileToLog	File: ERROR(/File) שרוצים לשמור.

החזרות
LogFile	השדה LogFile שמכיל את הנתיב ואת כתובת ה-URL של הקובץ שנשמר.

קליעות
	אם לא ניתן ליצור קובץ יומן