SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

ITestInvocationListener को result_reporter के तौर पर लागू करता है और सब-प्रोसेस से टेस्ट, टेस्ट रन, और टेस्ट के आह्वान के नतीजे फ़ॉरवर्ड करता है.

खास जानकारी

सार्वजनिक कंस्ट्रक्टर

SubprocessResultsReporter()

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

void close()

TestSummary getSummary()

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

void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

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

void invocationStarted(IInvocationContext context)

यह टेस्ट शुरू होने की रिपोर्ट करता है.

void logAssociation(String dataName, LogFile logFile)

कुछ मामलों में, लॉग को टेस्ट केस से ज़्यादा से ज़्यादा जोड़ा जाना चाहिए. हालांकि, डायरेक्ट testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback पर ऐसा करना संभव नहीं है.

void printEvent(String key, Object event)

इवेंट की कुंजी और फिर JSON ऑब्जेक्ट को प्रिंट करने के लिए हेल्पर.

void setOutputTestLog(boolean outputTestLog)

इससे यह तय होता है कि टेस्ट को लॉग किया जाएगा या नहीं.

boolean supportGranularResults()

अगर रिपोर्टर ज़्यादा जानकारी वाले नतीजे दिखाता है, तो True दिखाता है. ऐसा न होने पर, False दिखाता है.

void testAssumptionFailure(TestDescription testId, String trace)

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

void testAssumptionFailure(TestDescription testId, FailureDescription failure)

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

void testEnded(TestDescription testId, long endTime, metrics)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) का विकल्प, जहां हम सीधे तौर पर खत्म होने का समय बता सकते हैं.

void testEnded(TestDescription testId, metrics)

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

void testFailed(TestDescription testId, FailureDescription failure)

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

void testFailed(TestDescription testId, String reason)

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

void testIgnored(TestDescription testId)

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

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

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

void testModuleEnded()

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

void testModuleStarted(IInvocationContext moduleContext)

किसी मॉड्यूल के चलने की शुरुआत की रिपोर्ट करता है.

void testRunEnded(long time, runMetrics)

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

void testRunFailed(FailureDescription failure)

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

void testRunFailed(String reason)

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

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

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

void testSkipped(TestDescription testId, SkipReason reason)

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

void testStarted(TestDescription testId, long startTime)

testStarted(com.android.tradefed.result.TestDescription) का विकल्प, जहां हम यह भी बताते हैं कि टेस्ट कब शुरू किया गया था. इसे सटीक आकलन के लिए, ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) के साथ जोड़ा जाता है.

void testStarted(TestDescription testId)

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

सार्वजनिक कंस्ट्रक्टर

सबप्रोसेस नतीजे रिपोर्टर

public SubprocessResultsReporter ()

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

बंद करें

public void close ()

getSummary

public TestSummary getSummary ()

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

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

invocationEnded

public void invocationEnded (long elapsedTime)

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

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

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

invocationFailed

public void invocationFailed (FailureDescription failure)

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

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

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

शुरू करने में समस्या

public void invocationFailed (Throwable cause)

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

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

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

शुरू किया गया

public void invocationStarted (IInvocationContext context)

यह टेस्ट शुरू होने की रिपोर्ट करता है.

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

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

लॉगअसोसिएशन

public void logAssociation (String dataName, 
                LogFile logFile)

कुछ मामलों में, लॉग को टेस्ट केस से ज़्यादा से ज़्यादा जोड़ा जाना चाहिए. हालांकि, डायरेक्ट testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback पर ऐसा करना संभव नहीं है. इसलिए, यह कॉलबैक साफ़ तौर पर एक मज़बूत असोसिएशन देने की अनुमति देता है.

पैरामीटर
dataName String: डेटा का नाम
logFile LogFile: वह LogFile जो पहले लॉग किया गया था और जो जांच के मामले से जुड़ा होना चाहिए.

printEvent

public void printEvent (String key, 
                Object event)

इवेंट कुंजी और फिर json ऑब्जेक्ट प्रिंट करने में मदद करें.

पैरामीटर
key String

event Object

setOutputTestLog

public void setOutputTestLog (boolean outputTestLog)

इससे यह तय होता है कि टेस्ट को लॉग किया जाएगा या नहीं.

पैरामीटर
outputTestLog boolean

supportGranularResults

public boolean supportGranularResults ()

अगर रिपोर्टर ज़्यादा जानकारी वाले नतीजे दिखाता है, तो True दिखाता है. ऐसा न होने पर, False दिखाता है.

रिटर्न
boolean

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

परीक्षण खत्म

public void testEnded (TestDescription testId, 
                long endTime, 
                 metrics)

यह ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) का विकल्प है, जहां हम सीधे तौर पर खत्म होने का समय तय कर सकते हैं. सटीक मेज़रमेंट के लिए, testStarted(com.android.tradefed.result.TestDescription, long) के साथ जोड़ें.

पैरामीटर
testId TestDescription: टेस्ट की पहचान करता है
endTime long: टेस्ट खत्म होने का समय, जिसे System.currentTimeMillis() से मेज़र किया जाता है
metrics : उत्सर्जित की गई मेट्रिक का ERROR(/Map)

testEnded

public void testEnded (TestDescription testId, 
                 metrics)

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

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

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

testFailed

public void testFailed (TestDescription testId, 
                FailureDescription failure)

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

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

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

जांच नहीं की जा सकी

public void testFailed (TestDescription testId, 
                String reason)

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

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

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

जांच के लिए अनदेखा किया गया

public void testIgnored (TestDescription testId)

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

पैरामीटर
testId 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. लागू करने वालों को डेटा पढ़ना शुरू करने के लिए createइनपुटStream को कॉल करना चाहिए. साथ ही, पक्का करें कि पूरा होने पर, InputStream ने नतीजे को बंद कर दिया हो. कॉलर को यह पक्का करना चाहिए कि testLog तरीके के पूरा होने तक, डेटा का सोर्स मौजूद रहे और उसे ऐक्सेस किया जा सके.

testModuleEnded

public void testModuleEnded ()

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

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

public void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public void testRunEnded (long time, 
                 runMetrics)

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

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

testRunFailed

public void testRunFailed (FailureDescription failure)

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

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

testRunFailed

public void testRunFailed (String reason)

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

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

testRunStarted

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

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

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

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

TODO: अभी उपयोग नहीं हो रहा है, निकालने पर विचार करें

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

testSkipped

public void testSkipped (TestDescription testId, 
                SkipReason reason)

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

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

testStarted

public void testStarted (TestDescription testId, 
                long startTime)

testStarted(com.android.tradefed.result.TestDescription) का विकल्प, जिसमें हम यह भी बताते हैं कि जांच कब शुरू की गई थी. सटीक मेज़रमेंट के लिए, इसे ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) के साथ जोड़ा जाता है.

पैरामीटर
testId TestDescription: टेस्ट की पहचान करता है
startTime long: जांच शुरू होने का समय, जिसे System.currentTimeMillis() से मेज़र किया जाता है

testStarted

public void testStarted (TestDescription testId)

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

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