ProtoResultReporter

public abstract class ProtoResultReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

java.lang.Object
   ↳ com.android.tradefed.result.proto.Protoresults रिपोर्टर

नतीजे की जानकारी देने वाला टूल, सभी नतीजों के साथ एक TestRecord प्रोटोबबल बनाता है. processFinalProto(com.android.tradefed.result.proto.TestRecordProto.TestRecord) में फ़ाइनल प्रोटो के साथ क्या करना है, यह तय करने के लिए इसे बड़ा किया जाना चाहिए.

खास जानकारी

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

ProtoResultReporter()

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

final void invocationEnded(long elapsedTime)

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

void invocationFailed(FailureDescription failure)

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

void invocationFailed(Throwable cause)

किसी गड़बड़ी की स्थिति की वजह से, कॉल शुरू करने की प्रोसेस पूरी नहीं होने की रिपोर्ट करता है.

void invocationSkipped(SkipReason reason)

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

final void invocationStarted(IInvocationContext context)

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

final void logAssociation(String dataName, LogFile logFile)

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

void processFinalInvocationLogs(TestRecordProto.TestRecord invocationLogs)

शुरू करने के रिकॉर्ड का इस्तेमाल करके, न्योता देने के सभी फ़ाइनल लॉग को एक-एक करके भेजें.

void processFinalProto(TestRecordProto.TestRecord finalRecord)

सभी नतीजों के साथ फ़ाइनल प्रोटो को मैनेज करना.

void processStartInvocation(TestRecordProto.TestRecord invocationStartRecord, IInvocationContext invocationContext)

invocationStarted(com.android.tradefed.invoker.IInvocationContext) शुरू होने के बाद, शुरू करने के पार्शियल टेस्ट रिकॉर्ड प्रोटो को मैनेज करना.

void processTestCaseEnded(TestRecordProto.TestRecord testCaseRecord)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) होने के बाद, फ़ाइनल टेस्ट केस रिकॉर्ड प्रोटो को हैंडल करना.

void processTestCaseStarted(TestRecordProto.TestRecord testCaseStartedRecord)

testStarted(com.android.tradefed.result.TestDescription, long) शुरू होने के बाद, पार्शियल टेस्ट केस रिकॉर्ड प्रोटो को हैंडल करना.

void processTestModuleEnd(TestRecordProto.TestRecord moduleRecord)

testModuleEnded() शुरू होने के बाद, फ़ाइनल मॉड्यूल रिकॉर्ड प्रोटो को हैंडल करना.

void processTestModuleStarted(TestRecordProto.TestRecord moduleStartRecord)

testModuleStarted(com.android.tradefed.invoker.IInvocationContext) होने के बाद, मॉड्यूल के रिकॉर्ड के प्रोटो के कुछ हिस्से को मैनेज करना.

void processTestRunEnded(TestRecordProto.TestRecord runRecord, boolean moduleInProgress)

ERROR(/#testRunEnded(long,HashMap)) के होने के बाद, फ़ाइनल किए गए रन रिकॉर्ड प्रोटो को मैनेज करना.

void processTestRunStarted(TestRecordProto.TestRecord runStartedRecord)

testRunStarted(String, int) होने के बाद, टेस्ट रन के रिकॉर्ड के प्रोटो के कुछ हिस्से को मैनेज करना.

void setGranularResults(boolean granularResults)
void setInlineRecordOfChildren(boolean inline)
boolean supportGranularResults()

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

final void testAssumptionFailure(TestDescription test, String trace)

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

final void testAssumptionFailure(TestDescription test, FailureDescription failure)

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

final void testEnded(TestDescription test, long endTime, testMetrics)

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

void testEnded(TestDescription test, testMetrics)

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

final void testFailed(TestDescription test, FailureDescription failure)

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

final void testFailed(TestDescription test, String trace)

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

final void testIgnored(TestDescription test)

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

final void testModuleEnded()

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

final void testModuleStarted(IInvocationContext moduleContext)

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

final void testRunEnded(long elapsedTimeMillis, runMetrics)

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

final void testRunFailed(FailureDescription failure)

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

final void testRunFailed(String errorMessage)

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

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

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

final void testRunStarted(String runName, int testCount)

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

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

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

final void testSkipped(TestDescription test, SkipReason reason)

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

final void testStarted(TestDescription test, long startTime)

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

final void testStarted(TestDescription test)

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

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

void afterModuleEnd()
void beforeModuleStart()
TestRecordProto.ChildReference createModuleChildReference(TestRecordProto.TestRecord record)

किसी मॉड्यूल के लिए चाइल्ड रेफ़रंस बनाता है.

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

ProtoResultReporter

public ProtoResultReporter ()

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

invocationEnded

public final void invocationEnded (long elapsedTime)

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

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

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

invocationFailed

public void invocationFailed (FailureDescription failure)

किसी गड़बड़ी की स्थिति की वजह से, कॉल शुरू करने की प्रोसेस पूरी नहीं होने की रिपोर्ट करता है.

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

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

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

public void invocationFailed (Throwable cause)

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

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

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

invocationSkipped

public void invocationSkipped (SkipReason reason)

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

पैरामीटर
reason SkipReason

invocationStarted

public final void invocationStarted (IInvocationContext context)

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

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

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

logAssociation

public final 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 जो पहले लॉग किया गया था और जो जांच के मामले से जुड़ा होना चाहिए.

processFinalInvocationLogs

public void processFinalInvocationLogs (TestRecordProto.TestRecord invocationLogs)

कॉल रिकॉर्ड का इस्तेमाल करके, कॉल के सभी फ़ाइनल लॉग को एक-एक करके भेजें.

पैरामीटर
invocationLogs TestRecordProto.TestRecord: आह्वान को दिखाने वाला प्रोटोटाइप.

processFinalProto

public void processFinalProto (TestRecordProto.TestRecord finalRecord)

सभी नतीजों के साथ फ़ाइनल प्रोटो को मैनेज करना.

पैरामीटर
finalRecord TestRecordProto.TestRecord: सभी इंवोकेशन के नतीजों के साथ, प्रोटोटाइप का फ़ाइनल वर्शन.

processStartInvocation

public void processStartInvocation (TestRecordProto.TestRecord invocationStartRecord, 
                IInvocationContext invocationContext)

invocationStarted(com.android.tradefed.invoker.IInvocationContext) होने के बाद, कुछ हिस्से को शुरू करने के लिए टेस्ट रिकॉर्ड प्रोटो को मैनेज करना.

पैरामीटर
invocationStartRecord TestRecordProto.TestRecord: invocationStart के बाद, आंशिक प्रोटो पॉप्युलेट होता है.
invocationContext IInvocationContext: कॉल करने का तरीका IInvocationContext.

प्रोसेसTestCaseEnded

public void processTestCaseEnded (TestRecordProto.TestRecord testCaseRecord)

ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,HashMap)) होने के बाद, फ़ाइनल किए गए टेस्ट केस रिकॉर्ड प्रोटो को मैनेज करना.

