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

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

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationFailed

public final void invocationFailed (FailureDescription failure)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

invocationFailed

public final void invocationFailed (Throwable cause)

تعرض هذه السمة عملية استدعاء غير مكتملة بسبب حدوث خطأ.

سيتم استدعاؤه تلقائيًا من خلال إطار عمل TradeFederation.

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

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

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

testAssumptionFailure

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) للحصول على قياس دقيق.

المعلمات
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 الذي يحتوي على البيانات الوصفية للملف المحفوظ

testModuleEnded

public final void testModuleEnded ()

تسجّل هذه السمة نهاية عملية تنفيذ وحدة.

testModuleStarted

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

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

testRunStopped

public final void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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