گزارشگر نتایج

public class ResultReporter
extends Object implements IConfigurationReceiver , ILogSaverListener , ISupportGranularResults , ITestSummaryListener

شیء جاوا
↳	com.google.android.tradefed.result.teststorage.ResultReporter

---

خلاصه

کلاس‌های تو در تو
class	ResultReporter.ListBuilder <T>

ثابت‌ها
String	DEFAULT_BUILDPROVIDER
String	EXPERIMENTAL
String	SYSTEM_CHECKER
String	TRADEFED

سازندگان عمومی
ResultReporter ()

روش‌های عمومی
void	enableFilterProperty (boolean enableFilterProperty)
IConfiguration	getConfiguration ()
TestSummary	getSummary () به InvocationListener اجازه می‌دهد تا خلاصه‌ای را برگرداند.
void	invocationEnded (long elapsedTime) گزارش می‌دهد که فراخوانی، چه با موفقیت و چه به دلیل وجود برخی خطاها، خاتمه یافته است.
void	invocationFailed ( FailureDescription failure) به دلیل وجود برخی شرایط خطا، فراخوانی ناقص را گزارش می‌دهد.
void	invocationFailed (Throwable cause) به دلیل وجود برخی شرایط خطا، فراخوانی ناقص را گزارش می‌دهد.
void	invocationSkipped ( SkipReason reason) یک فراخوانی را به عنوان رد شده گزارش می‌دهد
void	invocationStarted ( IInvocationContext context) شروع فراخوانی تست را گزارش می‌دهد.
void	logAssociation (String dataName, LogFile log) در برخی موارد، log باید به شدت با یک مورد آزمایشی مرتبط باشد، اما امکان انجام این کار در فراخوانی مستقیم testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) امکان‌پذیر نیست.
void	putEarlySummary ( summaries) یک ERROR(/List) از TestSummary های غیر تهی را ارسال می‌کند که ممکن است از هر ITestInvocationListener نمونه‌سازی شده به عنوان بخشی از پیکربندی، بازگردانده شده باشند.
void	setConfiguration ( IConfiguration configuration) IConfiguration مورد استفاده را تزریق می‌کند.
void	setLogSaver ( ILogSaver logSaver) ILogSaver را طوری تنظیم کنید که به پیاده‌سازی‌کننده اجازه دهد فایل‌ها را ذخیره کند.
boolean	supportGranularResults () اگر گزارشگر از نتایج جزئی پشتیبانی کند، مقدار True و در غیر این صورت مقدار False را برمی‌گرداند.
void	testAssumptionFailure ( TestDescription test, String trace) زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.
void	testEnded ( TestDescription test, long endTime, testMetrics) جایگزینی برای ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) که در آن می‌توانیم زمان پایان را مستقیماً مشخص کنیم.
void	testEnded ( TestDescription test, metrics) پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.
void	testFailed ( TestDescription test, FailureDescription failure) گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.
void	testFailed ( TestDescription test, String trace) گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.
void	testIgnored ( TestDescription test) زمانی فراخوانی می‌شود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیه‌نویسی شده است.
void	testModuleEnded () پایان اجرای یک ماژول را گزارش می‌دهد.
void	testModuleStarted ( IInvocationContext moduleContext) شروع اجرای یک ماژول را گزارش می‌دهد.
void	testRunEnded (long elapsedTimeMillis, runMetrics) پایان اجرای آزمایش را گزارش می‌دهد.
void	testRunFailed ( FailureDescription failure) گزارش می‌دهد که اجرای آزمایشی به دلیل خرابی شرح داده شده توسط FailureDescription ، با شکست مواجه شده است.
void	testRunFailed (String errorMessage) گزارش‌ها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.
void	testRunStarted (String runName, int testCount, int attemptNumber) شروع یک آزمایش را گزارش می‌دهد.
void	testRunStarted (String runName, int testCount) شروع یک آزمایش را گزارش می‌دهد.
void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) شروع یک آزمایش را گزارش می‌دهد.
void	testSkipped ( TestDescription test, SkipReason reason) زمانی فراخوانی می‌شود که یک تست نادیده گرفته شده و به دلیلی که معمولاً انتظار نمی‌رود، اجرا نشده است.
void	testStarted ( TestDescription test, long startTime) جایگزینی برای testStarted(com.android.tradefed.result.TestDescription) که در آن زمان شروع تست را نیز مشخص می‌کنیم، و برای اندازه‌گیری دقیق‌تر با ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) ترکیب می‌شود.
void	testStarted ( TestDescription test) شروع یک مورد آزمایشی (test case) منفرد را گزارش می‌دهد.

