BasePostProcessor

public abstract class BasePostProcessor
extends Object implements IPostProcessor

java.lang.object
com.android.tradefed.postprocessor.BasePostProcessor


IPostProcessor پایه که هر پیاده سازی باید گسترش یابد. اطمینان حاصل کنید که روش‌های پردازش پست قبل از گزارش‌گران نتیجه نهایی فراخوانی شده‌اند.

خلاصه

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

BasePostProcessor ()

روش های عمومی

final ITestInvocationListener init ( ITestInvocationListener listener)

مرحله اولیه سازی پردازشگر پست.

final void invocationEnded (long elapsedTime)

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

final void invocationFailed ( FailureDescription failure)

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

final void invocationFailed (Throwable cause)

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

final void invocationStarted ( IInvocationContext context)

Invocation Listeners برای ارسال

final boolean isDisabled ()

اگر کل شی غیرفعال باشد، True را برمی‌گرداند (هر دو راه‌اندازی و حذف را رد کنید).

final void logAssociation (String dataName, LogFile logFile)

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

انجمن ورود به آزمون را به روز می کند.

processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs) processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, allTestLogs)

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

abstract processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs) processRunMetricsAndLogs ( rawMetrics, runLogs)

این روش را به منظور تولید مجموعه ای از معیارهای جدید از متریک ها و گزارش های موجود پیاده سازی کنید.

processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs) processTestMetricsAndLogs ( TestDescription testDescription, testMetrics, testLogs)

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

final void setLogSaver ( ILogSaver logSaver)

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

void setUp ()

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

final void testAssumptionFailure ( TestDescription test, String trace)

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

final void testAssumptionFailure ( TestDescription test, FailureDescription failure)

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

final void testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics)

جایگزینی برای ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) که می‌توانیم زمان پایان را مستقیماً مشخص کنیم.

final void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

final void testFailed ( TestDescription test, FailureDescription failure)

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

final void testFailed ( TestDescription test, String trace)

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

final void testIgnored ( TestDescription test)

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

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

از این روش برای ثبت یک فایل از پیاده سازی PostProcessor استفاده کنید.

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

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

final void testModuleEnded ()

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

final void testModuleStarted ( IInvocationContext moduleContext)

شروع یک ماژول در حال اجرا را گزارش می دهد.

final void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

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

final void testRunFailed ( FailureDescription failure)

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

final void testRunFailed (String errorMessage)

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

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

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

final void testRunStarted (String runName, int testCount)

تست پاسخ به تماس

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

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

final void testRunStopped (long elapsedTime)

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

final void testStarted ( TestDescription test, long startTime)

جایگزینی برای testStarted(com.android.tradefed.result.TestDescription) که در آن زمان شروع آزمایش را نیز مشخص می کنیم، همراه با ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) برای اندازه گیری دقیق .

final void testStarted ( TestDescription test)

موارد تست پاسخ به تماس

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

MetricMeasurement.DataType getMetricType ()

این روش را لغو کنید تا در صورت نیاز نوع متریک را تغییر دهید.

String getRunName ()

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

BasePostProcessor

public BasePostProcessor ()

روش های عمومی

init

public final ITestInvocationListener init (ITestInvocationListener listener)

مرحله اولیه سازی پردازشگر پست. اطمینان حاصل شود که قبل از هر یک از تست ها تماس گرفته می شود.

مولفه های
listener ITestInvocationListener

برمی گرداند
ITestInvocationListener

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

public final void invocationEnded (long elapsedTime)

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

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

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

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

public final void invocationFailed (FailureDescription failure)

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

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

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

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

public final void invocationFailed (Throwable cause)

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

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

مولفه های
cause Throwable : علت Throwable شکست

invocationStarted

public final void invocationStarted (IInvocationContext context)

Invocation Listeners برای ارسال

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

غیرفعال است

public final boolean isDisabled ()

اگر کل شی غیرفعال باشد، True را برمی‌گرداند (هر دو راه‌اندازی و حذف را رد کنید). در غیر این صورت نادرست است.

برمی گرداند
boolean

logAssociation

public final 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 که قبلاً ثبت شده است و باید با پرونده آزمایشی مرتبط شود.

processAllTestMetricsAndLogs

public  processAllTestMetricsAndLogs (ListMultimap<String, MetricMeasurement.Metric> allTestMetrics, 
                 allTestLogs)

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

مولفه های
allTestMetrics ListMultimap : HashMultimap که معیارهای مربوط به هر آزمون را به صورت گروه‌بندی شده بر اساس نام‌های متریک ذخیره می‌کند.

allTestLogs : نقشه‌ای که نقشه هر آزمون از فایل‌های گزارش را که با نام داده‌هایشان کلید می‌خورد، ذخیره می‌کند و از TestDescription هر آزمون به عنوان کلید استفاده می‌کند.

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

processRunMetricsAndLogs

public abstract  processRunMetricsAndLogs ( rawMetrics, 
                 runLogs)

این روش را به منظور تولید مجموعه ای از معیارهای جدید از متریک ها و گزارش های موجود پیاده سازی کنید. فقط معیارهای جدید ایجاد شده باید برگردانده شوند، و با نام کلید منحصر به فرد (هیچ برخورد با کلیدهای موجود مجاز نیست).

مولفه های
rawMetrics : مجموعه معیارهای خام موجود برای اجرا.

runLogs : مجموعه فایل های گزارش برای اجرای آزمایشی.

برمی گرداند
مجموعه معیارهای جدید تولید شده از معیارهای اجرا.

processTestMetricsAndLogs

public  processTestMetricsAndLogs (TestDescription testDescription, 
                 testMetrics, 
                 testLogs)

این روش را برای ارسال معیارهای پردازش و گزارش‌های مربوط به هر آزمون اجرا کنید. فقط معیارهای جدید ایجاد شده باید برگردانده شوند، و با نام کلید منحصر به فرد (هیچ برخورد با کلیدهای موجود مجاز نیست).

مولفه های
testDescription TestDescription : شی TestDescription که تست را توصیف می کند.

testMetrics : مجموعه معیارهای آزمون.

testLogs : مجموعه فایل های ثبت شده در طول آزمون.

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

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

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

مولفه های
logSaver ILogSaver : ILogSaver

برپایی

public void setUp ()

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

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

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

trace String : رد پای شکست

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

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

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

تست پایان یافت

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

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

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

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

testMetrics : یک ERROR(/Map) از معیارهای منتشر شده

تست شکست خورد

public final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

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

تست شکست خورد

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

trace String : رد پای شکست

تست نادیده گرفته شد

public final void testIgnored (TestDescription test)

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

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

testLog

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

از این روش برای ثبت یک فایل از پیاده سازی PostProcessor استفاده کنید.

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

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

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

testLogSaved

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

testModuleEnded

public final void testModuleEnded ()

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

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

مولفه های
moduleContext IInvocationContext : IInvocationContext ماژول.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public final void testRunFailed (String errorMessage)

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

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

testRunStarted

public final 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 final void testRunStarted (String runName, 
                int testCount)

تست پاسخ به تماس

مولفه های
runName String : نام اجرای آزمایشی

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

testRunStarted

public final 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 final void testRunStopped (long elapsedTime)

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

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

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

تست شروع شد

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

موارد تست پاسخ به تماس

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

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

getMetricType

protected MetricMeasurement.DataType getMetricType ()

این روش را لغو کنید تا در صورت نیاز نوع متریک را تغییر دهید. متریک به طور پیش فرض روی نوع پردازش شده تنظیم شده است.

برمی گرداند
MetricMeasurement.DataType

getRunName

protected String getRunName ()

برمی گرداند
String