पैरामीटर
testCaseRecord TestRecordProto.TestRecord: टेस्ट केस को दिखाने वाला प्रोटोटाइप.

processTestCaseStarted

public void processTestCaseStarted (TestRecordProto.TestRecord testCaseStartedRecord)

testStarted(com.android.tradefed.result.TestDescription, long) होने के बाद, टेस्ट केस के रिकॉर्ड प्रोटो के कुछ हिस्से को मैनेज करना.

पैरामीटर
testCaseStartedRecord TestRecordProto.TestRecord: टेस्ट केस को दिखाने वाला प्रोटो का हिस्सा.

processTestModuleEnd

public void processTestModuleEnd (TestRecordProto.TestRecord moduleRecord)

testModuleEnded() होने के बाद, फ़ाइनल किए गए मॉड्यूल रिकॉर्ड प्रोटो को मैनेज करना.

पैरामीटर
moduleRecord TestRecordProto.TestRecord: मॉड्यूल को दिखाने वाला प्रोटोटाइप.

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

public void processTestModuleStarted (TestRecordProto.TestRecord moduleStartRecord)

testModuleStarted(com.android.tradefed.invoker.IInvocationContext) होने के बाद, मॉड्यूल के रिकॉर्ड के प्रोटो के कुछ हिस्से को मैनेज करना.

पैरामीटर
moduleStartRecord TestRecordProto.TestRecord: मॉड्यूल को दिखाने वाला प्रोटो का कुछ हिस्सा.

processTestRunEnded

public void processTestRunEnded (TestRecordProto.TestRecord runRecord, 
                boolean moduleInProgress)

ERROR(/#testRunEnded(long,HashMap)) के होने के बाद, फ़ाइनल किए गए रन रिकॉर्ड प्रोटो को मैनेज करना.

पैरामीटर
runRecord TestRecordProto.TestRecord: रन को दिखाने वाला प्रोटोटाइप.
moduleInProgress boolean: मॉड्यूल की प्रोसेस जारी है या नहीं.

processTestRunStarted

public void processTestRunStarted (TestRecordProto.TestRecord runStartedRecord)

testRunStarted(String, int) होने के बाद, टेस्ट रन के रिकॉर्ड के प्रोटो के कुछ हिस्से को मैनेज करना.

पैरामीटर
runStartedRecord TestRecordProto.TestRecord: रन को दिखाने वाला प्रोटो का हिस्सा.

setGranularResults

public void setGranularResults (boolean granularResults)

पैरामीटर
granularResults boolean

setInlineRecordOfChildren

public void setInlineRecordOfChildren (boolean inline)

पैरामीटर
inline boolean

supportGranularresults

public boolean supportGranularResults ()

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

रिटर्न
boolean

TestAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

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

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

testEnded

public final 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 final void testFailed (TestDescription test, 
                FailureDescription failure)

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

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

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

testFailed

public final void testFailed (TestDescription test, 
                String trace)

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

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

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

testIgnored

public final void testIgnored (TestDescription test)

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

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

परीक्षण मॉड्यूल का आखिरी चरण

public final void testModuleEnded ()

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

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

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

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

testRunEnded

public final void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

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

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

testRunFailed

public final void testRunFailed (FailureDescription failure)

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

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

परीक्षणरन विफल

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

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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

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

testStarted

public final 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 final void testStarted (TestDescription test)

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

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

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

afterModuleEnd

protected void afterModuleEnd ()

beforeModuleStart

protected void beforeModuleStart ()

createModuleChildReference

protected TestRecordProto.ChildReference createModuleChildReference (TestRecordProto.TestRecord record)

किसी मॉड्यूल के लिए चाइल्ड रेफ़रंस बनाता है.

पैरामीटर
record TestRecordProto.TestRecord

रिटर्न
TestRecordProto.ChildReference