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

public class ResultForwarder
extends Object implements ITestInvocationListener

java.lang.ऑब्जेक्ट
मैं	com.android.tradefed.result.ResultForwarder

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

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

---

एक 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 ( listeners) setListeners ( listeners) निर्माण के बाद श्रोताओं को सेट करें।
void	setListeners ( ITestInvocationListener... listeners) निर्माण के बाद श्रोताओं को सेट करें।

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

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

public ResultForwarder ( listeners)

एक ResultForwarder बनाएं।

मापदंडों
listeners	: वास्तविक ITestInvocationListener परिणामों को अग्रेषित करने के लिए

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

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder के लिए वैकल्पिक चर arg निर्माता।

मापदंडों
listeners	ITestInvocationListener : वास्तविक ITestInvocationListener परिणाम को अग्रेषित करने के लिए

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

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

protected ResultForwarder ()

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

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

सारांश प्राप्त करें

public TestSummary getSummary ()

आमंत्रण सूची को सारांश वापस करने की अनुमति देता है।

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

आह्वान समाप्त

public void invocationEnded (long elapsedTime)

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

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

मापदंडों
elapsedTime	long : ms . में आह्वान का बीता हुआ समय

आह्वानविफल

public void invocationFailed (FailureDescription failure)

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

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

मापदंडों
failure	FailureDescription : FailureDescription विवरण विफलता के कारण का वर्णन करता है

आह्वानविफल

public void invocationFailed (Throwable cause)

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

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

मापदंडों
cause	Throwable : विफलता का 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 : परीक्षण समाप्त होने का समय, 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 : टेस्ट की पहचान करता है

टेस्टलॉग

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

परीक्षण आमंत्रण से संबंधित लॉग या डीबग डेटा प्रदान करता है।

ERROR(/ITestInvocationListener#invocationFailed(Throwable)) या ERROR(/ITestInvocationListener#invocationEnded(long)) से पहले कॉल किया जाना चाहिए

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

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

टेस्टमॉड्यूलसमाप्त

public void testModuleEnded ()

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

टेस्टमॉड्यूलशुरू किया गया

public void testModuleStarted (IInvocationContext moduleContext)

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

मापदंडों
moduleContext	IInvocationContext : मॉड्यूल का IInvocationContext ।

टेस्टरनसमाप्त

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

टेस्टरनविफल

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 : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर इसे बढ़ाना चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार बारीक पुन: प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 0 से 3 तक है।

टेस्टरनस्टार्ट किया गया

public void testRunStarted (String runName, 
                int testCount)

एक परीक्षण चलाने की शुरुआत की रिपोर्ट करता है।

मापदंडों
runName	String : टेस्ट रन नाम
testCount	int : टेस्ट रन में परीक्षणों की कुल संख्या

टेस्टरनस्टार्ट किया गया

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

एक परीक्षण चलाने की शुरुआत की रिपोर्ट करता है।

मापदंडों
runName	String : टेस्ट रन नाम
testCount	int : टेस्ट रन में परीक्षणों की कुल संख्या
attemptNumber	int : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर इसे बढ़ाना चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार बारीक पुन: प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 0 से 3 तक है।
startTime	long : रन शुरू होने का समय, System.currentTimeMillis() के माध्यम से मापा जाता है

टेस्टरनस्टॉप्ड

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 : परीक्षण शुरू होने का समय, System.currentTimeMillis() के माध्यम से मापा जाता है

परीक्षण शुरू हुआ

public void testStarted (TestDescription test)

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

मापदंडों
test	TestDescription : टेस्ट की पहचान करता है

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

श्रोता प्राप्त करें

protected  getListeners ()

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

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

श्रोताओं को सेट करें

protected void setListeners ( listeners)

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

मापदंडों
listeners	: वास्तविक ITestInvocationListener परिणामों को अग्रेषित करने के लिए

श्रोताओं को सेट करें

protected void setListeners (ITestInvocationListener... listeners)

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

मापदंडों
listeners	ITestInvocationListener : वास्तविक ITestInvocationListener परिणाम को अग्रेषित करने के लिए