LogFileSaver

public class LogFileSaver
extends Object

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

כלי עזר ל-ITestInvocationListener שישמור נתוני יומן בקובץ

סיכום

‫constructors ציבוריים

LogFileSaver(IBuildInfo buildInfo, File rootDir)

יצירת LogFileSaver.

LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays)

יצירת LogFileSaver.

LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays, Boolean containInvDir)

יצירת LogFileSaver.

LogFileSaver(File rootDir)

‫constructor חלופי של LogFileSaver שישתמש רק בספרייה שצוינה בתור ספריית אחסון היומנים.

‫methods ציבוריים

File createCompressedLogFile(String dataName, LogDataType origDataType)

יוצר קובץ ריק לאחסון נתוני יומן דחוסים.

OutputStream createGZipLogStream(File logFile)

יוצר זרם פלט לכתיבת נתונים דחוסים בפורמט GZIP לקובץ

InputStream createInputStreamFromFile(File logFile)

שיטת עזר ליצירת זרם קלט לקריאת התוכן של קובץ יומן נתון

TODO: כדאי להעביר את השיטה הזו למקום אחר.

File getFileDir()

קבלת הספרייה שמשמשת לאחסון קבצים.

List<String> getInvocationLogPathSegments()
File saveAndGZipLogData(String dataName, LogDataType dataType, InputStream dataStream)

שומרים את נתוני היומן ודוחסים אותם לקובץ gzip, אם צריך

File saveAndGZipLogFile(String dataName, LogDataType dataType, File fileToLog)

שומרים את נתוני היומן ודוחסים אותם לקובץ gzip, אם צריך

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

שמירת נתוני היומן בקובץ

File saveLogDataRaw(String dataName, String ext, InputStream dataStream)

שמירת נתונים גולמיים בקובץ

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

שמירת קובץ יומן נתון

‫constructors ציבוריים

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir)

יצירת LogFileSaver.

יוצרים ספרייה ייחודית במערכת הקבצים בנתיב rootDir/branch/build_id/uniqueDir

פרמטרים
buildInfo IBuildInfo: IBuildInfo
rootDir ‫File: הנתיב של מערכת הקבצים הבסיסית

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir, 
                Integer logRetentionDays)

יצירת LogFileSaver.

יוצרים ספרייה ייחודית במערכת הקבצים בנתיב rootDir/branch/build_id/testTag/uniqueDir

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

פרמטרים
buildInfo IBuildInfo: IBuildInfo
rootDir ‫File: הנתיב של מערכת הקבצים הבסיסית
logRetentionDays ‫Integer: אם מסופק קובץ ‎.retention, הוא ייכתב לספריית היומן ויכיל חותמת זמן ששווה לזמן הנוכחי + logRetentionDays. סקריפטים חיצוניים לניקוי יכולים להשתמש בקובץ הזה כדי לקבוע מתי למחוק ספריות של יומנים.

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir, 
                Integer logRetentionDays, 
                Boolean containInvDir)

יצירת LogFileSaver.

יוצרים ספרייה ייחודית במערכת הקבצים בנתיב rootDir/branch/build_id/testTag/uniqueDir

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

פרמטרים
buildInfo IBuildInfo: IBuildInfo
rootDir ‫File: הנתיב של מערכת הקבצים הבסיסית
logRetentionDays ‫Integer: אם מסופק קובץ ‎.retention, הוא ייכתב לספריית היומן ויכיל חותמת זמן ששווה לזמן הנוכחי + logRetentionDays. סקריפטים חיצוניים לניקוי יכולים להשתמש בקובץ הזה כדי לקבוע מתי למחוק ספריות של יומנים.
containInvDir Boolean

LogFileSaver

public LogFileSaver (File rootDir)

‫constructor חלופי של LogFileSaver שישתמש רק בספרייה שצוינה בתור ספריית אחסון היומנים.

‫methods ציבוריים

createCompressedLogFile

public File createCompressedLogFile (String dataName, 
                LogDataType origDataType)

יוצר קובץ ריק לאחסון נתוני יומן דחוסים.

