नाममंगल लिस्टनर

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

java.lang.ऑब्जेक्ट
मैं	com.android.tradefed.result.NameMangleListener

---

परिणाम के रूप में परीक्षण विधि, वर्ग और पैकेज नामों का अनुवाद करने के लिए एक प्रॉक्सी श्रोता।

सारांश

सार्वजनिक निर्माणकर्ता
NameMangleListener ( ITestInvocationListener listener)

सार्वजनिक तरीके
TestSummary	getSummary () आमंत्रण सूची को सारांश वापस करने की अनुमति देता है।
void	invocationEnded (long elapsedTime) रिपोर्ट करता है कि आमंत्रण समाप्त हो गया है, चाहे सफलतापूर्वक या किसी त्रुटि स्थिति के कारण।
void	invocationFailed (Throwable cause) किसी त्रुटि स्थिति के कारण अपूर्ण आमंत्रण की रिपोर्ट करता है।
void	invocationStarted ( IInvocationContext context) परीक्षण आमंत्रण की शुरुआत की रिपोर्ट करता है।
void	testAssumptionFailure ( TestDescription test, String trace) कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है
void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) एक व्यक्तिगत परीक्षण मामले के निष्पादन के अंत की रिपोर्ट करता है।
void	testFailed ( TestDescription test, String trace) एक व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।
void	testIgnored ( TestDescription test) तब कॉल किया जाता है जब कोई परीक्षण नहीं चलाया जाएगा, आम तौर पर क्योंकि एक परीक्षण विधि को org.junit.Ignore के साथ एनोटेट किया जाता है।
void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) परीक्षण आमंत्रण से संबंधित लॉग या डीबग डेटा प्रदान करता है।
void	testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics) परीक्षण चलाने के अंत की रिपोर्ट।
void	testRunFailed (String errorMessage) एक घातक त्रुटि के कारण रिपोर्ट टेस्ट रन पूरा नहीं हो सका।
void	testRunStarted (String runName, int testCount) एक परीक्षण चलाने की शुरुआत की रिपोर्ट करता है।
void	testRunStopped (long elapsedTime) उपयोगकर्ता के अनुरोध के कारण रिपोर्ट का परीक्षण पूरा होने से पहले रुक गया।
void	testStarted ( TestDescription test) एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है।

संरक्षित तरीके
TestDescription	mangleTestId ( TestDescription test) यह विधि सभी TestDescription s पर चलती है जो testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) और ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) कॉलबैक।
String	mangleTestRunName (String name) यह विधि सभी टेस्ट रन नामों पर चलती है जो testRunStarted(String, int) कॉलबैक में पास हो जाते हैं।

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

नाममंगल लिस्टनर

public NameMangleListener (ITestInvocationListener listener)

मापदंडों
listener	ITestInvocationListener

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

सारांश प्राप्त करें

public TestSummary getSummary ()

आमंत्रण सूची को सारांश वापस करने की अनुमति देता है।

रिटर्न
TestSummary	रन, या नल को सारांशित करने वाला एक TestSummary सारांश

आह्वान समाप्त

public void invocationEnded (long elapsedTime)

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

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

मापदंडों
elapsedTime	long : ms . में आह्वान का बीता हुआ समय

आह्वानविफल

public void invocationFailed (Throwable cause)

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

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

मापदंडों
cause	Throwable : विफलता का Throwable कारण

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

public void invocationStarted (IInvocationContext context)

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

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

मापदंडों
context	IInvocationContext : आमंत्रण के बारे में जानकारी

परीक्षण धारणाविफलता

public void testAssumptionFailure (TestDescription test, 
                String trace)

कॉल किया जाता है जब एक परमाणु परीक्षण ध्वजांकित करता है कि यह एक ऐसी स्थिति मानता है जो झूठी है

मापदंडों
test	TestDescription : टेस्ट की पहचान करता है
trace	String : विफलता का स्टैक ट्रेस

परीक्षण समाप्त

public void testEnded (TestDescription test, 
                 testMetrics)

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

