परिणाम फारवर्डर

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.Object
↳	com.android.tradefed.result.ResultForwarder

ज्ञात प्रत्यक्ष उपवर्ग FilteredResultForwarder , JarHostTest.HostTestListener , LogSaverResultForwarder , LogcatCrashResultForwarder , PythonBinaryHostTest.PythonForwarder , ResultAndLogForwarder , RetryResultForwarder , ShardMainResultForwarder , TestTimeoutEnforcer फ़िल्टर किए गए परिणाम फ़ॉरवर्डर ResultForwarder का वैरिएंट जो केवल TestDescription की अनुमति वाली सूची को रिपोर्ट करने की अनुमति देता है। JarHostTest.HostTestListener रैपर श्रोता जो एम्बेडेड श्रोता को testRunStarted() और testRunEnded() को छोड़कर सभी घटनाओं को अग्रेषित करता है। लॉगसेवर रिजल्ट फारवर्डर वैश्विक फ़ाइल सेवर के साथ लॉग सहेजने के लिए एक ResultForwarder । LogcatCrashResultForwarder विशेष श्रोता: विफलताओं (इंस्ट्रूमेंटेशन प्रोसेस क्रैशिंग) पर यह लॉगकैट क्रैश से निकालने का प्रयास करेगा और इसे परीक्षण से जुड़े विफलता संदेश में जोड़ देगा। PythonBinaryHostTest.PythonForwarder रन नाम को बाइनरी नाम से बदलने के लिए परिणाम फारवर्डर। परिणाम और लॉग फारवर्डर परिणाम और लॉग घटनाओं के लिए फारवर्डर। RetryResultForwarder ResultForwarder का एक एक्सटेंशन जो हमेशा किसी दिए गए प्रयास नंबर पर पुश करता है। ShardMainResultForwarder एक ResultForwarder जो शार्प्ड टेस्ट इनवोकेशन के परिणामों को जोड़ता है। TestTimeoutEnforcer श्रोता जो किसी दिए गए परीक्षण मामले के निष्पादन समय की जांच करने की अनुमति देता है और यदि यह किसी दिए गए समय से अधिक हो जाता है तो इसे विफल कर देता है।

ज्ञात अप्रत्यक्ष उपवर्ग GranularRetriableTestWrapper.StartEndCollector , RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector लापता रन स्टार्ट और एंड को पकड़ने के लिए क्लास हेल्पर। RetryLogSaverResultForwarder फारवर्डर जो हमारे वर्तमान प्रयास को पास करने का काम भी संभालता है।

---

एक ITestInvocationListener जो मंगलाचरण परिणामों को अन्य श्रोताओं की सूची में अग्रेषित करता है।

सारांश

सार्वजनिक निर्माणकर्ता
ResultForwarder ( listeners) ResultForwarder ( listeners) एक ResultForwarder बनाएँ।
ResultForwarder ( ITestInvocationListener... listeners) ResultForwarder के लिए वैकल्पिक चर arg कन्स्ट्रक्टर।

संरक्षित निर्माणकर्ता
ResultForwarder () आस्थगित श्रोता सेटिंग के साथ एक ResultForwarder बनाएँ।

सार्वजनिक तरीके
TestSummary	getSummary () इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।
void	invocationEnded (long elapsedTime) रिपोर्ट करता है कि आमंत्रण समाप्त हो गया है, चाहे सफलतापूर्वक या कुछ त्रुटि स्थिति के कारण।
void	invocationFailed ( FailureDescription failure) कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।
void	invocationFailed (Throwable cause) कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।
void	invocationStarted ( IInvocationContext context) परीक्षण आमंत्रण की शुरुआत की रिपोर्ट करता है।
void	testAssumptionFailure ( TestDescription test, String trace) कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है
void	testAssumptionFailure ( TestDescription test, FailureDescription failure) कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है
void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) का विकल्प जहां हम अंत समय को सीधे निर्दिष्ट कर सकते हैं।
void	testEnded ( TestDescription test, testMetrics) 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 elapsedTime, runMetrics) testRunEnded (long elapsedTime, 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	testStarted ( TestDescription test, long startTime) testStarted(com.android.tradefed.result.TestDescription) का विकल्प जहां हम सटीक माप के ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) साथ मिलकर यह भी निर्दिष्ट करते हैं कि परीक्षण कब शुरू किया गया था .
void	testStarted ( TestDescription test) एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है।

