SubprocessResultsReporter

public class SubprocessResultsReporter
extends Object implements ILogSaverListener, ISupportGranularResults, ITestInvocationListener

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

पहचाने गए डायरेक्ट सबक्लास LegacySubprocessResultsReporter LegacySubprocessResultsReporter सबप्रोसेस के नतीजों की जानकारी देने वाले रिपोर्टर को लागू करने की प्रक्रिया को कुछ समय के लिए रोकना, जो TF/CTS के पुराने वर्शन (उदाहरण के लिए, 8+) के साथ काम करना चाहिए. भले ही, इसके सुपर क्लास में बदलाव हुए हों.

---

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: टेस्ट की पहचान करता है