פרמטרים
dataName ‫String: String שם תיאורי של הנתונים שייאגרו.
origDataType ‫LogDataType: הסוג של LogDataType שרוצים לאחסן
החזרות
File File
הקפצת הודעות שגיאה (throw)
IOException אם לא ניתן ליצור קובץ יומן

createGZipLogStream

public OutputStream createGZipLogStream (File logFile)

יוצר זרם פלט לכתיבת נתונים דחוסים בפורמט GZIP לקובץ

פרמטרים
logFile ‫File: File שאליו רוצים לכתוב
החזרות
OutputStream ‫OutputStream כדי לדחוס ולכתוב נתונים בקובץ. השידור הזה כשהוא יסתיים
הקפצת הודעות שגיאה (throw)
IOException אם לא הייתה אפשרות ליצור סטרימינג

createInputStreamFromFile

public InputStream createInputStreamFromFile (File logFile)

שיטת עזר ליצירת זרם קלט לקריאת התוכן של קובץ יומן נתון

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

פרמטרים
logFile ‫File: File לקריאה מ
החזרות
InputStream ‫InputStream עם מאגר נתונים זמני לקריאת נתונים מקובץ. המתקשרים צריכים להתקשר לזרם הזה כשהם מסיימים
הקפצת הודעות שגיאה (throw)
IOException אם לא הייתה אפשרות ליצור סטרימינג

getFileDir

public File getFileDir ()

קבלת הספרייה שמשמשת לאחסון קבצים.

החזרות
File הספרייה File

getInvocationLogPathSegments

public List<String> getInvocationLogPathSegments ()

החזרות
List<String> קטעי הנתיב הייחודיים של יומן ההפעלה.

saveAndGZipLogData

public File saveAndGZipLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

שומרים את נתוני היומן ודוחסים אותם לקובץ gzip, אם צריך

פרמטרים
dataName ‫String: שם תיאורי של הנתונים String.
dataType ‫LogDataType: LogDataType של הקובץ. נתוני יומן שהם (כלומר LogDataType.isCompressed() הוא true)
dataStream InputStream: InputStream הנתונים.
החזרות
File הקובץ של הנתונים שנוצרו
הקפצת הודעות שגיאה (throw)
IOException אם לא ניתן ליצור קובץ יומן

saveAndGZipLogFile

public File saveAndGZipLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

שומרים את נתוני היומן ודוחסים אותם לקובץ gzip, אם צריך

פרמטרים
dataName ‫String: שם תיאורי של הנתונים String.
dataType ‫LogDataType: LogDataType של הקובץ. נתוני יומן שהם (כלומר LogDataType.isCompressed() הוא true)
fileToLog ‫File: File לשמירה
החזרות
File הקובץ של הנתונים שנוצרו
הקפצת הודעות שגיאה (throw)
IOException אם לא ניתן ליצור קובץ יומן

saveLogData

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

שמירת נתוני היומן בקובץ

פרמטרים
dataName ‫String: שם תיאורי של הנתונים String.
dataType ‫LogDataType: LogDataType של הקובץ.
dataStream InputStream: InputStream הנתונים.
החזרות
File הקובץ של הנתונים שנוצרו
הקפצת הודעות שגיאה (throw)
IOException אם לא ניתן ליצור קובץ יומן

saveLogDataRaw

public File saveLogDataRaw (String dataName, 
                String ext, 
                InputStream dataStream)

שמירת נתונים גולמיים בקובץ

פרמטרים
dataName ‫String: שם תיאורי של הנתונים String.
ext ‫String: התאריך המעודכן
dataStream InputStream: InputStream הנתונים.
החזרות
File הקובץ של הנתונים שנוצרו
הקפצת הודעות שגיאה (throw)
IOException אם לא ניתן ליצור קובץ יומן

saveLogFile

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

שמירת קובץ יומן נתון

פרמטרים
dataName ‫String: שם תיאורי של הנתונים String.
dataType ‫LogDataType: LogDataType של הקובץ.
fileToLog File: File שרוצים לתעד ביומן
החזרות
File הקובץ של הנתונים שנוצרו
הקפצת הודעות שגיאה (throw)
IOException אם לא ניתן ליצור קובץ יומן