روش‌های محافظت‌شده
ITestStorageClient	createTestStorageClient ( IInvocationContext context)
String	getVersion ()

ثابت‌ها

ارائه دهنده پیش فرض ساخت

public static final String DEFAULT_BUILDPROVIDER

مقدار ثابت: "androidbuild"

تجربی

public static final String EXPERIMENTAL

مقدار ثابت: "آزمایشی"

بررسی‌کننده سیستم

public static final String SYSTEM_CHECKER

مقدار ثابت: "system_checker"

تریدفد

public static final String TRADEFED

مقدار ثابت: "معامله شده"

سازندگان عمومی

گزارشگر نتایج

public ResultReporter ()

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

ویژگی enableFilter

public void enableFilterProperty (boolean enableFilterProperty)

پارامترها
enableFilterProperty	boolean

دریافت پیکربندی

public IConfiguration getConfiguration ()

بازگشت‌ها
IConfiguration

خلاصه دریافت

public TestSummary getSummary ()

به InvocationListener اجازه می‌دهد تا خلاصه‌ای را برگرداند.

بازگشت‌ها
TestSummary	یک TestSummary که خلاصه‌ای از اجرا را نشان می‌دهد، یا null

فراخوان پایان یافت

public void invocationEnded (long elapsedTime)

گزارش می‌دهد که فراخوانی، چه با موفقیت و چه به دلیل وجود برخی خطاها، خاتمه یافته است.

به طور خودکار توسط چارچوب TradeFederation فراخوانی خواهد شد.

پارامترها
elapsedTime	long : زمان سپری شده از فراخوانی بر حسب میلی‌ثانیه

فراخوانی ناموفق

public void invocationFailed (FailureDescription failure)

به دلیل وجود برخی شرایط خطا، فراخوانی ناقص را گزارش می‌دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی خواهد شد.

پارامترها
failure	FailureDescription : FailureDescription علت خرابی را توصیف می‌کند.

فراخوانی ناموفق

public void invocationFailed (Throwable cause)

به دلیل وجود برخی شرایط خطا، فراخوانی ناقص را گزارش می‌دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی خواهد شد.

پارامترها
cause	Throwable : علت Throwable خرابی

فراخوانی رد شد

public void invocationSkipped (SkipReason reason)

یک فراخوانی را به عنوان رد شده گزارش می‌دهد

پارامترها
reason	SkipReason

فراخوان شروع شد

public void invocationStarted (IInvocationContext context)

شروع فراخوانی تست را گزارش می‌دهد.

به طور خودکار توسط چارچوب TradeFederation فراخوانی می‌شود. گزارشگران برای پشتیبانی از گزارش‌دهی چندین دستگاه، باید این متد را بازنویسی کنند.

پارامترها
context	IInvocationContext : اطلاعاتی درباره فراخوانی

انجمن ورود به سیستم

public void logAssociation (String dataName, 
                LogFile log)

در برخی موارد، log باید به شدت با یک مورد آزمایشی مرتبط باشد، اما امکان انجام این کار در فراخوانی مستقیم testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) امکان‌پذیر نیست. بنابراین، این فراخوانی امکان ارائه یک ارتباط قوی را به طور صریح فراهم می‌کند.

پارامترها
dataName	String : نام داده
log	LogFile : LogFile که قبلاً لاگ شده و باید با مورد آزمایشی مرتبط باشد.

خلاصه اولیه

public void putEarlySummary ( summaries)