संरक्षित तरीके
	getListeners () श्रोताओं की सूची प्राप्त करें।
void	setListeners ( ITestInvocationListener... listeners) निर्माण के बाद श्रोताओं को सेट करें।
void	setListeners ( listeners) setListeners ( listeners) निर्माण के बाद श्रोताओं को सेट करें।

सार्वजनिक निर्माणकर्ता

परिणाम फारवर्डर

public ResultForwarder ( listeners)

एक ResultForwarder बनाएँ।

पैरामीटर
listeners	: परिणामों को अग्रेषित करने के लिए वास्तविक ITestInvocationListener s

परिणाम फारवर्डर

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder के लिए वैकल्पिक चर arg कन्स्ट्रक्टर।

पैरामीटर
listeners	ITestInvocationListener : परिणामों को अग्रेषित करने के लिए वास्तविक ITestInvocationListener s

संरक्षित निर्माणकर्ता

परिणाम फारवर्डर

protected ResultForwarder ()

आस्थगित श्रोता सेटिंग के साथ एक ResultForwarder बनाएँ। केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

सार्वजनिक तरीके

getSummary

public TestSummary getSummary ()

इनवोकेशन लिस्टनर को सारांश वापस करने की अनुमति देता है।

रिटर्न
TestSummary	रन, या शून्य का सारांश देने वाला एक TestSummary

मंगलाचरणसमाप्त

public void invocationEnded (long elapsedTime)

रिपोर्ट करता है कि आमंत्रण समाप्त हो गया है, चाहे सफलतापूर्वक या कुछ त्रुटि स्थिति के कारण।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
elapsedTime	long : एमएस में मंगलाचरण का बीता हुआ समय

मंगलाचरण विफल

public void invocationFailed (FailureDescription failure)

कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
failure	FailureDescription : FailureDescription विफलता के कारण का वर्णन करता है

मंगलाचरण विफल

public void invocationFailed (Throwable cause)

कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
cause	Throwable : ERROR(/Throwable) विफलता का कारण

मंगलाचरण प्रारंभ

public void invocationStarted (IInvocationContext context)

परीक्षण आमंत्रण की शुरुआत की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा। एकाधिक डिवाइस रिपोर्टिंग का समर्थन करने के लिए रिपोर्टरों को इस विधि को ओवरराइड करने की आवश्यकता है।

पैरामीटर
context	IInvocationContext : मंगलाचरण के बारे में जानकारी

परीक्षण धारणा विफलता

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 : परीक्षण समाप्त होने का समय, ERROR(/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)

व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

टेस्टस्टार्टेड और टेस्टएंडेड के बीच कॉल किया जाएगा।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है
failure	FailureDescription : FailureDescription विफलता और उसके संदर्भ का वर्णन करता है।

परीक्षण विफल

public void testFailed (TestDescription test, 
                String trace)

व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

टेस्टस्टार्टेड और टेस्टएंडेड के बीच कॉल किया जाएगा।

पैरामीटर
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)) से पहले कॉल किया जाना चाहिए

ट्रेडफेडरेशन फ्रेमवर्क स्वचालित रूप से इस विधि को कॉल करेगा, होस्ट लॉग प्रदान करेगा और यदि लागू हो, डिवाइस लॉगकैट।

पैरामीटर
dataName	String : एक ERROR(/String) डेटा का वर्णनात्मक नाम। उदाहरण के लिए "डिवाइस_लॉगकैट"। नोट dataName प्रति मंगलाचरण अद्वितीय नहीं हो सकता है। यानी कार्यान्वयनकर्ताओं को एक ही डेटानाम के साथ कई कॉलों को संभालने में सक्षम होना चाहिए
dataType	LogDataType : डेटा का LogDataType
dataStream	InputStreamSource : डेटा का InputStreamSource । कार्यान्वयनकर्ताओं को डेटा पढ़ना शुरू करने के लिए createInputStream को कॉल करना चाहिए और पूरा होने पर परिणामी InputStream को बंद करना सुनिश्चित करना चाहिए। कॉल करने वालों को यह सुनिश्चित करना चाहिए कि टेस्टलॉग विधि पूरी होने तक डेटा का स्रोत मौजूद और सुलभ रहे।

