ResultForwarder

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 FilteredResultForwarder ResultForwarder का वैरिएंट, जो सिर्फ़ TestDescription की अनुमति वाली सूची को रिपोर्ट करने की अनुमति देता है.  JarHostTest.HostTestListener रैपर लिसनर, जो testRunStarted() और testRunEnded() को छोड़कर सभी इवेंट को एम्बेड किए गए लिसनर को फ़ॉरवर्ड करता है.  LogSaverResultForwarder ग्लोबल फ़ाइल सेवर की मदद से लॉग सेव करने के लिए ResultForwarder.  LogcatCrashResultForwarder खास लिसनर: गड़बड़ियों (इंस्ट्रूमेंटेशन प्रोसेस क्रैश होने) पर, यह logcat से क्रैश को निकालने की कोशिश करेगा और उसे टेस्ट से जुड़ी गड़बड़ी के मैसेज में जोड़ देगा.  PythonBinaryHostTest.PythonForwarder रन के नाम को बाइनरी नाम से बदलने के लिए, नतीजे फ़ॉरवर्ड करने वाला टूल.  ResultAndLogForwarder नतीजों और लॉग इवेंट के लिए फ़ॉरवर्डर.  RetryResultForwarder ResultForwarder का एक्सटेंशन, जो हमेशा किसी तय किए गए नंबर पर पुश करता है.  ShardMainResultForwarder एक ResultForwarder जो शर्ड किए गए टेस्ट के आह्वान के नतीजों को जोड़ता है.  TestTimeoutEnforcer ऐसे लिसनर जिनकी मदद से, किसी दिए गए टेस्ट केस के लागू होने में लगने वाले समय की जांच की जा सकती है. साथ ही, अगर यह समय तय किए गए टाइम आउट से ज़्यादा हो जाता है, तो टेस्ट केस को फ़ेल कर दिया जाता है.

ऐसे सबक्लास जिनके बारे में पहले से पता है GranularRetriableTestWrapper.StartEndCollector, RetryLogSaverResultForwarder GranularRetriableTestWrapper.StartEndCollector रन शुरू और खत्म होने के समय की जानकारी पाने के लिए क्लास हेल्पर.  RetryLogSaverResultForwarder फ़ॉरवर्डर, जो मौजूदा कोशिश को भी पास करता है.

---

एक ITestInvocationListener जो अन्य लिसनर की सूची में, कॉल करने के नतीजे फ़ॉरवर्ड करता है.

खास जानकारी

पब्लिक कंस्ट्रक्टर
ResultForwarder(ITestInvocationListener... listeners) ResultForwarder के लिए वैरिएबल आर्ग कंस्ट्रक्टर का विकल्प.
ResultForwarder( listeners) ResultForwarder बनाएं.

सुरक्षित कंस्ट्रक्टर
ResultForwarder() 'बाद में सुनने की सुविधा' सेटिंग के साथ ResultForwarder बनाएं.

सार्वजनिक तरीके
TestSummary	getSummary() इससे InvocationListener को खास जानकारी दिखाने की अनुमति मिलती है.
void	invocationEnded(long elapsedTime) यह रिपोर्ट दिखाती है कि अनुरोध पूरा हो गया है या किसी गड़बड़ी की वजह से पूरा नहीं हो सका.
void	invocationFailed(FailureDescription failure) किसी गड़बड़ी की वजह से, इंवोकेशन पूरा न होने की रिपोर्ट दिखाता है.
void	invocationFailed(Throwable cause) किसी गड़बड़ी की वजह से, इंवोकेशन पूरा न होने की रिपोर्ट दिखाता है.
void	invocationSkipped(SkipReason reason) किसी अनुरोध को 'अभी नहीं' के तौर पर रिपोर्ट करता है
void	invocationStarted(IInvocationContext context) टेस्ट को शुरू करने के बारे में रिपोर्ट करता है.
void	testAssumptionFailure(TestDescription test, String trace) जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है
void	testAssumptionFailure(TestDescription test, FailureDescription failure) जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है
void	testEnded(TestDescription test, long endTime, testMetrics) ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) का विकल्प, जहां हम सीधे तौर पर खत्म होने का समय बता सकते हैं.
void	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) टेस्ट रन खत्म होने की रिपोर्ट दिखाता है.
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	testSkipped(TestDescription test, SkipReason reason) जब किसी टेस्ट को स्किप किया जाता है और वह किसी ऐसी वजह से नहीं चलता है जिसकी आम तौर पर उम्मीद नहीं की जाती, तब यह ट्रिगर होता है.
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) कन्स्ट्रक्शन के बाद लिसनर सेट करें.