یک ERROR(/List) از TestSummary های غیر تهی را ارسال می‌کند که ممکن است از هر ITestInvocationListener نمونه‌سازی شده به عنوان بخشی از پیکربندی بازگردانده شده باشند. خلاصه‌های اولیه پس از ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) ایجاد می‌شوند و می‌توانند در پایان فراخوانی از طریق ERROR(/#putSummary(List)) تکمیل شوند.

این قبل از ITestInvocationListener.invocationStarted(com.android.tradefed.invoker.IInvocationContext) فراخوانی می‌شود و شامل تمام خلاصه‌های listenerهایی است که قبل از آن پیکربندی شده‌اند.

پارامترها
summaries	: یک ERROR(/List) از TestSummary های غیر تهی از ITestInvocationListener هایی که بخشی از پیکربندی فعلی هستند.

پیکربندی set

public void setConfiguration (IConfiguration configuration)

IConfiguration مورد استفاده را تزریق می‌کند.

پارامترها
configuration	IConfiguration

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

public void setLogSaver (ILogSaver logSaver)

ILogSaver را طوری تنظیم کنید که به پیاده‌سازی‌کننده اجازه دهد فایل‌ها را ذخیره کند.

پارامترها
logSaver	ILogSaver : ILogSaver

پشتیبانی از نتایج گرانولار

public boolean supportGranularResults ()

اگر گزارشگر از نتایج جزئی پشتیبانی کند، مقدار True و در غیر این صورت مقدار False را برمی‌گرداند.

بازگشت‌ها
boolean

آزمون فرض شکست

public void testAssumptionFailure (TestDescription test, 
                String trace)

زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.

پارامترها
test	TestDescription : تست را مشخص می‌کند.
trace	String : ردپای پشته از خرابی

آزمون فرض شکست

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

زمانی فراخوانی می‌شود که یک آزمایش اتمی، شرطی را نادرست فرض کند.

پارامترها
test	TestDescription : تست را مشخص می‌کند.
failure	FailureDescription : FailureDescription خرابی و زمینه آن را توصیف می‌کند.

آزمون پایان یافت

public 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 void testEnded (TestDescription test, 
                 metrics)

پایان اجرای یک مورد آزمایشی (test case) را گزارش می‌دهد.

اگر testFailed(TestDescription, FailureDescription) فراخوانی نشده باشد، این تست با موفقیت انجام شده است. همچنین هر معیار کلید/مقداری را که ممکن است در طول اجرای مورد تست منتشر شده باشد، برمی‌گرداند.

پارامترها
test	TestDescription : تست را مشخص می‌کند.
metrics	: یک ERROR(/Map) از معیارهای منتشر شده

تست ناموفق

public void testFailed (TestDescription test, 
                FailureDescription failure)

گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.

بین testStarted و testEnded فراخوانی خواهد شد.

پارامترها
test	TestDescription : تست را مشخص می‌کند.
failure	FailureDescription : FailureDescription خرابی و زمینه آن را توصیف می‌کند.

تست ناموفق

public void testFailed (TestDescription test, 
                String trace)

گزارش شکست یک مورد آزمایشی منفرد را می‌دهد.

بین testStarted و testEnded فراخوانی خواهد شد.

پارامترها
test	TestDescription : تست را مشخص می‌کند.
trace	String : ردپای پشته از خرابی

آزمون نادیده گرفته شد

public void testIgnored (TestDescription test)

زمانی فراخوانی می‌شود که یک تست اجرا نخواهد شد، عموماً به این دلیل که یک متد تست با org.junit.Ignore حاشیه‌نویسی شده است.

پارامترها
test	TestDescription : تست را مشخص می‌کند.

testModuleEnd

public void testModuleEnded ()

پایان اجرای یک ماژول را گزارش می‌دهد.

ماژول تست شروع شد

public void testModuleStarted (IInvocationContext moduleContext)

شروع اجرای یک ماژول را گزارش می‌دهد. این فراخوانی با testModuleEnded() مرتبط است و در دنباله اختیاری است. فقط در طول اجرایی که از اجراکننده‌های مبتنی بر modules: suite استفاده می‌کند، استفاده می‌شود.

پارامترها
moduleContext	IInvocationContext : همان IInvocationContext مربوط به ماژول است.

تست اجرا شده

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

پایان اجرای آزمایش را گزارش می‌دهد.

پارامترها
elapsedTimeMillis	long : زمان سپری شده گزارش شده توسط دستگاه، بر حسب میلی ثانیه
runMetrics	جفت‌های کلید-مقدار که در پایان اجرای تست گزارش می‌شوند

تست اجرا ناموفق

public void testRunFailed (FailureDescription failure)

گزارش می‌دهد که اجرای آزمایشی به دلیل خرابی شرح داده شده توسط FailureDescription ، با شکست مواجه شده است.

پارامترها
failure	FailureDescription : FailureDescription خرابی و زمینه آن را توصیف می‌کند.

تست اجرا ناموفق

public void testRunFailed (String errorMessage)

گزارش‌ها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.

پارامترها
errorMessage	String : String دلیل عدم موفقیت در اجرا را توصیف می‌کند.

تست شروع شد

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

شروع یک آزمایش را گزارش می‌دهد.

پارامترها
runName	String : نام اجرای آزمایشی
testCount	int : تعداد کل تست‌ها در اجرای تست
attemptNumber	int : شماره ترتیب، که تلاش‌های مختلف یک runName را که چندین بار اجرا شده‌اند، مشخص می‌کند. شماره تلاش با اندیس ۰ اندیس‌گذاری شده است و باید هر بار که یک اجرای جدید اتفاق می‌افتد، افزایش یابد. به عنوان مثال، یک تست ۳ بار به صورت جزئی تکرار می‌شود، باید ۴ بار در کل تحت یک runName اجرا شود و شماره تلاش از ۰ تا ۳ است.

تست شروع شد

public void testRunStarted (String runName, 
                int testCount)

شروع یک آزمایش را گزارش می‌دهد.

پارامترها
runName	String : نام اجرای آزمایشی
testCount	int : تعداد کل تست‌ها در اجرای تست

تست شروع شد

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

شروع یک آزمایش را گزارش می‌دهد.

پارامترها
runName	String : نام اجرای آزمایشی
testCount	int : تعداد کل تست‌ها در اجرای تست
attemptNumber	int : شماره ترتیب، که تلاش‌های مختلف یک runName را که چندین بار اجرا شده‌اند، مشخص می‌کند. شماره تلاش با اندیس ۰ اندیس‌گذاری شده است و باید هر بار که یک اجرای جدید اتفاق می‌افتد، افزایش یابد. به عنوان مثال، یک تست ۳ بار به صورت جزئی تکرار می‌شود، باید ۴ بار در کل تحت یک runName اجرا شود و شماره تلاش از ۰ تا ۳ است.
startTime	long : زمان شروع اجرا، که از طریق System.currentTimeMillis() اندازه‌گیری می‌شود.

آزمون رد شد

public void testSkipped (TestDescription test, 
                SkipReason reason)

زمانی فراخوانی می‌شود که یک تست نادیده گرفته شده و به دلیلی که معمولاً انتظار نمی‌رود، اجرا نشده باشد. این تست‌ها برای اجرای مجدد تلاش خواهند کرد تا به طور صحیح اجرا شوند.

پارامترها
test	TestDescription : تست را مشخص می‌کند.
reason	SkipReason : SkipReason

تست شروع شد

public 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 void testStarted (TestDescription test)

شروع یک مورد آزمایشی (test case) را گزارش می‌دهد. رابط قدیمی‌تر، باید در صورت امکان testStarted(com.android.tradefed.result.TestDescription) استفاده کند.

پارامترها
test	TestDescription : تست را مشخص می‌کند.

روش‌های محافظت‌شده

ایجاد TestStorageClient

protected ITestStorageClient createTestStorageClient (IInvocationContext context)

پارامترها
context	IInvocationContext

بازگشت‌ها
ITestStorageClient

دریافت نسخه

protected String getVersion ()

بازگشت‌ها
String