ماژول نتایج و معیارها

public class ModuleResultsAndMetricsForwarder
extends ResultAndLogForwarder

شیء جاوا
↳ com.android.tradefed.result.ResultForwarder
↳ com.android.tradefed.result.ResultAndLogForwarder
↳ com.android.tradefed.result.ModuleResultsAndMetricsForwarder

افزونه‌ای از ResultAndLogForwarder که معیارهای مرتبط با ماژول اضافی را به نتایج آزمون اضافه می‌کند.

خلاصه

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

ModuleResultsAndMetricsForwarder ( ITestInvocationListener... listeners)

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

void setAttemptIsolation ( CurrentInvocation.IsolationGrade isolation)

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

void setMarkTestsSkipped (boolean skip)

آیا تمام موارد آزمون رد شده علامت گذاری شوند یا خیر.

void setModuleId (String moduleId)
void setTestMappingSources (List<String> testMappingSources)

منابع نگاشت آزمون را که در معیارها درج خواهند شد، تنظیم می‌کند.

void testEnded ( TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)

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

void testEnded ( TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)

جایگزینی برای testEnded(TestDescription,Map) که در آن می‌توانیم زمان پایان را مستقیماً مشخص کنیم.

void testFailed ( TestDescription test, FailureDescription failure)

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

void testFailed ( TestDescription test, String trace)

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

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

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

void testRunEnded (long elapsedTimeMillis, Map<String, String> runMetrics)
void testRunFailed ( FailureDescription failure)

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

void testRunFailed (String errorMessage)

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

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

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

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

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

void testStarted ( TestDescription test, long startTime)

جایگزینی برای testStarted(TestDescription) که در آن زمان شروع تست را نیز مشخص می‌کنیم، و برای اندازه‌گیری دقیق‌تر با testEnded(TestDescription,long,Map) ترکیب می‌شود.

void testStarted ( TestDescription test)

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

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

ماژول نتایج و معیارها 

public ModuleResultsAndMetricsForwarder (ITestInvocationListener... listeners)

پارامترها
listeners ITestInvocationListener

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

جداسازی تلاش تنظیم‌شده 

public void setAttemptIsolation (CurrentInvocation.IsolationGrade isolation)

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

پارامترها
isolation CurrentInvocation.IsolationGrade

setMarkTestsپرش‌شده 

public void setMarkTestsSkipped (boolean skip)

آیا تمام موارد آزمون رد شده علامت گذاری شوند یا خیر.

پارامترها
skip boolean

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

public void setModuleId (String moduleId)

پارامترها
moduleId String

منابع setTestMapping 

public void setTestMappingSources (List<String> testMappingSources)

منابع نگاشت آزمون را که در معیارها درج خواهند شد، تنظیم می‌کند.

پارامترها
testMappingSources List

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

public void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

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

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

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

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

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

public void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

جایگزینی برای testEnded(TestDescription,Map) که در آن می‌توانیم زمان پایان را مستقیماً مشخص کنیم. برای اندازه‌گیری دقیق‌تر، آن را با testStarted(TestDescription,long) ترکیب کنید.

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

endTime long : زمان پایان تست، که از طریق System.currentTimeMillis() اندازه‌گیری می‌شود.

testMetrics HashMap : 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 testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

پایان اجرای تست را گزارش می‌دهد. رفع مشکل: ما نمی‌توانیم دو رابط Map<> با انواع مختلف داشته باشیم، بنابراین باید از HashMap در اینجا استفاده کنیم.

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

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

تست اجرا شده 

public void testRunEnded (long elapsedTimeMillis, 
                Map<String, String> runMetrics)

پارامترها
elapsedTimeMillis long

runMetrics Map

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

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, 
                int attemptNumber, 
                long startTime)

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

پارامترها
runName String : نام اجرای آزمایشی

testCount int : تعداد کل تست‌ها در اجرای تست

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

startTime long : زمان شروع اجرا، که از طریق System.currentTimeMillis() اندازه‌گیری می‌شود.

تست شروع شد 

public void testStarted (TestDescription test, 
                long startTime)

جایگزینی برای testStarted(TestDescription) که در آن زمان شروع تست را نیز مشخص می‌کنیم، و برای اندازه‌گیری دقیق‌تر با testEnded(TestDescription,long,Map) ترکیب می‌شود.

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

startTime long : زمان شروع تست، که از طریق System.currentTimeMillis() اندازه‌گیری می‌شود.

تست شروع شد 

public void testStarted (TestDescription test)

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

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