BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.Object
   ↳ com.android.tradefed.postprocessor.BasePostProcessor

القاعدة IPostProcessor التي يجب أن تمتد إليها كل عملية تنفيذ تأكَّد من استدعاء طُرق المعالجة بعد قبل أدوات إعداد تقارير النتائج النهائية.

ملخّص

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

BasePostProcessor()

الطرق العامة

final ITestInvocationListener init(ITestInvocationListener listener)

خطوة إعداد معالج النشر

final void invocationEnded(long elapsedTime)

تشير هذه العلامة إلى البلاغات التي تفيد بإنهاء الاستدعاء، سواء بنجاح أو بسبب خطأ ما.

final void invocationFailed(FailureDescription failure)

تُبلغ عن استدعاء غير مكتمل بسبب خطأ ما.

final void invocationFailed(Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

void invocationSkipped(SkipReason reason)

الإبلاغ عن طلب استدعاء كطلب تم تخطّيه

final void invocationStarted(IInvocationContext context)

أدوات مراقبة عمليات الاستدعاء لإعادة التوجيه

final boolean isDisabled()

تعرِض هذه الدالة القيمة True إذا كان العنصر بأكمله غير مفعَّل (يتم تخطّي كلّ من الإعداد والتفكيك).

final void logAssociation(String dataName, LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile).

يعدِّل الربط بخدمة تسجيل الدخول إلى الاختبار.

processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)

يمكنك تنفيذ هذه الطريقة لتجميع المقاييس والسجلّات في جميع الاختبارات.

abstract processRunMetricsAndLogs( rawMetrics, runLogs)

نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس والسجلات الحالية.

processTestMetricsAndLogs(TestDescription testDescription, testMetrics, testLogs)

يمكنك تنفيذ هذه الطريقة لنشر المقاييس والسجلّات من كل اختبار.

final void setLogSaver(ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

void setUp()

يمكنك إلغاء هذه الطريقة في معالجات ما بعد المعالجة الفرعية لبدء التشغيل قبل تنفيذ الاختبار.

final void testAssumptionFailure(TestDescription test, String trace)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة

final void testEnded(TestDescription test, long endTime, testMetrics)

بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً.

final void testEnded(TestDescription test, testMetrics)

تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية.

final void testFailed(TestDescription test, FailureDescription failure)

الإبلاغ عن تعذُّر اختبار فردي

final void testFailed(TestDescription test, String trace)

الإبلاغ عن تعذُّر اختبار فردي

final void testIgnored(TestDescription test)

يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.

final void testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)

استخدِم هذه الطريقة لتسجيل ملف من عملية تنفيذ PostProcessor.

final void testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

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

final void testModuleEnded()

تقدم تقريرًا بنهاية تشغيل وحدة.

final void testModuleStarted(IInvocationContext moduleContext)

الإبلاغ عن بدء تشغيل وحدة

final void testRunEnded(long elapsedTime, runMetrics)

الإبلاغ عن نهاية عملية الاختبار

final void testRunFailed(FailureDescription failure)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ وصفه FailureDescription.

final void testRunFailed(String errorMessage)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.

final void testRunStarted(String runName, int testCount, int attemptNumber)

الإبلاغ عن بدء عملية تنفيذ اختبار

final void testRunStarted(String runName, int testCount)

اختبار عمليات معاودة الاتصال

final void testRunStarted(String runName, int testCount, int attemptNumber, long startTime)

الإبلاغ عن بدء عملية تنفيذ اختبار

final void testRunStopped(long elapsedTime)

توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.

final void testSkipped(TestDescription test, SkipReason reason)

يتم طلبه عند تخطي الاختبار وعدم تنفيذه لسبب غير متوقَّع عادةً.

