FileSystemLogSaver

public class FileSystemLogSaver
extends Object implements ILogSaver

java.lang.Object
   ↳ com.android.tradefed.result.FileSystemLogSaver


שמירת יומנים במערכת קבצים.

סיכום

יוצרים ציבוריים

FileSystemLogSaver()

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

LogFile getLogReportDir()

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

void invocationEnded(long elapsedTime)

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

void invocationStarted(IInvocationContext context)

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

בנוסף, צריך ליצור ספרייה ייחודית במערכת הקבצים ב-report-dir/[branch/]build-id/test-tag/unique_dir לשמירת יומנים.

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

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

קובץ היומן יאוחסן בפורמט ZIP אם הפונקציה LogDataType.isCompressed() מחזירה את הערך false עבור dataType ו-compressed-files מוגדר. אחרת, הסטרימינג יישמר ללא דחיסה.

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

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

void setCompressFiles(boolean compress)

שיטות מוגנות

File generateLogReportDir(IBuildInfo buildInfo, File reportDir)

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

יוצרים ציבוריים

FileSystemLogSaver

public FileSystemLogSaver ()

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

getLogReportDir

public LogFile getLogReportDir ()

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

החזרות
LogFile LogFile.

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

המערכת תבצע קריאה אוטומטית ל-method הזה במסגרת TradeFederation לפני שתתבצע קריאה ל-ITestInvocationListener.invocationStarted(IInvocationContext).

בנוסף, צריך ליצור ספרייה ייחודית במערכת הקבצים ב-report-dir/[branch/]build-id/test-tag/unique_dir לשמירת יומנים. אם היצירה של הספרייה נכשלת, יופיעו יומנים בספרייה זמנית במערכת הקבצים המקומית.

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

saveLogData

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

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

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

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

קובץ היומן יאוחסן בפורמט ZIP אם הפונקציה LogDataType.isCompressed() מחזירה את הערך false עבור dataType ו-compressed-files מוגדר. אחרת, הסטרימינג יישמר ללא דחיסה.

פרמטרים
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)

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

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

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

פרמטרים
dataName String: String שם תיאורי של הנתונים. לדוגמה, 'device_logcat'

dataType LogDataType: ה-LogDataType של הקובץ.

fileToLog File: ה-ERROR(/File) שרוצים לשמור.

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

setCompressFiles

public void setCompressFiles (boolean compress)

פרמטרים
compress boolean

שיטות מוגנות

generateLogReportDir

protected File generateLogReportDir (IBuildInfo buildInfo, 
                File reportDir)

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

פרמטרים
buildInfo IBuildInfo: IBuildInfo

reportDir File: ה-ERROR(/File) של ספריית הדוחות.

החזרות
File הספרייה נוצרה.