معالج 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)

في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في 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.تجاهل.

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 ()

الطرق العامة

إعداد

public final ITestInvocationListener init (ITestInvocationListener listener)

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

المعلمات
listener ITestInvocationListener

المرتجعات
ITestInvocationListener

تم إنهاء الاستدعاء

public final void invocationEnded (long elapsedTime)

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

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

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

تعذّر الاستدعاء

public final void invocationFailed (FailureDescription failure)

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

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

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

تعذّر الاستدعاء

public final void invocationFailed (Throwable cause)

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

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

المعلمات
cause Throwable: السبب Throwable للتعذُّر

تم تخطّي الاستدعاء

public void invocationSkipped (SkipReason reason)

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

المعلمات
reason SkipReason

تم بدء الاستدعاء

public final void invocationStarted (IInvocationContext context)

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

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

تم إيقاف

public final boolean isDisabled ()

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

المرتجعات
boolean

مؤسسة Log Association

public final void logAssociation (String dataName, 
                LogFile logFile)

في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء لذلك في 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

إعداد

public void setUp ()

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

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

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

trace String: تتبع تسلسل استدعاء الدوال البرمجية للفشل

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

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

failure FailureDescription: FailureDescription يصف الخطأ وسياقه.

انتهى الاختبار

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

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

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

endTime long: وقت انتهاء الاختبار، ويتم قياسه من خلال System.currentTimeMillis()

testMetrics : ERROR(/Map) من المقاييس المنبعثة

انتهى الاختبار

public final void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testMetrics : ERROR(/Map) من المقاييس المنبعثة

فشل الاختبار

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

failure FailureDescription: FailureDescription يصف الخطأ وسياقه.

فشل الاختبار

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String: تتبع تسلسل استدعاء الدوال البرمجية للفشل

تم تجاهل الاختبار

public final void testIgnored (TestDescription test)

يتم استدعاء هذا الإجراء عندما لا يتم إجراء الاختبار، وعادةً ما يكون هناك تعليق توضيحي لطريقة الاختبار org.junit.تجاهل.

المعلمات
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 لبدء قراءة البيانات، والتأكد من إغلاق EnterStream عند الاكتمال. على المتصلين التأكّد من بقاء مصدر البيانات. موجودة ويمكن الوصول إليها حتى تكتمل طريقة testLog.

تم حفظ سجلّ الاختبار

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 لبدء قراءة البيانات، والتأكد من إغلاق EnterStream عند الاكتمال.

logFile LogFile: LogFile الذي يحتوي على البيانات الوصفية للملف المحفوظ.

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

public final void testModuleEnded ()

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

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

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

اختبار RunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

نهاية تشغيل اختبار التقارير فيكس: لا يمكننا استخدام خريطتين<> وواجهات برمجة تطبيقات من نوع مختلف، لذلك ينبغي لنا استخدام HashMap هنا.

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

runMetrics : يتم الإبلاغ عن أزواج المفتاح/القيمة في نهاية عملية اختبار باستخدام Metric.

اختبار التشغيل فاشل

public final void testRunFailed (FailureDescription failure)

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

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

اختبار التشغيل فاشل

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: رقم الطلب، مع تحديد المحاولات المختلفة لعملية runName نفسها يتم تشغيلها عدة مرات. تكون المحاولة رقم 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: رقم الطلب، مع تحديد المحاولات المختلفة لعملية runName نفسها يتم تشغيلها عدة مرات. تكون محاولة الحساب مفهرسة بمقدار 0 ويجب أن تزيد في كل مرة تشغيل جديد. مثلاً: تتم إعادة محاولة الاختبار بدقة 3 مرات، ومن المفترض أن يتضمن إجمالي 4 نقاط. تحت نفس runName ، ويتراوح عدد المحاولة بين 0 و3.

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

testRunStopped

public final void testRunStopped (long elapsedTime)

تم إيقاف تشغيل اختبار التقارير قبل اكتماله بسبب طلب من المستخدم.

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

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

تم تخطي الاختبار

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

reason SkipReason: SkipReason

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

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()

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

public final void testStarted (TestDescription test)

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

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

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

تنظيف

protected void cleanUp ()

الطريقة getMetricType

protected MetricMeasurement.DataType getMetricType ()

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

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

الحصول على RunName

protected String getRunName ()

المرتجعات
String