यदि testFailed(TestDescription, FailureDescription) लागू नहीं किया गया था, तो यह परीक्षा उत्तीर्ण हुई। किसी भी कुंजी/मान मेट्रिक्स को भी लौटाता है जो परीक्षण मामले के निष्पादन के दौरान उत्सर्जित हो सकते हैं।

मापदंडों
test	TestDescription : टेस्ट की पहचान करता है
testMetrics	: उत्सर्जित मीट्रिक का एक ERROR(/Map)

परीक्षण विफल

public void testFailed (TestDescription test, 
                String trace)

एक व्यक्तिगत परीक्षण मामले की विफलता की रिपोर्ट करता है।

टेस्टस्टार्ट और टेस्टएंडेड के बीच बुलाया जाएगा।

मापदंडों
test	TestDescription : टेस्ट की पहचान करता है
trace	String : विफलता का स्टैक ट्रेस

परीक्षण पर ध्यान नहीं दिया गया

public void testIgnored (TestDescription test)

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

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

टेस्टलॉग

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

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

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

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

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

टेस्टरनसमाप्त

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

टेस्टरनविफल

public void testRunFailed (String errorMessage)

एक घातक त्रुटि के कारण रिपोर्ट टेस्ट रन पूरा नहीं हो सका।

मापदंडों
errorMessage	String : रन विफलता के कारण का वर्णन करने वाला String ।

टेस्टरनस्टार्ट किया गया

public void testRunStarted (String runName, 
                int testCount)

एक परीक्षण चलाने की शुरुआत की रिपोर्ट करता है।

मापदंडों
runName	String : टेस्ट रन नाम
testCount	int : टेस्ट रन में परीक्षणों की कुल संख्या

टेस्टरनस्टॉप्ड

public void testRunStopped (long elapsedTime)

उपयोगकर्ता के अनुरोध के कारण रिपोर्ट का परीक्षण पूरा होने से पहले रुक गया।

TODO: वर्तमान में अप्रयुक्त, हटाने पर विचार करें

मापदंडों
elapsedTime	long : डिवाइस ने बीता हुआ समय, मिलीसेकंड में सूचित किया

परीक्षण शुरू हुआ

public void testStarted (TestDescription test)

एक व्यक्तिगत परीक्षण मामले की शुरुआत की रिपोर्ट करता है। पुराना इंटरफ़ेस, जब भी संभव हो testStarted(com.android.tradefed.result.TestDescription) का उपयोग करना चाहिए।

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

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

mangleTestId

protected TestDescription mangleTestId (TestDescription test)

यह विधि सभी TestDescription s पर चलती है जो testStarted(com.android.tradefed.result.TestDescription) , testFailed(com.android.tradefed.result.TestDescription, String) और ERROR(/#testEnded(com.android.tradefed.result.TestDescription,HashMap)) कॉलबैक। विधि को संभावित रूप से भिन्न TestDescription वापस करना चाहिए जो डाउनस्ट्रीम ITestInvocationListener को पास किया जाएगा जो निर्माण के दौरान निर्दिष्ट किया गया था।

कार्यान्वयन सावधान रहना चाहिए कि मूल TestDescription को संशोधित न करें।

डिफ़ॉल्ट कार्यान्वयन आने वाले पहचानकर्ता को असंशोधित के माध्यम से पास करता है।

मापदंडों
test	TestDescription

रिटर्न
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

यह विधि सभी टेस्ट रन नामों पर चलती है जो testRunStarted(String, int) कॉलबैक में पास हो जाते हैं। विधि को एक संभावित-अलग परीक्षण रन नाम वापस करना चाहिए जो डाउनस्ट्रीम ITestInvocationListener को पास किया जाएगा जो निर्माण के दौरान निर्दिष्ट किया गया था।

मूल रन नाम को संशोधित न करने के लिए कार्यान्वयन सावधान रहना चाहिए।

डिफ़ॉल्ट कार्यान्वयन आने वाले टेस्ट रन नाम को असंशोधित के माध्यम से पास करता है।

मापदंडों
name	String

रिटर्न
String