final void testStarted(TestDescription test, long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.

final void testStarted(TestDescription test)

طلبات معاودة الاتصال لحالات الاختبار

الطرق المحمية

void cleanUp()
MetricMeasurement.DataType getMetricType()

ويمكنك إلغاء هذه الطريقة لتغيير نوع المقياس إذا لزم الأمر.

String getRunName()

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

BasePostProcessor

public BasePostProcessor ()

الطرق العامة

init

public final ITestInvocationListener init (ITestInvocationListener listener)

خطوة الإعداد لمحرر الصور. يتم ضمان استدعائه قبل أي من طلبات إعادة الاتصال في الاختبارات.

المعلمات
listener ITestInvocationListener

المرتجعات
ITestInvocationListener

invocationEnded

public final void invocationEnded (long elapsedTime)

تُستخدَم لتسجيل انتهاء طلب الاستدعاء، سواءً بنجاح أو بسبب خطأ.

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

المعلمات
elapsedTime ‫long: الوقت المنقضي منذ بدء الطلب بالملي ثانية

invocationFailed

public final void invocationFailed (FailureDescription failure)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

المعلمات
failure FailureDescription: FailureDescription الذي يصف سبب تعذُّر التنفيذ

invocationFailed

public final void invocationFailed (Throwable cause)

الإبلاغ عن طلب غير مكتمل بسبب بعض حالات الخطأ

سيتم استدعاؤه تلقائيًا بواسطة إطار عمل الاتحاد التجاري.

المعلمات
cause Throwable: Throwable سبب الخطأ

invocationSkipped

public void invocationSkipped (SkipReason reason)

الإبلاغ عن طلب استدعاء كطلب تم تخطّيه

المعلمات
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

أدوات مراقبة عمليات الاستدعاء لإعادة التوجيه

المعلمات
context IInvocationContext: معلومات عن الاستدعاء

isDisabled

public final boolean isDisabled ()

تعرِض هذه الدالة القيمة True إذا كان العنصر بأكمله غير مفعَّل (يتم تخطّي كلّ من الإعداد والتفكيك). خطأ في الحالات الأخرى.

المرتجعات
boolean

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجلّ مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، ولكن لا يمكن إجراء ذلك في عملية callback المباشرة testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile). بالتالي، تسمح معاودة الاتصال هذه بتوفير ارتباط قوي بشكل صريح.

تعديل عملية ربط السجلّ بالاختبار إذا تم استدعاء هذه الطريقة أثناء اختبار، ينتمي السجل إلى الاختبار، وبخلاف ذلك، سيكون سجل تشغيل.

المعلمات
dataName String: اسم البيانات
logFile LogFile: السمة LogFile التي تم تسجيلها سابقًا والتي يجب ربطها بحالة الاختبار.

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

نفِّذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات. سيتم تسجيل المقاييس الناتجة عن هذه الطريقة على أنّها مقاييس عمليات التنفيذ. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع استخدام اسم مفتاح فريد (لا يُسمح بأي تضارب مع المفاتيح الحالية).

المعلمات
allTestMetrics ‫ListMultimap: HashMultimap لتخزين المقاييس من كل اختبار مجمّعة حسب أسماء المقاييس

allTestLogs : خريطة تخزّن خريطة كل اختبار لملفات السجلّ المدرَجة بأسماء بياناتها باستخدام TestDescription في كل اختبار كمفاتيح
المرتجعات
مجموعة المقاييس التي تم إنشاؤها حديثًا من جميع مقاييس الاختبار.

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس والسجلات الحالية. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، ويجب أن يكون لها اسم مفتاح فريد (لا يُسمح بحدوث تعارض مع المفاتيح الحالية).

المعلمات
rawMetrics : مجموعة المقاييس الأوّلية المتاحة للتنفيذ
runLogs : مجموعة ملفات السجلّ لتشغيل الاختبار
المرتجعات
مجموعة المقاييس التي تم إنشاؤها حديثًا من مقاييس التنفيذ.

ProcessTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

يمكنك تنفيذ هذه الطريقة لنشر المقاييس والسجلّات من كل اختبار. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، ويجب أن يكون لها اسم مفتاح فريد (لا يُسمح بحدوث تعارض مع مفاتيح الحالية).

المعلمات
testDescription TestDescription: عنصر TestDescription الذي يصف الاختبار
testMetrics : مجموعة المقاييس من الاختبار
testLogs : مجموعة الملفات التي تم تسجيلها أثناء الاختبار
المرتجعات
مجموعة المقاييس التي تم إنشاؤها حديثًا من مقاييس الاختبار

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

اضبط ILogSaver للسماح للمنفِّذ بحفظ الملفات.

المعلمات
logSaver ILogSaver: ILogSaver

setUp

public void setUp ()

يمكنك إلغاء هذه الطريقة في معالجات ما بعد المعالجة الفرعية لبدء التشغيل قبل تنفيذ الاختبار.

