GranularRetriableTestWrapper

public class GranularRetriableTestWrapper
extends Object implements IRemoteTest, ITestCollector

java.lang.Object
↳	com.android.tradefed.testtype.suite.GranularRetriableTestWrapper

---

تعمل فئة التغليف على IRemoteTest لتجزئة IRemoteTest على مستوى حالة الاختبار. يمكن أن يحتوي IRemoteTest على عدة حالات اختبار. في السابق، كانت حالات الاختبار هذه تُعامل كوحدة واحدة: عند تشغيل IRemoteTest، سيتم تشغيل جميع حالات الاختبار. يمكن لبعض واجهات IRemoteTest (التي تنفّذ ITestFilterReceiver) قبول قائمة مسموح بها لحالات الاختبار وتنفيذ حالات الاختبار هذه فقط. تستفيد هذه الفئة من الميزة الحالية وتوفّر طريقة أكثر مرونة لتشغيل مجموعة الاختبارات.

• يمكن إعادة محاولة تنفيذ حالة اختبار واحدة عدة مرات (ضمن عملية تنفيذ IRemoteTest نفسها) لتقليل معدلات حالات التعذّر التي لا ترتبط بخطأ في الاختبار.
• يتم جمع حالات الاختبار التي تمت إعادة محاولة تنفيذها بشكل ديناميكي من حالات التعذّر في عمليات التشغيل السابقة.

ملاحظة:

• الشرط الأساسي لتشغيل مجموعة فرعية من حالات الاختبار هو أن ينفّذ نوع الاختبار الواجهة ITestFilterReceiver.
• X هو الحد الأقصى المخصّص لعدد مرات إعادة المحاولة.

ملخّص

الصفوف المتداخلة
class	GranularRetriableTestWrapper.StartEndCollector أداة مساعدة الصف لتحديد بداية ونهاية التشغيل المفقودتَين

طُرق وضع التصميم العامة
GranularRetriableTestWrapper(IRemoteTest test, ITestInvocationListener mainListener, int maxRunLimit)
GranularRetriableTestWrapper(IRemoteTest test, ModuleDefinition module, ITestInvocationListener mainListener, int maxRunLimit)
GranularRetriableTestWrapper(IRemoteTest test, ModuleDefinition module, ITestInvocationListener mainListener, int maxRunLimit, boolean useModuleResultsForwarder, boolean removeModuleBuffering, boolean collectKernelLog, int targetPreparerRetryCount)

الإجراءات العامة
void	backfillMissingEvents(ITestInvocationListener listener, FailureDescription failure)
final int	getExpectedTestsCount() احسب عدد حالات الاختبار في IRemoteTest.
final List<TestRunResult>	getFinalTestRunResults() احصل على نتائج TestRunResults المدمجة من كل عملية تنفيذ IRemoteTest.
final Set<TestDescription>	getPassedTests()
ModuleListener	getResultListener() تعرض المستمع الذي يحتوي على جميع النتائج.
int	getRetryCount()
void	run(TestInformation testInfo, ITestInvocationListener listener) جدولة سلسلة من IRemoteTest.run(TestInformation,ITestInvocationListener)
void	setCollectTestsOnly(boolean shouldCollectTest) تفعيل وضع جمع الاختبارات أو إيقافه
void	setDefaultLogCollectors(List<IMetricCollector> collectors)
void	setInvocationContext(IInvocationContext moduleInvocationContext) اضبط IInvocationContext كسمة GranularRetriableTestWrapper.
void	setLogSaver(ILogSaver logSaver) اضبط ILogSaver الوحدة النمطية كسمة GranularRetriableTestWrapper.
void	setMarkTestsSkipped(boolean skipTestCases) اضبط ModuleDefinition RunStrategy كسمة GranularRetriableTestWrapper.
void	setMetricCollectors(List<IMetricCollector> runMetricCollectors) اضبط runMetricCollector الخاص بـ ModuleDefinition كسمة GranularRetriableTestWrapper.
void	setModuleConfig(IConfiguration moduleConfiguration) اضبط ModuleConfig الخاص بـ ModuleDefinition كسمة GranularRetriableTestWrapper.
void	setModuleId(String moduleId) اضبط اسم ModuleDefinition كسمة GranularRetriableTestWrapper.
void	setRetryDecision(IRetryDecision decision) تضبط هذه السمة IRetryDecision التي سيتم استخدامها.

طُرق وضع التصميم العامة

GranularRetriableTestWrapper

public GranularRetriableTestWrapper (IRemoteTest test, 
                ITestInvocationListener mainListener, 
                int maxRunLimit)