पब्लिक कंस्ट्रक्टर

ResultForwarder

public ResultForwarder (ITestInvocationListener... listeners)

ResultForwarder के लिए वैरिएबल आर्ग कंस्ट्रक्टर का विकल्प.

पैरामीटर
listeners	ITestInvocationListener: नतीजों को फ़ॉरवर्ड करने के लिए असली ITestInvocationListener

ResultForwarder

public ResultForwarder ( listeners)

ResultForwarder बनाएं.

पैरामीटर
listeners	: नतीजों को फ़ॉरवर्ड करने के लिए असली ITestInvocationListener

सुरक्षित कंस्ट्रक्टर

ResultForwarder

protected ResultForwarder ()

'बाद में सुनने की सुविधा' सेटिंग के साथ ResultForwarder बनाएं. इसका इस्तेमाल सिर्फ़ सबक्लास के लिए किया जाता है.

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

getSummary

public TestSummary getSummary ()

इससे InvocationListener को खास जानकारी दिखाने की अनुमति मिलती है.

रिटर्न
TestSummary	TestSummary, जिसमें रन की खास जानकारी दी गई हो या शून्य हो

invocationEnded

public void invocationEnded (long elapsedTime)

यह रिपोर्ट दिखाती है कि अनुरोध पूरा हो गया है या किसी गड़बड़ी की वजह से पूरा नहीं हो सका.

TradeFederation फ़्रेमवर्क इसे अपने-आप कॉल करेगा.

पैरामीटर
elapsedTime	long: कॉल को शुरू करने में लगा समय, मिलीसेकंड में

invocationFailed

public void invocationFailed (FailureDescription failure)

किसी गड़बड़ी की वजह से, इंवोकेशन पूरा न होने की रिपोर्ट दिखाता है.

TradeFederation फ़्रेमवर्क इसे अपने-आप कॉल करेगा.

पैरामीटर
failure	FailureDescription: FailureDescription, जिसमें गड़बड़ी की वजह बताई गई है

invocationFailed

public void invocationFailed (Throwable cause)

किसी गड़बड़ी की वजह से, इंवोकेशन पूरा न होने की रिपोर्ट दिखाता है.

TradeFederation फ़्रेमवर्क इसे अपने-आप कॉल करेगा.

पैरामीटर
cause	Throwable: Throwable गड़बड़ी की वजह

invocationSkipped

public void invocationSkipped (SkipReason reason)

किसी अनुरोध को 'अभी नहीं' के तौर पर रिपोर्ट करता है

पैरामीटर
reason	SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

टेस्ट को शुरू करने के बारे में रिपोर्ट करता है.

TradeFederation फ़्रेमवर्क इसे अपने-आप कॉल करेगा. एक से ज़्यादा डिवाइसों की रिपोर्टिंग के लिए, रिपोर्टर को इस तरीके को बदलना होगा.

पैरामीटर
context	IInvocationContext: बोलकर निर्देश देने की सुविधा के बारे में जानकारी

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
trace	String: गड़बड़ी का स्टैक ट्रेस

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
failure	FailureDescription: FailureDescription गड़बड़ी और उसके संदर्भ के बारे में बताना.

testEnded

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)

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

किसी टेस्ट केस के पूरा होने की जानकारी देता है.

अगर testFailed(TestDescription, FailureDescription) को ट्रिगर नहीं किया गया था, तो यह टेस्ट पास हो गया. यह उन सभी की-वैल्यू वाली मेट्रिक भी दिखाता है जो टेस्ट केस के दौरान उत्सर्जित की गई हो सकती हैं.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
testMetrics	: उत्सर्जित मेट्रिक का ERROR(/Map)

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

किसी टेस्ट केस के फ़ेल होने की रिपोर्ट करता है.

