LegacySubprocessResultsReporter

public final class LegacySubprocessResultsReporter
extends SubprocessResultsReporter

شیء جاوا
↳	com.android.tradefed.result.SubprocessResultsReporter
	↳	com.android.tradefed.result.LegacySubprocessResultsReporter

---

یک پیاده‌سازی متوقف‌شده از گزارشگر نتایج زیرفرآیند که باید با وجود تغییرات در سوپرکلاس خود، با نسخه‌های قبلی TF/CTS (مثلاً ۸+) سازگار باقی بماند.

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

خلاصه

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

سازنده‌های محافظت‌شده
LegacySubprocessResultsReporter (boolean installHandler)

روش‌های عمومی
void	invocationEnded (long elapsedTime) گزارش می‌دهد که فراخوانی، چه با موفقیت و چه به دلیل وجود برخی خطاها، خاتمه یافته است.
void	invocationFailed (Throwable cause) به دلیل وجود برخی شرایط خطا، فراخوانی ناقص را گزارش می‌دهد.
void	invocationStarted ( IBuildInfo buildInfo)
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	setLogSaver ( ILogSaver logSaver)
void	testAssumptionFailure ( TestIdentifier testId, String trace)
void	testEnded ( TestIdentifier testId, metrics)
void	testEnded ( TestIdentifier testId, long endTime, metrics)
void	testFailed ( TestIdentifier testId, String reason)
void	testIgnored ( TestIdentifier testId)
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testModuleEnded () پایان اجرای یک ماژول را گزارش می‌دهد.
void	testModuleStarted ( IInvocationContext moduleContext) شروع اجرای یک ماژول را گزارش می‌دهد.
void	testRunEnded (long time, runMetrics) پایان اجرای آزمایش را گزارش می‌دهد.
void	testRunFailed (String reason) گزارش‌ها حاکی از آن است که اجرای آزمایشی به دلیل یک خطای مهلک با شکست مواجه شده است.
void	testRunStarted (String runName, int testCount) شروع یک آزمایش را گزارش می‌دهد.
void	testStarted ( TestIdentifier testId)
void	testStarted ( TestIdentifier testId, long startTime)

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

LegacySubprocessResultsReporter

public LegacySubprocessResultsReporter ()

سازنده‌های محافظت‌شده

LegacySubprocessResultsReporter

protected LegacySubprocessResultsReporter (boolean installHandler)

پارامترها
installHandler	boolean

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

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

public void invocationEnded (long elapsedTime)

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

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

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

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

public void invocationFailed (Throwable cause)

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

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

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

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

public void invocationStarted (IBuildInfo buildInfo)

پارامترها
buildInfo	IBuildInfo

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

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 که قبلاً لاگ شده و باید با مورد آزمایشی مرتبط باشد.

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

public void setLogSaver (ILogSaver logSaver)

پارامترها
logSaver	ILogSaver

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

public void testAssumptionFailure (TestIdentifier testId, 
                String trace)

پارامترها
testId	TestIdentifier
trace	String

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

public void testEnded (TestIdentifier testId, 
                 metrics)

پارامترها
testId	TestIdentifier
metrics

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

public void testEnded (TestIdentifier testId, 
                long endTime, 
                 metrics)

پارامترها
testId	TestIdentifier
endTime	long
metrics

تست ناموفق

public void testFailed (TestIdentifier testId, 
                String reason)

پارامترها
testId	TestIdentifier
reason	String

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

public void testIgnored (TestIdentifier testId)

پارامترها
testId	TestIdentifier

testLogذخیره شده

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

پارامترها
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testModuleEnd

public void testModuleEnded ()

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

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

public void testModuleStarted (IInvocationContext moduleContext)

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

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

تست اجرا شده

public void testRunEnded (long time, 
                 runMetrics)

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

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

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

public void testRunFailed (String reason)

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

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

تست شروع شد

public void testRunStarted (String runName, 
                int testCount)

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

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

تست شروع شد

public void testStarted (TestIdentifier testId)

پارامترها
testId	TestIdentifier

تست شروع شد

public void testStarted (TestIdentifier testId, 
                long startTime)

پارامترها
testId	TestIdentifier
startTime	long