تعذُّر اختبار الافتراض

public final void testAssumptionFailure (TestDescription test, 
                String trace)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test TestDescription: لتحديد الاختبار
trace String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

يتمّ استدعاؤه عندما يُبلغ اختبار ذري عن أنّه يفترض شرطًا غير صحيح.

المعلمات
test TestDescription: لتحديد الاختبار
failure FailureDescription: FailureDescription يصف الخطأ وسياقه.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

بديل ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) حيث يمكننا تحديد وقت الانتهاء مباشرةً. يمكنك الجمع بين السمتَين testStarted(com.android.tradefed.result.TestDescription, long) وtestStarted(com.android.tradefed.result.TestDescription, long) لقياس الأداء بدقة.

المعلمات
test TestDescription: لتحديد الاختبار
endTime long: وقت انتهاء الاختبار، يتم قياسه من خلال System.currentTimeMillis()
testMetrics : ERROR(/Map) من المقاييس التي تمّ قياسها

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

يُبلِغ عن نهاية تنفيذ نموذج اختبار فردي.

إذا لم يتم استدعاء الدالة testFailed(TestDescription, FailureDescription)، يعني ذلك أنّه تم اجتياز هذا الاختبار. ويعرض أيضًا أي مقاييس مفتاح/قيمة قد تم إصدارها أثناء تنفيذ نموذج الاختبار.

المعلمات
test TestDescription: يحدد الاختبار
testMetrics : ERROR(/Map) من المقاييس التي تمّ قياسها

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

الإبلاغ عن تعذُّر حالة اختبار فردية

سيتمّ استدعاؤه بين testStarted وtestEnded.

المعلمات
test TestDescription: لتحديد الاختبار
failure FailureDescription: FailureDescription لوصف الخطأ وسياقه

testFailed

public final void testFailed (TestDescription test, 
                String trace)

الإبلاغ عن تعذُّر حالة اختبار فردية

سيتمّ استدعاؤه بين testStarted وtestEnded.

المعلمات
test TestDescription: لتحديد الاختبار
trace String: تتبُّع تسلسل استدعاء الدوال البرمجية للخطأ

testIgnored

public final void testIgnored (TestDescription test)

يتمّ استدعاؤه عندما لا يتمّ تنفيذ اختبار، وذلك بشكل عام لأنّ طريقة اختبار تمّت إضافة تعليق توضيحي إليها باستخدام علامة ‎@org.junit.Ignore.

المعلمات
test TestDescription: لتحديد الاختبار

testLog

public final void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

استخدِم هذه الطريقة لتسجيل ملف من عملية تنفيذ PostProcessor.

المعلمات
dataName String: اسم String وصفي للبيانات، مثل "device_logcat". ملاحظة: قد لا يكون dataName فريدًا لكلّ طلب. أي أنّه يجب أن يتمكّن مُنفّذو الإجراء من التعامل مع عدة طلبات باستخدام dataName نفسه.
dataType LogDataType: LogDataType البيانات
dataStream InputStreamSource: InputStreamSource البيانات على مُنفِّذي الإجراء استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية. على المُتصلين التأكّد من بقاء مصدر البيانات حاضرًا ويمكن الوصول إليه إلى أن تكتمل طريقة testLog.

testLogSaved

public final void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

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

يجب استخدامه بدلاً من ITestInvocationListener#testLog(String, LogDataType, InputStreamSource).

المعلمات
dataName String: اسم String وصفي للبيانات، مثل "device_logcat". ملاحظة: قد لا يكون dataName فريدًا لكلّ طلب. أي أنّه يجب أن يتمكّن مُنفّذو الإجراء من التعامل مع عدّة طلبات باستخدام dataName نفسه.
dataType LogDataType: LogDataType البيانات
dataStream InputStreamSource: InputStreamSource البيانات على مُنفِّذي الإجراء استدعاء createInputStream لبدء قراءة البيانات، والتأكّد من إغلاق InputStream الناتج عند اكتمال العملية.
logFile ‫LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ

وحدة اختبار انتهت

public final void testModuleEnded ()

الإبلاغ عن نهاية تشغيل وحدة

تم بدء الاختبار

public final void testModuleStarted (IInvocationContext moduleContext)

