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) رد الاتصال testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) غير ممكن.

يقوم بتحديث اقتران السجل للاختبار.

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

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

abstract processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs)

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

processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) 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) testEnded ( TestDescription test, long endTime, testMetrics)

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

final void testEnded ( TestDescription test, testMetrics) 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) 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)

حالات الاختبار الاسترجاعات

الأساليب المحمية

MetricMeasurement.DataType getMetricType ()

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

String getRunName ()

المقاولين العامة

BasePostProcessor

public BasePostProcessor ()

الأساليب العامة

فيه

public final ITestInvocationListener init (ITestInvocationListener listener)

خطوة تهيئة المعالج اللاحق. التأكد من أن يتم استدعاؤه قبل أي من عمليات الاسترجاعات الخاصة بالاختبارات.

حدود
listener ITestInvocationListener

عائدات
ITestInvocationListener

انتهت الدعوة

public final void invocationEnded (long elapsedTime)

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

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

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

فشل الاستدعاء

public final void invocationFailed (FailureDescription failure)

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

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

حدود
failure FailureDescription : FailureDescription الذي يصف سبب الفشل

فشل الاستدعاء

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 : معلومات حول الاستدعاء

معطل

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) رد الاتصال 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 ()

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

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 الذي يصف الفشل وسياقه.

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

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 : تتبع مكدس الفشل

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 قد لا يكون فريدًا لكل استدعاء. أي يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات

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 قد لا يكون فريدًا لكل استدعاء. أي يجب أن يكون المنفذون قادرين على التعامل مع مكالمات متعددة بنفس اسم البيانات

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)

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

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

testRunStopped

public final void testRunStopped (long elapsedTime)

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

TODO: غير مستخدم حاليًا، فكر في الإزالة

حدود
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 : يحدد الاختبار

الأساليب المحمية

getMetricType

protected MetricMeasurement.DataType getMetricType ()

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

عائدات
MetricMeasurement.DataType

getRunName

protected String getRunName ()

عائدات
String