ShardListener

public class ShardListener
extends CollectingTestListener implements ISupportGranularResults

java.lang.Object
↳	com.android.tradefed.result.CollectingTestListener
	↳	com.android.tradefed.invoker.ShardListener

---

एक ITestInvocationListener जो एक इनवोकेशन शार्ड से परिणाम एकत्र करता है (उर्फ एक इनवोकेशन स्प्लिट जो समानांतर में कई संसाधनों पर चलने के लिए होता है), और उन्हें दूसरे श्रोता को अग्रेषित करता है।

सारांश

सार्वजनिक निर्माणकर्ता
ShardListener ( ITestInvocationListener main) एक ShardListener बनाएं।

सार्वजनिक तरीके
	getUnderlyingResultReporter ()
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) कॉलबैक संभव नहीं है।
void	setSupportGranularResults (boolean enableGranularResults)
boolean	supportGranularResults () यदि रिपोर्टर विस्तृत परिणामों का समर्थन करता है तो सही देता है, अन्यथा गलत देता है।
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) परीक्षण मंगलाचरण से संबंधित लॉग या डीबग डेटा प्रदान करता है।
void	testLogSaved (String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)
void	testModuleEnded () एक मॉड्यूल रन के अंत की रिपोर्ट करता है।
void	testModuleStarted ( IInvocationContext moduleContext) चलने वाले मॉड्यूल की शुरुआत की रिपोर्ट करता है।
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) टेस्ट रन के अंत की रिपोर्ट।
void	testRunFailed ( FailureDescription failure) विफलता FailureDescription द्वारा वर्णित विफलता के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।
void	testRunFailed (String failureMessage) घातक त्रुटि के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।
void	testRunStarted (String name, int numTests, int attemptNumber, long startTime) टेस्ट रन की शुरुआत की रिपोर्ट करता है।

सार्वजनिक निर्माणकर्ता

ShardListener

public ShardListener (ITestInvocationListener main)

एक ShardListener बनाएं।

पैरामीटर
main	ITestInvocationListener : ITestInvocationListener परिणामों को अग्रेषित किया जाना चाहिए। अन्य ShardListener s के साथ टकराव को रोकने के लिए, परिणाम अग्रेषित करते समय यह ऑब्जेक्ट main पर सिंक्रनाइज़ हो जाएगा। और मंगलाचरण ठीक होने के बाद ही परिणाम भेजे जाएंगे।

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

getUnderlyingResultReporter

public  getUnderlyingResultReporter ()

रिटर्न

मंगलाचरणसमाप्त

public void invocationEnded (long elapsedTime)

रिपोर्ट करता है कि आमंत्रण समाप्त हो गया है, चाहे सफलतापूर्वक या कुछ त्रुटि स्थिति के कारण।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
elapsedTime	long : एमएस में मंगलाचरण का बीता हुआ समय

मंगलाचरण विफल

public void invocationFailed (FailureDescription failure)

कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
failure	FailureDescription : FailureDescription विफलता के कारण का वर्णन करता है

मंगलाचरण विफल

public void invocationFailed (Throwable cause)

कुछ त्रुटि स्थिति के कारण अपूर्ण मंगलाचरण की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा।

पैरामीटर
cause	Throwable : ERROR(/Throwable) विफलता का कारण

मंगलाचरण प्रारंभ

public void invocationStarted (IInvocationContext context)

परीक्षण आमंत्रण की शुरुआत की रिपोर्ट करता है।

ट्रेडफेडरेशन फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाएगा। एकाधिक डिवाइस रिपोर्टिंग का समर्थन करने के लिए रिपोर्टरों को इस विधि को ओवरराइड करने की आवश्यकता है।

पैरामीटर
context	IInvocationContext : मंगलाचरण के बारे में जानकारी

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

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

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

setSupportGranularResults

public void setSupportGranularResults (boolean enableGranularResults)