testModuleEnd

public void testModuleEnded ()

एक मॉड्यूल रन के अंत की रिपोर्ट करता है।

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

चलने वाले मॉड्यूल की शुरुआत की रिपोर्ट करता है। यह कॉलबैक testModuleEnded() से संबद्ध है और अनुक्रम में वैकल्पिक है। यह केवल एक रन के दौरान उपयोग किया जाता है जो मॉड्यूल का उपयोग करता है: सूट आधारित धावक।

पैरामीटर
moduleContext	IInvocationContext : मॉड्यूल का IInvocationContext ।

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

टेस्ट रन के अंत की रिपोर्ट। FIXME: हमारे पास अलग-अलग प्रकार के दो मैप<> इंटरफेस नहीं हो सकते हैं, इसलिए हमें यहां हैश मैप का उपयोग करना होगा।

पैरामीटर
elapsedTime	long : डिवाइस ने बीता हुआ समय, मिलीसेकंड में रिपोर्ट किया
runMetrics	: Metric के साथ टेस्ट रन के अंत में रिपोर्ट किए गए की-वैल्यू पेयर।

testrunFailed

public void testRunFailed (FailureDescription failure)

विफलता FailureDescription द्वारा वर्णित विफलता के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।

पैरामीटर
failure	FailureDescription : FailureDescription विफलता और उसके संदर्भ का वर्णन करता है।

testrunFailed

public void testRunFailed (String errorMessage)

घातक त्रुटि के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।

पैरामीटर
errorMessage	String : ERROR(/String) रन विफलता के कारण का वर्णन करता है।

testrunStarted

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

टेस्ट रन की शुरुआत की रिपोर्ट करता है।

पैरामीटर
runName	String : टेस्ट रन नाम
testCount	int : परीक्षण चलाने में परीक्षणों की कुल संख्या
attemptNumber	int : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर वृद्धि होनी चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार पुन: प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 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 : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर वृद्धि होनी चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार पुन: प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 0 से 3 तक होती है।
startTime	long : रन शुरू होने का समय, ERROR(/System#currentTimeMillis()) द्वारा मापा गया

testRunStopped

public void testRunStopped (long elapsedTime)

एक उपयोगकर्ता के अनुरोध के कारण रिपोर्ट का परीक्षण पूरा होने से पहले ही रुक गया।

TODO: वर्तमान में अप्रयुक्त, हटाने पर विचार करें

पैरामीटर
elapsedTime	long : डिवाइस ने बीता हुआ समय, मिलीसेकंड में रिपोर्ट किया

परीक्षण शुरू

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 : परीक्षण शुरू होने का समय, ERROR(/System#currentTimeMillis()) द्वारा मापा गया

परीक्षण शुरू

public void testStarted (TestDescription test)

एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है। पुराना इंटरफ़ेस, जब भी संभव हो testStarted(com.android.tradefed.result.TestDescription) उपयोग करना चाहिए।

पैरामीटर
test	TestDescription : परीक्षण की पहचान करता है

संरक्षित तरीके

getListeners

protected  getListeners ()

श्रोताओं की सूची प्राप्त करें। केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

रिटर्न
	ITestInvocationListener एस की सूची।

setListeners

protected void setListeners (ITestInvocationListener... listeners)

निर्माण के बाद श्रोताओं को सेट करें। केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

पैरामीटर
listeners	ITestInvocationListener : परिणामों को अग्रेषित करने के लिए वास्तविक ITestInvocationListener s

setListeners

protected void setListeners ( listeners)

निर्माण के बाद श्रोताओं को सेट करें। केवल उपवर्गों द्वारा उपयोग के लिए अभिप्रेत है।

पैरामीटर
listeners	: परिणामों को अग्रेषित करने के लिए वास्तविक ITestInvocationListener s