InvocationToJUnitResultForwarder

public class InvocationToJUnitResultForwarder
extends Object implements ITestInvocationListener

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

पहचाने गए डायरेक्ट सबक्लास TextResultReporter TextResultReporter टेस्ट के नतीजे की जानकारी देने वाला टूल, जो JUnit के टेक्स्ट के नतीजे वाले प्रिंटर को नतीजे भेजता है.

---

एक क्लास जो ITestInvocationListener इवेंट को सुनती है और उन्हें TestListener पर फ़ॉरवर्ड करती है.

खास जानकारी

पब्लिक कंस्ट्रक्टर
InvocationToJUnitResultForwarder(TestListener junitListener)

सार्वजनिक तरीके
TestSummary	getSummary() इससे InvocationListener को खास जानकारी दिखाने की अनुमति मिलती है.
void	invocationEnded(long elapsedTime) यह रिपोर्ट दिखाती है कि अनुरोध पूरा हो गया है या किसी गड़बड़ी की वजह से पूरा नहीं हो सका.
void	invocationFailed(Throwable cause) किसी गड़बड़ी की वजह से, इंवोकेशन पूरा न होने की रिपोर्ट दिखाता है.
void	invocationStarted(IInvocationContext context) टेस्ट को शुरू करने के बारे में रिपोर्ट करता है.
void	testAssumptionFailure(TestDescription testId, String trace) जब कोई परमाणु टेस्ट फ़्लैग करता है कि वह किसी ऐसी शर्त को मानता है जो गलत है, तब इसे कॉल किया जाता है
void	testEnded(TestDescription test, testMetrics) किसी टेस्ट केस के पूरा होने की जानकारी देता है.
void	testFailed(TestDescription testId, String trace) किसी टेस्ट केस के फ़ेल होने की रिपोर्ट करता है.
void	testIgnored(TestDescription test) जब कोई टेस्ट नहीं चलेगा, तब इसे कॉल किया जाएगा. आम तौर पर, ऐसा इसलिए होता है, क्योंकि टेस्ट के तरीके को org.junit.Ignore के साथ एनोटेट किया गया है.
void	testLog(String dataName, LogDataType logData, InputStreamSource dataStream) टेस्ट को शुरू करने से जुड़ा लॉग या डीबग डेटा उपलब्ध कराता है.
void	testRunEnded(long elapsedTime, runMetrics) टेस्ट रन खत्म होने की रिपोर्ट दिखाता है.
void	testRunFailed(String errorMessage) किसी गंभीर गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.
void	testRunStarted(String runName, int testCount) टेस्ट रन शुरू होने की जानकारी देता है.
void	testRunStopped(long elapsedTime) उपयोगकर्ता के अनुरोध की वजह से, रिपोर्ट की जांच पूरी होने से पहले ही रोक दी गई.
void	testStarted(TestDescription test) किसी टेस्ट केस के शुरू होने की जानकारी देता है.

सुरक्षित तरीके
TestListener	getJUnitListener()

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

InvocationToJUnitResultForwarder

public InvocationToJUnitResultForwarder (TestListener junitListener)

पैरामीटर
junitListener	TestListener

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

getSummary

public TestSummary getSummary ()

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

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

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationFailed

public void invocationFailed (Throwable cause)

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

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

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

invocationStarted

public void invocationStarted (IInvocationContext context)

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

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

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

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

testFailed

public void testFailed (TestDescription testId, 
                String trace)

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

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

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

testIgnored

public void testIgnored (TestDescription test)

जब कोई टेस्ट नहीं चलेगा, तब इसे कॉल किया जाएगा. आम तौर पर, ऐसा इसलिए होता है, क्योंकि टेस्ट के तरीके को org.junit.Ignore के साथ एनोटेट किया गया है.

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

testLog

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

टेस्ट को शुरू करने से जुड़ा लॉग या डीबग डेटा उपलब्ध कराता है.

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

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

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (String errorMessage)

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

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

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

पैरामीटर
runName	String: टेस्ट रन का नाम
testCount	int: टेस्ट रन में टेस्ट की कुल संख्या

testRunStopped

public void testRunStopped (long elapsedTime)

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

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

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

testStarted

public void testStarted (TestDescription test)

किसी टेस्ट केस के शुरू होने की जानकारी देता है. पुराने इंटरफ़ेस में, जब भी हो सके testStarted(com.android.tradefed.result.TestDescription) का इस्तेमाल करना चाहिए.

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

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

getJUnitListener

protected TestListener getJUnitListener ()

रिटर्न
TestListener