पैरामीटर
enableGranularResults	boolean

समर्थनGranularResults

public boolean supportGranularResults ()

यदि रिपोर्टर विस्तृत परिणामों का समर्थन करता है तो सही देता है, अन्यथा गलत देता है।

रिटर्न
boolean

testLog

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

परीक्षण मंगलाचरण से संबंधित लॉग या डीबग डेटा प्रदान करता है।

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

ट्रेडफेडरेशन फ्रेमवर्क स्वचालित रूप से इस विधि को कॉल करेगा, होस्ट लॉग प्रदान करेगा और यदि लागू हो, डिवाइस लॉगकैट।

पैरामीटर
dataName	String : एक ERROR(/String) डेटा का वर्णनात्मक नाम। उदाहरण के लिए "डिवाइस_लॉगकैट"। नोट dataName प्रति मंगलाचरण अद्वितीय नहीं हो सकता है। यानी कार्यान्वयनकर्ताओं को एक ही डेटानाम के साथ कई कॉलों को संभालने में सक्षम होना चाहिए
dataType	LogDataType : डेटा का LogDataType
dataStream	InputStreamSource : डेटा का InputStreamSource । कार्यान्वयनकर्ताओं को डेटा पढ़ना शुरू करने के लिए createInputStream को कॉल करना चाहिए और पूरा होने पर परिणामी InputStream को बंद करना सुनिश्चित करना चाहिए। कॉल करने वालों को यह सुनिश्चित करना चाहिए कि टेस्टलॉग विधि पूरी होने तक डेटा का स्रोत मौजूद और सुलभ रहे।

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

पैरामीटर
dataName	String
dataType	LogDataType
dataStream	InputStreamSource
logFile	LogFile

testModuleEnd

public void testModuleEnded ()

एक मॉड्यूल रन के अंत की रिपोर्ट करता है।

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

चलने वाले मॉड्यूल की शुरुआत की रिपोर्ट करता है। यह कॉलबैक testModuleEnded() से संबद्ध है और अनुक्रम में वैकल्पिक है। यह केवल एक रन के दौरान उपयोग किया जाता है जो मॉड्यूल का उपयोग करता है: सूट आधारित धावक।

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

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

टेस्ट रन के अंत की रिपोर्ट। FIXME: हमारे पास अलग-अलग प्रकार के दो मैप<> इंटरफेस नहीं हो सकते हैं, इसलिए हमें यहां हैश मैप का उपयोग करना होगा।

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

testrunFailed

public void testRunFailed (FailureDescription failure)

विफलता FailureDescription द्वारा वर्णित विफलता के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।

पैरामीटर
failure	FailureDescription : FailureDescription विफलता और उसके संदर्भ का वर्णन करता है।

testrunFailed

public void testRunFailed (String failureMessage)

घातक त्रुटि के कारण रिपोर्ट परीक्षण रन पूरा करने में विफल रहा।

पैरामीटर
failureMessage	String : ERROR(/String) रन विफलता के कारण का वर्णन करता है।

testrunStarted

public void testRunStarted (String name, 
                int numTests, 
                int attemptNumber, 
                long startTime)

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

पैरामीटर
name	String : टेस्ट रन नाम
numTests	int : परीक्षण चलाने में परीक्षणों की कुल संख्या
attemptNumber	int : क्रम संख्या, एक ही रननाम के विभिन्न प्रयासों की पहचान करना जो कई बार चलते हैं। प्रयास संख्या 0-अनुक्रमित है और हर बार एक नया रन होने पर वृद्धि होनी चाहिए। उदाहरण के लिए एक परीक्षण को 3 बार पुन: प्रयास किया जाता है, इसमें एक ही रननाम के तहत कुल 4 रन होने चाहिए और प्रयास संख्या 0 से 3 तक होती है।
startTime	long : रन शुरू होने का समय, ERROR(/System#currentTimeMillis()) द्वारा मापा गया