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

public class TextResultReporter
extends InvocationToJUnitResultForwarder implements ILogSaverListener , ITestInvocationListener

شیء جاوا
↳ com.android.tradefed.result.InvocationToJUnitResultForwarder
↳ com.android.tradefed.result.TextResultReporter

یک گزارشگر نتایج آزمایش که نتایج را به چاپگر متن نتیجه JUnit ارسال می‌کند.

خلاصه

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

TextResultReporter ()

یک TextResultReporter ایجاد می‌کند.

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

void testAssumptionFailure ( TestDescription testId, String trace)

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

void testEnded ( TestDescription testId, HashMap<String, MetricMeasurement.Metric> metrics)

برای چاپ صریح معیارهای آزمایشی، والد را نادیده می‌گیرد.

void testFailed ( TestDescription testId, String trace)

برای چاپ صریح خطاهای رخ داده، والد را نادیده می‌گیرد.

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

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

void testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)

زمانی که گزارش آزمایش ذخیره می‌شود، فراخوانی می‌شود.

void testRunEnded (long elapsedTime, HashMap<String, MetricMeasurement.Metric> metrics)

برای چاپ صریح معیارها، والد را نادیده می‌گیرد.

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

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

public TextResultReporter ()

یک TextResultReporter ایجاد می‌کند.

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

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

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

trace String : ردپای پشته از خرابی

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

public void testEnded (TestDescription testId, 
                HashMap<String, MetricMeasurement.Metric> metrics)

برای چاپ صریح معیارهای آزمایشی، والد را نادیده می‌گیرد.

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

metrics HashMap : Map از معیارهای منتشر شده

تست ناموفق 

public void testFailed (TestDescription testId, 
                String trace)

تابع والد را برای چاپ صریح شکست‌ها نادیده می‌گیرد. ResultPrinter برای انجام این کار به دونده‌ای که در پایان اجرای تست "print" را فراخوانی می‌کند، متکی است. شکست یک مورد تست منفرد را گزارش می‌دهد.

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

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

trace String : ردپای پشته از خرابی

تست لاگ 

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

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

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

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

پارامترها
dataName String : یک نام توصیفی String از داده‌ها. مثلاً "device_logcat". توجه داشته باشید که dataName ممکن است در هر فراخوانی منحصر به فرد نباشد. یعنی پیاده‌سازی‌کنندگان باید بتوانند چندین فراخوانی را با همان dataName مدیریت کنند.

dataType LogDataType : نوع داده‌ی LogDataType

dataStream InputStreamSource : InputStreamSource داده‌ها. پیاده‌سازی‌کنندگان باید createInputStream را برای شروع خواندن داده‌ها فراخوانی کنند و اطمینان حاصل کنند که InputStream حاصل را پس از اتمام ببندند. فراخوانی‌کنندگان باید اطمینان حاصل کنند که منبع داده‌ها تا زمان تکمیل متد testLog موجود و در دسترس باقی می‌ماند.

testLogذخیره شده 

public 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 که شامل متا دیتای فایل ذخیره شده است.

تست اجرا شده 

public void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> metrics)

برای چاپ صریح معیارها، والد را نادیده می‌گیرد.

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

metrics HashMap : جفت‌های کلید-مقدار که در پایان اجرای تست با Metric گزارش می‌شوند.