ذخیره کننده فایل لاگ

public class LogFileSaver
extends Object

شیء جاوا
↳ com.android.tradefed.result.LogFileSaver

یک تابع کمکی برای ITestInvocationListener که داده‌های لاگ را در یک فایل ذخیره می‌کند

خلاصه

سازندگان عمومی

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)

یک سازنده‌ی جایگزین LogFileSaver که فقط از دایرکتوری داده شده به عنوان دایرکتوری ذخیره‌سازی لاگ استفاده می‌کند.

روش‌های عمومی

File createCompressedLogFile (String dataName, LogDataType origDataType)

یک فایل خالی برای ذخیره داده‌های فشرده‌شده‌ی لاگ ایجاد می‌کند.

OutputStream createGZipLogStream (File logFile)

یک جریان خروجی برای نوشتن داده‌های فشرده‌شده با GZIP در یک فایل ایجاد می‌کند.

InputStream createInputStreamFromFile (File logFile)

متد کمکی برای ایجاد یک جریان ورودی برای خواندن محتویات log fi داده شده

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)

یک فایل لاگ داده شده را ذخیره کنید

سازندگان عمومی

ذخیره کننده فایل لاگ 

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir)

یک LogFileSaver ایجاد می‌کند.

یک دایرکتوری سیستم فایل منحصر به فرد در rootDir/branch/build_id/uniqueDir بسازید.

پارامترها
buildInfo IBuildInfo : IBuildInfo

rootDir File : مسیر سیستم فایل ریشه

ذخیره کننده فایل لاگ 

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

یک LogFileSaver ایجاد می‌کند.

یک دایرکتوری سیستم فایل منحصر به فرد در rootDir/branch/build_id/testTag/uniqueDir بسازید.

اگر ایجاد دایرکتوری با شکست مواجه شود، از یک دایرکتوری موقت استفاده خواهد شد.

پارامترها
buildInfo IBuildInfo : IBuildInfo

rootDir File : مسیر سیستم فایل ریشه

logRetentionDays Integer : در صورت ارائه، یک فایل '.retention' در دایرکتوری لاگ نوشته خواهد شد که حاوی یک مهر زمانی برابر با زمان فعلی + logRetentionDays است. اسکریپت‌های پاکسازی خارجی می‌توانند از این فایل برای تعیین زمان حذف دایرکتوری‌های لاگ استفاده کنند.

ذخیره کننده فایل لاگ 

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

ذخیره کننده فایل لاگ 

public LogFileSaver (File rootDir)

یک سازنده‌ی جایگزین LogFileSaver که فقط از دایرکتوری داده شده به عنوان دایرکتوری ذخیره‌سازی لاگ استفاده می‌کند.

روش‌های عمومی

ایجاد فایل گزارش فشرده 

public File createCompressedLogFile (String dataName, 
                LogDataType origDataType)

یک فایل خالی برای ذخیره داده‌های فشرده‌شده‌ی لاگ ایجاد می‌کند.

پارامترها
dataName String : یک نام توصیفی String از داده‌هایی که قرار است ذخیره شوند.

origDataType LogDataType : نوع LogDataType که قرار است ذخیره شود.

بازگشت‌ها
File یک File

پرتاب‌ها
IOException اگر فایل لاگ ایجاد نشد

ایجادGZipLogStream 

public OutputStream createGZipLogStream (File logFile)

یک جریان خروجی برای نوشتن داده‌های فشرده‌شده با GZIP در یک فایل ایجاد می‌کند.

پارامترها
logFile File : File که قرار است در آن نوشته شود

بازگشت‌ها
OutputStream OutputStream برای فشرده‌سازی و نوشتن داده‌ها در فایل. این جریان پس از تکمیل

پرتاب‌ها
IOException اگر جریان قابل تولید نبود

ایجادجریان ورودیازفایل 

public InputStream createInputStreamFromFile (File logFile)

متد کمکی برای ایجاد یک جریان ورودی برای خواندن محتویات log fi داده شده

TODO: انتقال این متد به جای دیگر را در نظر بگیرید. فعلاً اینجا قرار داده شده تا کاربران این کلاس بتوانند آن را شبیه‌سازی کنند.

پارامترها
logFile File : File که قرار است از آن خوانده شود

بازگشت‌ها
InputStream یک InputStream بافر شده برای خواندن داده‌های فایل. فراخوانی‌کنندگان باید پس از تکمیل، این جریان را فراخوانی کنند.

پرتاب‌ها
IOException اگر جریان قابل تولید نبود

دریافت فایل دایرکتوری 

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 فایل. داده‌های لاگ که a هستند (یعنی LogDataType.isCompressed() true است).

dataStream InputStream : InputStream داده‌ها.

بازگشت‌ها
File فایل داده‌های تولید شده

پرتاب‌ها
IOException اگر فایل لاگ ایجاد نشد

ذخیره و فایل ثبت اطلاعات (saveAndGZipLogFile) 

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

در صورت لزوم، داده‌های لاگ را در یک فایل gzip ذخیره و فشرده کنید.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها.

dataType LogDataType : LogDataType فایل. داده‌های لاگ که a هستند (یعنی LogDataType.isCompressed() true است).

fileToLog File : File که قرار است ذخیره شود

بازگشت‌ها
File فایل داده‌های تولید شده

پرتاب‌ها
IOException اگر فایل لاگ ایجاد نشد

ذخیره اطلاعات 

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

ذخیره داده‌های لاگ در یک فایل

پارامترها
dataName String : یک نام توصیفی String از داده‌ها.

dataType LogDataType : LogDataType فایل.

dataStream InputStream : InputStream داده‌ها.

بازگشت‌ها
File فایل داده‌های تولید شده

پرتاب‌ها
IOException اگر فایل لاگ ایجاد نشد

ذخیره لاگ دیتا راو 

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

ذخیره داده‌های خام در یک فایل

پارامترها
dataName String : یک نام توصیفی String از داده‌ها.

ext String : پسوند تاریخ

dataStream InputStream : InputStream داده‌ها.

بازگشت‌ها
File فایل داده‌های تولید شده

پرتاب‌ها
IOException اگر فایل لاگ ایجاد نشد

ذخیره فایل ثبت وقایع 

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

یک فایل لاگ داده شده را ذخیره کنید

پارامترها
dataName String : یک نام توصیفی String از داده‌ها.

dataType LogDataType : LogDataType فایل.

fileToLog File : File که قرار است ثبت شود

بازگشت‌ها
File فایل داده‌های تولید شده

پرتاب‌ها
IOException اگر فایل لاگ ایجاد نشد