المعلَمات
test	IRemoteTest
mainListener	ITestInvocationListener
maxRunLimit	int

GranularRetriableTestWrapper

public GranularRetriableTestWrapper (IRemoteTest test, 
                ModuleDefinition module, 
                ITestInvocationListener mainListener, 
                int maxRunLimit)

المعلَمات
test	IRemoteTest
module	ModuleDefinition
mainListener	ITestInvocationListener
maxRunLimit	int

GranularRetriableTestWrapper

public GranularRetriableTestWrapper (IRemoteTest test, 
                ModuleDefinition module, 
                ITestInvocationListener mainListener, 
                int maxRunLimit, 
                boolean useModuleResultsForwarder, 
                boolean removeModuleBuffering, 
                boolean collectKernelLog, 
                int targetPreparerRetryCount)

المعلَمات
test	IRemoteTest
module	ModuleDefinition
mainListener	ITestInvocationListener
maxRunLimit	int
useModuleResultsForwarder	boolean
removeModuleBuffering	boolean
collectKernelLog	boolean
targetPreparerRetryCount	int

الإجراءات العامة

backfillMissingEvents

public void backfillMissingEvents (ITestInvocationListener listener, 
                FailureDescription failure)

المعلَمات
listener	ITestInvocationListener
failure	FailureDescription

getExpectedTestsCount

public final int getExpectedTestsCount ()

احسب عدد حالات الاختبار في IRemoteTest. تفرّق هذه القيمة بين حالات الاختبار نفسها التي تمت إعادة جدولتها عدة مرات.

المرتجعات
int

getFinalTestRunResults

public final List<TestRunResult> getFinalTestRunResults ()

احصل على نتائج TestRunResults المدمجة من كل عملية تنفيذ IRemoteTest.

المرتجعات
List<TestRunResult>

getPassedTests

public final Set<TestDescription> getPassedTests ()

المرتجعات
Set<TestDescription>

getResultListener

public ModuleListener getResultListener ()

تعرض المستمع الذي يحتوي على جميع النتائج.

المرتجعات
ModuleListener

getRetryCount

public int getRetryCount ()

المرتجعات
int

ضربة طويلة

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

جدولة سلسلة من IRemoteTest.run(TestInformation,ITestInvocationListener)

المعلَمات
testInfo	TestInformation: عنصر TestInformation يحتوي على معلومات مفيدة لتنفيذ الاختبارات.
listener	‫ITestInvocationListener: أداة معالجة ResultForwarder التي تحتوي على moduleListener جديد لكل عملية تشغيل.

عمليات الطرح
DeviceNotAvailableException

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

تفعيل وضع جمع الاختبارات أو إيقافه

setDefaultLogCollectors

public void setDefaultLogCollectors (List<IMetricCollector> collectors)

المعلَمات
collectors	List

setInvocationContext

public void setInvocationContext (IInvocationContext moduleInvocationContext)

اضبط IInvocationContext كسمة GranularRetriableTestWrapper.

المعلَمات
moduleInvocationContext	IInvocationContext: يستخدم برنامج تضمين MetricCollector السمة InvocationContext لتهيئة السمة MetricCollector عند الضرورة.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

اضبط ILogSaver الوحدة النمطية كسمة GranularRetriableTestWrapper.

المعلَمات
logSaver	ILogSaver: يجب أن يحفظ المستمعون لكل عملية اختبار السجلات.

setMarkTestsSkipped

public void setMarkTestsSkipped (boolean skipTestCases)

اضبط ModuleDefinition RunStrategy كسمة GranularRetriableTestWrapper.

المعلَمات
skipTestCases	boolean: ما إذا كان يجب تخطّي حالات الاختبار.

setMetricCollectors

public void setMetricCollectors (List<IMetricCollector> runMetricCollectors)

اضبط runMetricCollector الخاص بـ ModuleDefinition كسمة GranularRetriableTestWrapper.

المعلَمات
runMetricCollectors	List: قائمة بـ MetricCollector للوحدة.

setModuleConfig

public void setModuleConfig (IConfiguration moduleConfiguration)

اضبط ModuleConfig الخاص بـ ModuleDefinition كسمة GranularRetriableTestWrapper.

المعلَمات
moduleConfiguration	IConfiguration: تقديم مقاييس الوحدة

setModuleId

public void setModuleId (String moduleId)

اضبط اسم ModuleDefinition كسمة GranularRetriableTestWrapper.

المعلَمات
moduleId	String: اسم moduleDefinition.

setRetryDecision

public void setRetryDecision (IRetryDecision decision)

تضبط هذه السمة IRetryDecision التي سيتم استخدامها.

المعلَمات
decision	IRetryDecision