ResultForwarder

public class ResultForwarder
extends Object implements ITestInvocationListener

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

एक 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 पर नतीजे फ़ॉरवर्ड करने हैं

रिज़ल्ट फ़ॉरवर्डर

public ResultForwarder ( listeners)

ResultForwarder बनाएं.

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

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

रिज़ल्ट फ़ॉरवर्डर

protected ResultForwarder ()

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

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

getSummary

public TestSummary getSummary ()

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

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

शुरू होने का समय खत्म

public void invocationEnded (long elapsedTime)

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

इसे ट्रेडफ़ेडरेशन फ़्रेमवर्क से अपने-आप कॉल किया जाएगा.

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

इसे ट्रेडफ़ेडरेशन फ़्रेमवर्क से अपने-आप कॉल किया जाएगा.

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

invocationFailed

public void invocationFailed (Throwable cause)

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

इसे ट्रेडफ़ेडरेशन फ़्रेमवर्क से अपने-आप कॉल किया जाएगा.

पैरामीटर
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)

परीक्षण खत्म

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 ()

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

परीक्षण मॉड्यूल शुरू किया गया

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

परीक्षण रन बंद

public void testRunStopped (long elapsedTime)

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

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

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

परीक्षण छोड़ा गया

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 पर नतीजे फ़ॉरवर्ड करने हैं

सेट लिसनर

protected void setListeners ( listeners)

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

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