FileSystemLogSaver

public class FileSystemLogSaver
extends Object implements ILogSaver

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


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

סיכום

‫constructors ציבוריים

FileSystemLogSaver()

‫methods ציבוריים

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)

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

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

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

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

void setCompressFiles(boolean compress)
void testModuleEnded()

הודעה שהמודול לבדיקה הסתיים.

void testModuleStarted(IInvocationContext moduleContext)

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

שיטות מוגנות

File createBuildDir(IBuildInfo buildInfo, File reportDir, String moduleName)

שיטת עזר לקבלת או ליצירת ספריית build על סמך פרטי ה-build של הקריאה.

File generateLogReportDir(IBuildInfo buildInfo, File reportDir, String moduleName)

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

‫constructors ציבוריים

FileSystemLogSaver

public FileSystemLogSaver ()

‫methods ציבוריים

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)

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

המסגרת 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)

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

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation בכל פעם שהפונקציה ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) מופעלת. יכול להיות שהיא תשמש גם כשיטת עזר לשמירת נתוני יומן נוספים.

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

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

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

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

dataStream InputStream: InputStream הנתונים.

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

הקפצת הודעות שגיאה (throw)
IOException

saveLogFile

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

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

הפונקציה הזו תופעל אוטומטית על ידי מסגרת TradeFederation בכל פעם שמופעלת הפונקציה ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) והזרם מפנה לקובץ.

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

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

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

fileToLog File: File שרוצים לשמור.

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

הקפצת הודעות שגיאה (throw)
IOException

setCompressFiles

public void setCompressFiles (boolean compress)

פרמטרים
compress boolean

testModuleEnded

public void testModuleEnded ()

הודעה שהמודול לבדיקה הסתיים.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

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

שיטות מוגנות

createBuildDir

protected File createBuildDir (IBuildInfo buildInfo, 
                File reportDir, 
                String moduleName)

שיטת עזר לקבלת או ליצירת ספריית build על סמך פרטי ה-build של הקריאה.

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

פרמטרים
buildInfo IBuildInfo: IBuildInfo

reportDir File: File של ספריית הדוחות.

moduleName String: השם של מודול הבדיקה

החזרות
File הספרייה שבה צריך לשמור קריאות לאותו build.

הקפצת הודעות שגיאה (throw)
IOException אם לא ניתן ליצור את הספרייה כי קיים קובץ עם אותו שם או כי אין הרשאות כתיבה לספרייה.

generateLogReportDir

protected File generateLogReportDir (IBuildInfo buildInfo, 
                File reportDir, 
                String moduleName)

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

פרמטרים
buildInfo IBuildInfo: IBuildInfo

reportDir File: File של ספריית הדוחות.

moduleName String: השם של מודול הבדיקה

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

הקפצת הודעות שגיאה (throw)
IOException