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)

احفظ بيانات السجلّ.

سيتم ضغط ملف السجل وحفظه إذا عرضت LogDataType.isCompressed() القيمة "خطأ" لكل من dataType وcompressed-files، وإلا سيتم حفظ البث بدون ضغط.

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)

طريقة مكشوفة تسمح للفئة الفرعية بتخصيص منطق إنشاء المسار.

طُرق وضع التصميم العامة

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)

تسجّل هذه السمة بداية تنفيذ الاختبار.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل 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() القيمة "خطأ" لكل من dataType وcompressed-files، وإلا سيتم حفظ البث بدون ضغط.

المعلَمات
dataName String: اسم وصفي String للبيانات، مثل "device_logcat"
dataType LogDataType: LogDataType الخاص بالملف
dataStream InputStream: InputStream الخاص بالبيانات
المرتجعات
LogFile LogFile الذي يحتوي على مسار الملف المحفوظ وعنوان URL الخاص به
عمليات الطرح
IOException

saveLogFile

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

احفظ ملف السجلّ.

سيتم استدعاؤها تلقائيًا من خلال إطار عمل TradeFederation كلما تم استدعاء ITestInvocationListener.testLog(String,LogDataType,InputStreamSource) وكان البث يشير إلى ملف.

استنادًا إلى التنفيذ والسياسة، قد يتم حفظ السجلّات في شكل مضغوط. قد يتم أيضًا تخزين السجلات في موقع لا يمكن الوصول إليه من خلال Tradefed.

المعلَمات
dataName String: اسم وصفي String للبيانات، مثل "device_logcat"
dataType LogDataType: LogDataType الخاص بالملف
fileToLog استبدِل File بـ File لحفظها.
المرتجعات
LogFile LogFile الذي يحتوي على مسار الملف المحفوظ وعنوان URL الخاص به
عمليات الطرح
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)

طريقة مساعدة للحصول على دليل إنشاء أو إنشائه استنادًا إلى معلومات الإنشاء الخاصة بالاستدعاء

أنشئ دليل نظام ملفات فريدًا بالبنية 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