معالج 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)
في بعض الحالات، يجب أن يكون السجل مرتبطًا ارتباطًا وثيقًا بحالات الاختبار، إلا أن فرصة إجراء
لذلك في يعدِّل الربط بخدمة تسجيل الدخول إلى الاختبار. |
|
processAllTestMetricsAndLogs(ListMultimap<String, MetricMeasurement.Metric> allTestMetrics,
نفِّذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات. |
abstract
|
processRunMetricsAndLogs(
نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس الحالية والسجلات. |
|
processTestMetricsAndLogs(TestDescription testDescription,
نفِّذ هذه الطريقة لنشر مقاييس العملية والسجلات من كل اختبار. |
final
void
|
setLogSaver(ILogSaver logSaver)
يمكنك ضبط |
void
|
setUp()
يمكنك إلغاء هذه الطريقة في معالِجات النشر الفرعية للتهيئة قبل إجراء الاختبار. |
final
void
|
testAssumptionFailure(TestDescription test, String trace)
يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة |
final
void
|
testAssumptionFailure(TestDescription test, FailureDescription failure)
يتم استدعاء هذه الوظيفة عندما يُبلغ الاختبار الذري عن أنها تفترض حالة خاطئة |
final
void
|
testEnded(TestDescription test, long endTime,
بديل عن |
final
void
|
testEnded(TestDescription test,
تعمل هذه السياسة على الإبلاغ عن نهاية تنفيذ حالة اختبار فردية. |
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,
نهاية تشغيل اختبار التقارير |
final
void
|
testRunFailed(FailureDescription failure)
تعذّر إكمال تشغيل اختبار التقارير بسبب تعذُّر وصفه من قِبل |
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)
بديل عن |
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
publicprocessAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)
نفِّذ هذه الطريقة لتجميع المقاييس والسجلات في جميع الاختبارات. المقاييس القادمة من هذه الطريقة سيتم اعتبارها أداة الإبلاغ على أنها مقاييس تشغيل. يجب أن تكون المقاييس التي تم إنشاؤها حديثًا فقط ويحمل اسم مفتاح فريد (لا يسمح بأي تضارب مع المفاتيح الحالية).
المعلمات | |
---|---|
allTestMetrics |
ListMultimap : خريطة HashMultimap لتخزين المقاييس من كل اختبار مجمَّعة حسب المقياس
الأسماء. |
allTestLogs |
: خريطة تخزِّن خريطة كل اختبار من ملفات السجلّات المرتبطة بأسماء بياناتها
باستخدام TestDescription لكل اختبار كمفاتيح. |
المرتجعات | |
---|---|
|
مجموعة المقاييس التي تم إنشاؤها حديثًا من جميع مقاييس الاختبار. |
عمليةProcessRunMetricsAndLogs
public abstractprocessRunMetricsAndLogs ( rawMetrics, runLogs)
نفِّذ هذه الطريقة لإنشاء مجموعة من المقاييس الجديدة من المقاييس الحالية والسجلات. يجب عرض المقاييس التي تم إنشاؤها حديثًا فقط، مع اسم مفتاح فريد (لا التعارض مع المفاتيح الحالية).
المعلمات | |
---|---|
rawMetrics |
: مجموعة المقاييس الأولية المتاحة للتشغيل. |
runLogs |
: مجموعة ملفات السجلّ الخاصة بإجراء الاختبار |
المرتجعات | |
---|---|
|
مجموعة المقاييس التي تم إنشاؤها حديثًا من مقاييس التنفيذ. |
ProcessTestMetricsAndLogs
publicprocessTestMetricsAndLogs (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 |