GranularRetriableTestWrapper

public class GranularRetriableTestWrapper
extends Object implements IRemoteTest , ITestCollector

شیء جاوا
↳	com.android.tradefed.testtype.suite.GranularRetriableTestWrapper

---

یک کلاس wrapper روی IRemoteTest کار می‌کند تا IRemoteTest را در سطح testcase دانه‌بندی کند. یک IRemoteTest می‌تواند شامل چندین testcase باشد. پیش از این، این testcaseها به عنوان یک کل در نظر گرفته می‌شدند: وقتی IRemoteTest اجرا می‌شود، همه testcaseها اجرا می‌شوند. برخی از IRemoteTestها (آنهایی که ITestFilterReceiver را پیاده‌سازی می‌کنند) می‌توانند یک لیست مجاز از testcaseها را بپذیرند و فقط آن testcaseها را اجرا کنند. این کلاس از ویژگی موجود بهره می‌برد و روشی انعطاف‌پذیرتر برای اجرای مجموعه تست ارائه می‌دهد.

• می‌توان یک نمونه آزمایشی واحد را چندین بار (در همان اجرای 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, int targetPreparerRetryCount)

روش‌های عمومی
void	backfillMissingEvents ( ITestInvocationListener listener, FailureDescription failure)
final int	getExpectedTestsCount () تعداد موارد آزمایشی (testcases) را در IRemoteTest محاسبه کنید.
final	getFinalTestRunResults () نتایج ادغام‌شده‌ی TestRunResults را از هر اجرای IRemoteTest دریافت کنید.
final	getPassedTests ()
ModuleListener	getResultListener () شنونده‌ای را برمی‌گرداند که شامل تمام نتایج است.
int	getRetryCount ()
void	run ( TestInformation testInfo, ITestInvocationListener listener) یک سری از IRemoteTest.run(TestInformation, ITestInvocationListener) را زمان‌بندی کنید.
void	setCollectTestsOnly (boolean shouldCollectTest) حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند
void	setInvocationContext ( IInvocationContext moduleInvocationContext) IInvocationContext به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.
void	setLogSaver ( ILogSaver logSaver) ILogSaver ماژول را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.
void	setMarkTestsSkipped (boolean skipTestCases) ModuleDefinition RunStrategy را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.
void	setMetricCollectors ( runMetricCollectors) runMetricCollector مربوط به ModuleDefinition را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.
void	setModuleConfig ( IConfiguration moduleConfiguration) ویژگی 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, 
                int targetPreparerRetryCount)

پارامترها
test	IRemoteTest
module	ModuleDefinition
mainListener	ITestInvocationListener
maxRunLimit	int
useModuleResultsForwarder	boolean
removeModuleBuffering	boolean
targetPreparerRetryCount	int

روش‌های عمومی

رویدادهای از دست رفته

public void backfillMissingEvents (ITestInvocationListener listener, 
                FailureDescription failure)

پارامترها
listener	ITestInvocationListener
failure	FailureDescription

تعداد تست‌های مورد انتظار را دریافت کنید

public final int getExpectedTestsCount ()

تعداد موارد آزمایشی را در IRemoteTest محاسبه کنید. این مقدار، موارد آزمایشی یکسانی را که چندین بار مجدداً زمان‌بندی شده‌اند، متمایز می‌کند.

بازگشت‌ها
int

دریافت نتایج نهایی تست/اجرا

public final  getFinalTestRunResults ()

نتایج ادغام‌شده‌ی TestRunResults را از هر اجرای IRemoteTest دریافت کنید.

بازگشت‌ها

دریافت آزمون‌های پذیرفته‌شده

public final  getPassedTests ()

بازگشت‌ها

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

فقط تست‌های جمع‌آوری‌شده

public void setCollectTestsOnly (boolean shouldCollectTest)

حالت جمع‌آوری تست را فعال یا غیرفعال می‌کند

setInvocationContext

public void setInvocationContext (IInvocationContext moduleInvocationContext)

IInvocationContext به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.

پارامترها
moduleInvocationContext	IInvocationContext : این wrapper در صورت لزوم از InvocationContext برای مقداردهی اولیه MetricCollector استفاده می‌کند.

تنظیم لاگ سیور

public void setLogSaver (ILogSaver logSaver)

ILogSaver ماژول را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.

پارامترها
logSaver	ILogSaver : شنونده‌های هر اجرای آزمایشی باید گزارش‌ها را ذخیره کنند.

setMarkTestsپرش‌شده

public void setMarkTestsSkipped (boolean skipTestCases)

ModuleDefinition RunStrategy را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.

پارامترها
skipTestCases	boolean : آیا باید از تست کیس‌ها صرف نظر کرد یا خیر.

مجموعه‌جمع‌کننده‌های متریک

public void setMetricCollectors ( runMetricCollectors)

runMetricCollector مربوط به ModuleDefinition را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.

پارامترها
runMetricCollectors	: فهرستی از MetricCollector برای ماژول.

پیکربندی ماژول

public void setModuleConfig (IConfiguration moduleConfiguration)

ویژگی ModuleDefinition را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.

پارامترها
moduleConfiguration	IConfiguration : معیارهای ماژول را ارائه می‌دهد.

شناسه ماژول را تنظیم کنید

public void setModuleId (String moduleId)

نام ModuleDefinition را به عنوان یک ویژگی GranularRetriableTestWrapper تنظیم کنید.

پارامترها
moduleId	String : نام ماژول تعریف شده.

setRetryDecision

public void setRetryDecision (IRetryDecision decision)

IRetryDecision مورد استفاده را تنظیم می‌کند.

پارامترها
decision	IRetryDecision