NameMangleListener

public abstract class NameMangleListener
extends Object implements ITestInvocationListener

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

---

एक प्रॉक्सी लिसनर, जो नतीजों की रिपोर्ट के तौर पर टेस्ट करने के तरीके, क्लास, और पैकेज के नामों का अनुवाद करता है.

खास जानकारी

सार्वजनिक कंस्ट्रक्टर
NameMangleListener(ITestInvocationListener listener)

सार्वजनिक तरीके
TestSummary	getSummary() InvocationListener को जवाब देने की अनुमति देता है.
void	invocationEnded(long elapsedTime) ऐसी रिपोर्ट जिनमें बताया गया हो कि शुरू करने की प्रोसेस को रद्द कर दिया गया है, भले ही वे किसी गड़बड़ी की वजह से रद्द हो गए हों स्थिति.
void	invocationFailed(Throwable cause) किसी गड़बड़ी की स्थिति की वजह से, कॉल शुरू करने की प्रोसेस पूरी नहीं होने की रिपोर्ट करता है.
void	invocationStarted(IInvocationContext context) यह टेस्ट शुरू होने की रिपोर्ट करता है.
void	testAssumptionFailure(TestDescription test, String trace) इसे तब कॉल किया जाता है, जब कोई ऐटॉमिक टेस्ट फ़्लैग करता है कि यह ऐसी स्थिति मान लेता है जो गलत है
void	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) टेस्ट रन खत्म होने की रिपोर्ट.
void	testRunFailed(String errorMessage) किसी गंभीर गड़बड़ी की वजह से, रिपोर्ट की जांच पूरी नहीं हो सकी.
void	testRunStarted(String runName, int testCount) टेस्ट रन शुरू होने की रिपोर्ट करता है.
void	testRunStopped(long elapsedTime) उपयोगकर्ता के अनुरोध की वजह से, रिपोर्ट की जांच पूरी होने से पहले ही रुक गई.
void	testStarted(TestDescription test) यह रिपोर्ट, व्यक्तिगत टेस्ट केस की शुरुआत के बारे में बताती है.

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

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

NameMangleListener

public NameMangleListener (ITestInvocationListener listener)

पैरामीटर
listener	ITestInvocationListener

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

सारांश पाएं

public TestSummary getSummary ()

InvocationListener को जवाब देने की अनुमति देता है.

रिटर्न
TestSummary	दौड़ या शून्य की खास जानकारी वाला TestSummary

शुरू होने का समय खत्म

public void invocationEnded (long elapsedTime)

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

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

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

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

public void invocationFailed (Throwable cause)

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

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

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

शुरू किया गया

public void invocationStarted (IInvocationContext context)

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

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

पैरामीटर
context	IInvocationContext: शुरू करने के बारे में जानकारी

TestAssumptionFailure

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)

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

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

पैरामीटर
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))

ट्रेडफ़ेडरेशन फ़्रेमवर्क, होस्ट लॉग उपलब्ध कराते हुए, इस तरीके को अपने-आप कॉल करेगा और अगर लागू हो, तो डिवाइस Logcat.

पैरामीटर
dataName	String: डेटा के बारे में जानकारी देने वाला String नाम. उदाहरण के लिए, "device_logcat" है. नोट जोड़ें हर सवाल के लिए, dataName अलग नहीं हो सकता. यह ज़रूरी है कि लागू करने वाले लोग एक ही dataName के साथ कई कॉल
dataType	LogDataType: डेटा का LogDataType
dataStream	InputStreamSource: डेटा का InputStreamSource. लागू करने वालों को कॉल करना चाहिए createइनपुटStream डेटा पढ़ना शुरू करें और नतीजे को बंद करना न भूलें पूरा होने पर InputStream. कॉल करने वाले (कॉलर) को यह पक्का करना चाहिए कि डेटा का सोर्स हमेशा बना रहे यह सिर्फ़ तब तक मौजूद और ऐक्सेस किया जा सकता है, जब तक testLog तरीके के पूरा नहीं हो जाता.

testRunEnded

public void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

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

public void testRunFailed (String errorMessage)

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

पैरामीटर
errorMessage	String: String, रन नहीं होने की वजह बता रहा है.

testRunStarted

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)

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

लागू करने के दौरान, आपको इस बात का ध्यान रखना चाहिए कि मूल TestDescription में कोई बदलाव न हो.

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

पैरामीटर
test	TestDescription

रिटर्न
TestDescription

mangleTestRunName

protected String mangleTestRunName (String name)

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

लागू करने के दौरान, आपको इस बात का ध्यान रखना चाहिए कि ओरिजनल रन नेम में कोई बदलाव न हो.

डिफ़ॉल्ट तौर पर लागू होने वाला टेस्ट रन नेम में कोई बदलाव नहीं किया गया है.

पैरामीटर
name	String

रिटर्न
String