LogFileSaver

public class LogFileSaver
extends Object

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

---

مساعد لـ ITestInvocationListener سيحفظ بيانات السجلّ في ملف

ملخّص

شركة إنشاءات عامة
LogFileSaver(IBuildInfo buildInfo, File rootDir) لإنشاء LogFileSaver.
LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays) ينشئ LogFileSaver.
LogFileSaver(File rootDir) دالة إنشاء LogFileSaver بديلة ستستخدم دليلاً معيّنًا فقط كدليل لتخزين السجلّات.

الطرق العامة
File	createCompressedLogFile(String dataName, LogDataType origDataType) يُنشئ ملفًا فارغًا لتخزين بيانات السجلّ المضغوطة.
OutputStream	createGZipLogStream(File logFile) لإنشاء بث إخراج لكتابة البيانات المضغوطة بتنسيق GZIP في ملف
InputStream	createInputStreamFromFile(File logFile) طريقة مساعدة لإنشاء بث إدخال لقراءة محتوى سجلّ fi المحدَّد TODO: consider moving this method elsewhere.
File	getFileDir() الحصول على الدليل المستخدَم لتخزين الملفات
	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) حفظ ملف سجلّ معيّن

وظائف الإنشاء العامة

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.

إنشاء دليل نظام ملفات فريد في الجذرDir/branch/build_id/testTag/uniqueDir

في حال تعذّر إنشاء الدليل، سيتم استخدام دليل مؤقت.

المعلمات
buildInfo	IBuildInfo: IBuildInfo
rootDir	File: مسار جذر نظام الملفات
logRetentionDays	Integer: في حال توفّر ملف retention.، سيتم كتابته في دليل السجلّات الذي يحتوي على طابع زمني يساوي الوقت الحالي + logRetentionDays. يمكن أن تستخدِم نصوص تنظيف خارجية هذا الملف لتحديد وقت حذف أدلة السجلات.

أداة حفظ الملف

public LogFileSaver (File rootDir)

باني LogFileSaver بديل سيستخدم الدليل المحدَّد فقط كدليل تخزين السجلّات.

الطرق العامة

createCompressedLogFile

public File createCompressedLogFile (String dataName, 
                LogDataType origDataType)

لإنشاء ملف فارغ لتخزين بيانات السجلّ المضغوطة.

المعلمات
dataName	String: الاسم الوصفي String للبيانات المطلوب تخزينها
origDataType	LogDataType: نوع LogDataType المطلوب تخزينه

المرتجعات
File	ERROR(/File)

عمليات الرمي
	في حال تعذّر إنشاء ملف السجلّ

createGZipLogStream

public OutputStream createGZipLogStream (File logFile)

لإنشاء بث إخراج لكتابة البيانات المضغوطة بتنسيق GZIP في ملف

المعلمات
logFile	‫File: ERROR(/File) المطلوب الكتابة فيه

المرتجعات
OutputStream	ERROR(/OutputStream) لضغط البيانات وكتابتها في الملف هذا البث عند اكتماله

الرميات
	إذا تعذّر إنشاء البث

createInputStreamFromFile

public InputStream createInputStreamFromFile (File logFile)

طريقة مساعدة لإنشاء بث إدخال لقراءة محتوى ملف السجلّ المحدّد

TODO: consider moving this method elsewhere. تم وضعه هنا الآن لكي يتمه للمستخدمين من هذه الفئة السخرية منه.

المعلمات
logFile	File: ERROR(/File) للقراءة منه

المرتجعات
InputStream	ERROR(/InputStream) مؤقت لقراءة بيانات الملفات على المتصلين الاتصال بهذه البث عند اكتمالها.

الرميات
	إذا تعذّر إنشاء البث

getFileDir

public File getFileDir ()

الحصول على الدليل المستخدَم لتخزين الملفات

المرتجعات
File	دليل ERROR(/File)

getInvocationLogPathSegments

public  getInvocationLogPathSegments ()

المرتجعات
	أقسام مسار سجلّ الاستدعاء الفريدة

SaveAndGZipLogData

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

حفظ بيانات السجلّ وضغطها، إذا لزم الأمر، في ملف gzip

المعلمات
dataName	String: اسم String وصفي للبيانات
dataType	LogDataType: LogDataType الملف بيانات السجلّ التي تكون (أي LogDataType#isCompressed() هي true)
dataStream	InputStream: ERROR(/InputStream) البيانات

المرتجعات
File	ملف البيانات التي تم إنشاؤها

عمليات الرمي
	إذا تعذّر إنشاء ملف السجلّ

saveAndGZipLogFile

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

حفظ بيانات السجلّ وضغطها، إذا لزم الأمر، في ملف gzip

المعلمات
dataName	String: اسم String وصفي للبيانات
dataType	LogDataType: LogDataType الملف بيانات السجلّ التي تكون (أي LogDataType.isCompressed() هي true)
fileToLog	File: ERROR(/File) الذي يجب توفيره

المرتجعات
File	ملف البيانات التي تم إنشاؤها

عمليات الرمي
	إذا تعذّر إنشاء ملف السجلّ

saveLogData

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

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

المعلمات
dataName	String: اسم String وصفي للبيانات
dataType	LogDataType: LogDataType الملف
dataStream	InputStream: ERROR(/InputStream) للبيانات.

المرتجعات
File	ملف البيانات التي تم إنشاؤها

عمليات الرمي
	إذا تعذّر إنشاء ملف السجلّ

saveLogDataRaw

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

حفظ البيانات الأولية في ملف

المعلمات
dataName	String: اسم String وصفي للبيانات
ext	String: امتداد التاريخ
dataStream	InputStream: ERROR(/InputStream) البيانات

المرتجعات
File	ملف البيانات التي تم إنشاؤها

عمليات الرمي
	إذا تعذَّر إنشاء ملف السجلّ

saveLogFile

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

حفظ ملف سجلّ معيّن

المعلمات
dataName	String: اسم String وصفي للبيانات.
dataType	LogDataType: LogDataType الملف
fileToLog	File: ERROR(/File) المطلوب تسجيله

المرتجعات
File	ملف البيانات التي تم إنشاؤها

عمليات الرمي
	إذا تعذّر إنشاء ملف السجلّ