ResultDBRreporter

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

java.lang.object
↳	com.android.tradefed.result.resultdb.ResultDBReporter

---

گزارشگر نتیجه که نتایج آزمایش را در ResultDB آپلود می کند.

خلاصه

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

روش های عمومی
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 logFile) در برخی موارد، log باید به شدت با موارد آزمایشی مرتبط باشد، اما این فرصت در testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) امکان پذیر نیست.
void	setConfiguration ( IConfiguration configuration) IConfiguration در حال استفاده را تزریق می کند.
void	setLogSaver ( ILogSaver logSaver) ILogSaver را طوری تنظیم کنید که به پیاده‌کننده اجازه دهد فایل‌ها را ذخیره کند.
boolean	supportGranularResults () اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است.
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, testMetrics) پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.
void	testFailed ( TestDescription test, FailureDescription failure) گزارش شکست یک مورد آزمایشی فردی.
void	testFailed ( TestDescription test, String trace) گزارش شکست یک مورد آزمایشی فردی.
void	testIgnored ( TestDescription test) زمانی که آزمایشی اجرا نمی‌شود نامیده می‌شود، معمولاً به این دلیل که یک روش تست با org.junit.Ignore حاشیه‌نویسی می‌شود.
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد.
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	testRunStopped (long elapsedTime) اجرای آزمایشی گزارش‌ها قبل از تکمیل به دلیل درخواست کاربر متوقف شد.
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) شروع یک مورد آزمایشی فردی را گزارش می دهد.

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

ResultDBRreporter

public ResultDBReporter ()

روش های عمومی

دریافت خلاصه

public TestSummary getSummary ()

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

برمی گرداند
TestSummary	یک TestSummary که اجرا یا null را خلاصه می کند

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

public void invocationEnded (long elapsedTime)

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

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

پارامترها
elapsedTime	long : زمان سپری شده فراخوانی در ms

فراخوان ناموفق بود

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

invocationStarted

public void invocationStarted (IInvocationContext context)

شروع فراخوانی آزمون را گزارش می دهد.

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

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

پیکربندی set

public void setConfiguration (IConfiguration configuration)

IConfiguration در حال استفاده را تزریق می کند.

پارامترها
configuration	IConfiguration

setLogSaver

public void setLogSaver (ILogSaver logSaver)

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

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

supportGranular Results

public boolean supportGranularResults ()

اگر گزارشگر از نتایج گرانول پشتیبانی کند درست است، در غیر این صورت نادرست است.

برمی گرداند
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, 
                 testMetrics)

پایان اجرای یک مورد آزمایشی فردی را گزارش می کند.

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

پارامترها
test	TestDescription : تست را مشخص می کند
testMetrics	: یک 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 : تست را مشخص می کند

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

گزارش مربوطه یا داده های اشکال زدایی را از فراخوانی آزمایشی ارائه می دهد.

باید قبل از ERROR(/ITestInvocationListener#invocationFailed(Throwable)) یا ERROR(/ITestInvocationListener#invocationEnded(long)) فراخوانی شود

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

پارامترها
dataName	String : نام توصیفی String از داده ها. به عنوان مثال "device_logcat". توجه داشته باشید dataName ممکن است در هر فراخوان منحصر به فرد نباشد. به عنوان مثال، پیاده‌کننده‌ها باید بتوانند چندین تماس را با یک dataName مدیریت کنند
dataType	LogDataType : LogDataType داده ها
dataStream	InputStreamSource : InputStreamSource داده ها. پیاده‌کننده‌ها باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و از بسته شدن InputStream حاصل پس از تکمیل اطمینان حاصل کنند. تماس‌گیرندگان باید اطمینان حاصل کنند که منبع داده‌ها تا زمانی که روش testLog کامل نشود، موجود و قابل دسترسی است.

testModuleEnded

public void testModuleEnded ()

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

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

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

پارامترها
moduleContext	IInvocationContext : IInvocationContext ماژول.

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

گزارش پایان اجرای آزمایشی

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

اجرای آزمایشی گزارش ها به دلیل یک خطای مهلک انجام نشد.

پارامترها
errorMessage	String : String که دلیل شکست اجرا را توضیح می دهد.

testRunStarted

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

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

پارامترها
runName	String : نام اجرای آزمایشی
testCount	int : تعداد کل تست ها در اجرای آزمایشی
attemptNumber	int : شماره سفارش، شناسایی تلاش‌های مختلف یک runName که چندین بار اجرا می‌شوند. تلاش Number با 0 ایندکس شده است و باید هر بار که اجرای جدیدی اتفاق می افتد افزایش یابد. به عنوان مثال، یک تست 3 بار به صورت دانه ای تکرار می شود، باید 4 اجرا در مجموع تحت همان runName داشته باشد و numberNumber از 0 تا 3 باشد.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

testRunStarted

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

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

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

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: در حال حاضر استفاده نشده است، حذف را در نظر بگیرید

پارامترها
elapsedTime	long : دستگاه زمان سپری شده را بر حسب میلی ثانیه گزارش کرد

تست رد شد

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)

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

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