इसे testStarted और testEnded के बीच कॉल किया जाएगा.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
failure	FailureDescription: FailureDescription गड़बड़ी और उसके संदर्भ के बारे में बताना.

testFailed

public void testFailed (TestDescription test, 
                String trace)

किसी टेस्ट केस के फ़ेल होने की रिपोर्ट करता है.

इसे testStarted और testEnded के बीच कॉल किया जाएगा.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
trace	String: गड़बड़ी का स्टैक ट्रेस

testIgnored

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

TradeFederation फ़्रेमवर्क, इस तरीके को अपने-आप कॉल करेगा. साथ ही, होस्ट लॉग और अगर लागू हो, तो डिवाइस लॉगकैट भी उपलब्ध कराएगा.

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

testModuleEnded

public void testModuleEnded ()

मॉड्यूल के चलने के खत्म होने की रिपोर्ट दिखाता है.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट करता है. यह कॉलबैक testModuleEnded() से जुड़ा है और क्रम में शामिल करना ज़रूरी नहीं है. इसका इस्तेमाल सिर्फ़ उस रन के दौरान किया जाता है जिसमें मॉड्यूल का इस्तेमाल किया जाता है: suite based runners.

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

टेस्ट रन खत्म होने की रिपोर्ट दिखाता है.

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

testRunFailed

public void testRunFailed (FailureDescription failure)

FailureDescription की बताई गई गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.

पैरामीटर
failure	FailureDescription: FailureDescription गड़बड़ी और उसके संदर्भ के बारे में बताना.

testRunFailed

public void testRunFailed (String errorMessage)

किसी गंभीर गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.

पैरामीटर
errorMessage	String: String, जिसमें रन न होने की वजह बताई गई है.

testRunStarted

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

टेस्ट रन शुरू होने की जानकारी देता है.

पैरामीटर
runName	String: टेस्ट रन का नाम
testCount	int: टेस्ट रन में टेस्ट की कुल संख्या
attemptNumber	int: ऑर्डर नंबर, एक ही runName के अलग-अलग प्रयासों की पहचान करता है, जो कई बार चलाए जाते हैं. attemptNumber का इंडेक्स 0 से शुरू होता है और हर बार नया रन होने पर, इसकी वैल्यू बढ़नी चाहिए. उदाहरण के लिए, किसी टेस्ट को तीन बार फिर से चलाया जाता है, तो एक ही runName के तहत कुल चार रन होने चाहिए और attemptNumber की वैल्यू 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: ऑर्डर नंबर, एक ही runName के अलग-अलग प्रयासों की पहचान करता है, जो कई बार चलाए जाते हैं. attemptNumber का इंडेक्स 0 से शुरू होता है और हर बार नया रन होने पर, इसकी वैल्यू बढ़नी चाहिए. उदाहरण के लिए, किसी टेस्ट को तीन बार फिर से चलाया जाता है, तो उसी runName के तहत कुल चार रन होने चाहिए और attemptNumber की वैल्यू 0 से 3 के बीच होनी चाहिए.
startTime	long: रन शुरू होने का समय, जिसे System.currentTimeMillis() से मेज़र किया जाता है

testRunStopped

public void testRunStopped (long elapsedTime)

उपयोगकर्ता के अनुरोध की वजह से, रिपोर्ट की जांच पूरी होने से पहले ही रोक दी गई.

TODO: फ़िलहाल इस्तेमाल नहीं किया जा रहा है, इसे हटाने पर विचार करें

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

जब किसी टेस्ट को स्किप किया जाता है और वह किसी ऐसी वजह से नहीं चलता है जिसकी आम तौर पर उम्मीद नहीं की जाती, तब यह ट्रिगर होता है. इन टेस्ट को फिर से चलाकर, सही तरीके से लागू करने की कोशिश की जाएगी.

पैरामीटर
test	TestDescription: टेस्ट की पहचान करता है
reason	SkipReason: SkipReason

testStarted

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() से मेज़र किया जाता है

testStarted

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

setListeners

protected void setListeners ( listeners)

कन्स्ट्रक्शन के बाद लिसनर सेट करें. इसका इस्तेमाल सिर्फ़ सबक्लास के लिए किया जाता है.

पैरामीटर
listeners	: नतीजों को फ़ॉरवर्ड करने के लिए असली ITestInvocationListener