الإبلاغ عن بدء تشغيل وحدة ترتبط معاودة الاتصال هذه بـ testModuleEnded() وهي اختيارية في التسلسل. ولا يتم استخدامه إلا أثناء عملية تشغيل تستخدِم وحدات: برامج التشغيل المستندة إلى المجموعة.

المعلمات
moduleContext IInvocationContext: السمة IInvocationContext في الوحدة

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

الإبلاغ عن نهاية عملية الاختبار

المعلمات
elapsedTime ‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية
runMetrics : أزواج المفتاح/القيمة التي يتم الإبلاغ عنها في نهاية عملية الاختبار

testRunFailed

public final void testRunFailed (FailureDescription failure)

تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل FailureDescription.

المعلمات
failure FailureDescription: FailureDescription لوصف الخطأ وسياقه

testRunFailed

public final void testRunFailed (String errorMessage)

تعذّر إكمال تشغيل اختبار التقارير بسبب خطأ فادح.

المعلمات
errorMessage String: String يصف سبب تعذُّر التشغيل.

أمر testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

الإبلاغ عن بدء عملية تنفيذ اختبار

المعلمات
runName String: اسم إجراء الاختبار
testCount int: إجمالي عدد الاختبارات أثناء إجراء الاختبار
attemptNumber int: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدة مرات. تكون المحاولة الأولى مفهرسة بمقدار 0، ويجب أن تزيد كل مرة يتم فيها إجراء عملية جديدة. على سبيل المثال، تتم إعادة المحاولة بشكل دقيق 3 مرات لإجراء اختبار، ويجب أن يكون إجمالي عدد عمليات التنفيذ 4 تحت اسم runName نفسه، وأن يتراوح عدد المحاولات من 0 إلى 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

طلبات معاودة الاتصال في اختبار التنفيذ

المعلمات
runName String: اسم إجراء الاختبار
testCount int: إجمالي عدد الاختبارات أثناء إجراء الاختبار

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

الإبلاغ عن بدء عملية تنفيذ اختبار

المعلمات
runName String: اسم إجراء الاختبار
testCount int: إجمالي عدد الاختبارات أثناء إجراء الاختبار
attemptNumber int: رقم الطلب، الذي يحدِّد المحاولات المختلفة لنفس اسم التشغيل الذي تم تنفيذه عدة مرات. تكون المحاولة الأولى مفهرسة بمقدار 0، ويجب أن تزيد القيمة في كل مرة يتم إجراء عملية جديدة. على سبيل المثال، تتم إعادة المحاولة بشكل دقيق 3 مرات لإجراء اختبار، ويجب أن يتم إجراء 4 عمليات تشغيل بشكل إجمالي ضمن اسم runName نفسه، وأن يتراوح عدد المحاولات من 0 إلى 3.
startTime long: وقت بدء الجري، ويتم قياسه من خلال System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

توقّف تشغيل اختبار التقارير قبل اكتماله بناءً على طلب أحد المستخدِمين.

قائمة المهام: غير مستخدمة حاليًا، يمكنك إزالتها

المعلمات
elapsedTime ‫long: الوقت المنقضي الذي سجّله الجهاز، بالمللي ثانية

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

يتمّ استدعاء هذه الدالة عند تخطّي اختبار وعدم تنفيذه لسبب غير متوقّع عادةً. سيتمّ إعادة محاولة إجراء هذه الاختبارات لمحاولة الحصول على تنفيذ سليم.

المعلمات
test TestDescription: لتحديد الاختبار
reason SkipReason: SkipReason

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

بديل عن testStarted(com.android.tradefed.result.TestDescription) حيث نحدّد أيضًا وقت بدء الاختبار ، مع ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) لإجراء قياس دقيق.

المعلمات
test TestDescription: يحدد الاختبار
startTime long: وقت بدء الاختبار، ويتم قياسه من خلال System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

طلبات معاودة الاتصال بحالات الاختبار

المعلمات
test TestDescription: لتحديد الاختبار

الطرق المحمية

cleanUp

protected void cleanUp ()

getMetricType

protected MetricMeasurement.DataType getMetricType ()

ويمكنك إلغاء هذه الطريقة لتغيير نوع المقياس إذا لزم الأمر. يتم ضبط المقياس تلقائيًا على نوع المعالجة.

المرتجعات
MetricMeasurement.DataType

getRunName

protected String getRunName ()

المرتجعات
String