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.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,
تقارير نهاية عملية الاختبار |
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 ()
الطُرق العامة
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
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 |
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 |
|