ذخیره‌کننده‌ی لاگ سیستم فایل

public class FileSystemLogSaver
extends Object implements ILogSaver

شیء جاوا
↳ 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)

داده‌های لاگ را ذخیره کنید.

اگر LogDataType.isCompressed() برای dataType مقدار false برگرداند و compressed-files تنظیم شده باشد، فایل لاگ را فشرده و ذخیره می‌کند، در غیر این صورت، جریان (stream) به صورت غیر فشرده ذخیره می‌شود.

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)

یک متد کمکی برای دریافت یا ایجاد یک دایرکتوری ساخت بر اساس اطلاعات ساخت فراخوانی.

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

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

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

ذخیره‌کننده‌ی لاگ سیستم فایل 

public FileSystemLogSaver ()

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

دریافت گزارش گزارش 

public LogFile getLogReportDir ()

LogFile حاوی مسیر و/یا URL دایرکتوری که لاگ‌ها در آن ذخیره می‌شوند را دریافت کنید.

بازگشت‌ها
LogFile LogFile ).

فراخوان پایان یافت 

public void invocationEnded (long elapsedTime)

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

پس از فراخوانی ITestInvocationListener.invocationEnded(long) به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود.

پارامترها
elapsedTime long : زمان سپری شده از فراخوانی بر حسب میلی‌ثانیه

فراخوان شروع شد 

public void invocationStarted (IInvocationContext context)

شروع فراخوانی تست را گزارش می‌دهد.

قبل از فراخوانی ITestInvocationListener.invocationStarted(IInvocationContext) به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود.

همچنین، یک دایرکتوری سیستم فایل منحصر به فرد در مسیر report-dir/[branch/]build-id/test-tag/unique_dir برای ذخیره گزارش‌ها ایجاد کنید. اگر ایجاد دایرکتوری با شکست مواجه شود، گزارش‌ها در یک دایرکتوری موقت در سیستم فایل محلی نوشته می‌شوند.

پارامترها
context IInvocationContext : اطلاعاتی در مورد فراخوانی.

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

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

داده‌های لاگ را ذخیره کنید.

هر زمان که ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) فراخوانی شود، به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود. همچنین می‌توان از آن به عنوان یک متد کمکی برای ذخیره داده‌های لاگ اضافی استفاده کرد.

بسته به پیاده‌سازی و سیاست، لاگ‌ها ممکن است به صورت فشرده ذخیره شوند. همچنین ممکن است لاگ‌ها در مکانی غیرقابل دسترس برای Tradefed ذخیره شوند.

اگر LogDataType.isCompressed() برای dataType مقدار false برگرداند و compressed-files تنظیم شده باشد، فایل لاگ را فشرده و ذخیره می‌کند، در غیر این صورت، جریان (stream) به صورت غیر فشرده ذخیره می‌شود.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat"

dataType LogDataType : LogDataType فایل.

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

بازگشت‌ها
LogFile LogFile حاوی مسیر و آدرس اینترنتی (URL) فایل ذخیره شده.

پرتاب‌ها
IOException

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

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

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

هر زمان که ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) فراخوانی شود و جریان به یک فایل ارجاع دهد، به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود.

بسته به پیاده‌سازی و سیاست، لاگ‌ها ممکن است به صورت فشرده ذخیره شوند. همچنین ممکن است لاگ‌ها در مکانی غیرقابل دسترس برای Tradefed ذخیره شوند.

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat"

dataType LogDataType : LogDataType فایل.

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

بازگشت‌ها
LogFile LogFile حاوی مسیر و آدرس اینترنتی (URL) فایل ذخیره شده.

پرتاب‌ها
IOException

setCompressFiles 

public void setCompressFiles (boolean compress)

پارامترها
compress boolean

testModuleEnd 

public void testModuleEnded ()

گزارش می‌دهد که ماژول آزمایشی خاتمه یافته است.

ماژول تست شروع شد 

public void testModuleStarted (IInvocationContext moduleContext)

شروع ماژول آزمون را گزارش می‌دهد.

پارامترها
moduleContext IInvocationContext : اطلاعات مربوط به ماژول.

روش‌های محافظت‌شده

ایجادساخت دایرکتوری 

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

یک متد کمکی برای دریافت یا ایجاد یک دایرکتوری ساخت بر اساس اطلاعات ساخت فراخوانی.

یک دایرکتوری سیستم فایل منحصر به فرد با ساختار report-dir/[branch/]build-id/test-tag برای ذخیره گزارش‌ها ایجاد کنید.

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

reportDir File : File مربوط به پوشه گزارش.

moduleName String : نام ماژول آزمایشی

بازگشت‌ها
File دایرکتوری که فراخوانی‌های مربوط به همان ساخت باید در آن ذخیره شود.

پرتاب‌ها
IOException اگر دایرکتوری به دلیل وجود فایلی با همین نام یا عدم وجود مجوز برای نوشتن در آن، ایجاد نشد.

generateLogReportDir 

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

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

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

reportDir File : File مربوط به پوشه گزارش.

moduleName String : نام ماژول آزمایشی

بازگشت‌ها
File دایرکتوری ایجاد شده.

پرتاب‌ها
IOException