আইটেস্টরানলিসেনার

public interface ITestRunListener

com.android.ddmlib.testrunner.ITestRunListener

পরিচিত পরোক্ষ উপশ্রেণী StubTestRunListener , TestRunResult , TestRunToTestInvocationForwarder , XmlTestRunListener স্টাবটেস্টরানলিসেনার ITestRunListener এর স্টাব বাস্তবায়ন টেস্টরানরেজাল্ট একটিমাত্র পরীক্ষার ফলাফল ধারণ করে। TestRunToTestInvocationForwarder ddmlib ITestRunListener থেকে ITestLifeCycleReceiver এ ফরওয়ার্ডার। এক্সএমএলটেস্টরানলিসেনার JUnit-এর ফলাফল Ant-এর XMLJUnitResultFormatter-এর সাথে সামঞ্জস্যপূর্ণ ফরম্যাটে XML ফাইলে লেখে।

---

ইন্সট্রুমেন্টেশন টেস্ট রান চলাকালীন ইভেন্ট নোটিফিকেশন গ্রহণ করে।

org.junit.runner.notification.RunListener-এর আদলে তৈরি।

কলগুলোর ক্রম হবে নিম্নরূপ:

• পরীক্ষা শুরু হয়েছে
• পরীক্ষা শুরু হয়েছে
• [পরীক্ষা ব্যর্থ]
• [পরীক্ষার অনুমান ব্যর্থতা]
• [পরীক্ষা উপেক্ষা করা হয়েছে]
• পরীক্ষা শেষ হয়েছে
• ....
• [পরীক্ষা ব্যর্থ হয়েছে]
• পরীক্ষা শেষ হয়েছে

সারসংক্ষেপ

জনসাধারণের পদ্ধতি
abstract void	testAssumptionFailure ( TestIdentifier test, String trace) যখন কোনো অ্যাটমিক টেস্ট এমন একটি শর্ত ধরে নেয় যা মিথ্যা, তখন এটি কল করা হয়।
abstract void	testEnded ( TestIdentifier test, Map<String, String> testMetrics) একটি স্বতন্ত্র টেস্ট কেসের নির্বাহ সমাপ্তির প্রতিবেদন দেয়।
abstract void	testFailed ( TestIdentifier test, String trace) কোনো একটি নির্দিষ্ট টেস্ট কেসের ব্যর্থতার প্রতিবেদন দেয়।
abstract void	testIgnored ( TestIdentifier test) যখন কোনো টেস্ট চালানো হবে না, তখন এটি কল করা হয়; সাধারণত এর কারণ হলো টেস্ট মেথডটি org.junit.Ignore দিয়ে অ্যানোটেট করা থাকে।
abstract void	testRunEnded (long elapsedTime, Map<String, String> runMetrics) পরীক্ষামূলক কার্যক্রমের সমাপ্তির প্রতিবেদন।
abstract void	testRunFailed (String errorMessage) একটি মারাত্মক ত্রুটির কারণে রিপোর্ট টেস্ট রান সম্পন্ন হতে পারেনি।
abstract void	testRunStarted (String runName, int testCount) একটি পরীক্ষামূলক চালনা শুরুর ঘোষণা দেয়।
abstract void	testRunStopped (long elapsedTime) এই পদ্ধতিটি অপ্রচলিত। এই কলব্যাকটি আর কখনও আহ্বান করা হবে না। এটি মুছে ফেলা হবে।
abstract void	testStarted ( TestIdentifier test) একটি স্বতন্ত্র টেস্ট কেস শুরু হওয়ার প্রতিবেদন দেয়।

জনসাধারণের পদ্ধতি

পরীক্ষার অনুমান ব্যর্থতা

public abstract void testAssumptionFailure (TestIdentifier test, 
                String trace)

যখন কোনো অ্যাটমিক টেস্ট এমন একটি শর্ত ধরে নেয় যা মিথ্যা, তখন এটি কল করা হয়।

প্যারামিটার
test	TestIdentifier : পরীক্ষাটি শনাক্ত করে
trace	String : ব্যর্থতার স্ট্যাক ট্রেস

পরীক্ষা শেষ হয়েছে

public abstract void testEnded (TestIdentifier test, 
                Map<String, String> testMetrics)

একটি স্বতন্ত্র টেস্ট কেসের নির্বাহ সমাপ্তির প্রতিবেদন দেয়।

যদি testFailed(TestIdentifier, String) কল করা না হয়ে থাকে, তাহলে এই টেস্টটি পাস করেছে। এছাড়াও, টেস্ট কেসটি চলার সময় নির্গত হওয়া যেকোনো কী/ভ্যালু মেট্রিক্সও ফেরত দেয়।

প্যারামিটার
test	TestIdentifier : পরীক্ষাটি শনাক্ত করে
testMetrics	Map : android.app.Instrumentation#sendStatus দ্বারা টেস্ট কেস নির্বাহের সময় নির্গত মেট্রিকগুলোর একটি Map । আপনি যদি একই কী একাধিকবার নির্গত না করেন, তবে ইনসারশন অর্ডার সংরক্ষিত থাকে। উল্লেখ্য যে, IInstrumentationResultParser.StatusKeys এ সংজ্ঞায়িত স্ট্যান্ডার্ড কীগুলো এই ম্যাপ থেকে ফিল্টার করে বাদ দেওয়া হয়। Ddmlib, IInstrumentationResultParser.StatusKeys এ সংজ্ঞায়িত অতিরিক্ত টেস্ট মেট্রিক যোগ করতে পারে।

পরীক্ষা ব্যর্থ হয়েছে

public abstract void testFailed (TestIdentifier test, 
                String trace)

কোনো একটি নির্দিষ্ট টেস্ট কেসের ব্যর্থতার প্রতিবেদন দেয়।

testStarted এবং testEnded-এর মধ্যে কল করা হবে।

প্যারামিটার
test	TestIdentifier : পরীক্ষাটি শনাক্ত করে
trace	String : ব্যর্থতার স্ট্যাক ট্রেস

পরীক্ষা উপেক্ষা করা হয়েছে

public abstract void testIgnored (TestIdentifier test)

যখন কোনো টেস্ট চালানো হবে না, তখন এটি কল করা হয়; সাধারণত এর কারণ হলো টেস্ট মেথডটি org.junit.Ignore দিয়ে অ্যানোটেট করা থাকে।

প্যারামিটার
test	TestIdentifier : পরীক্ষাটি শনাক্ত করে

পরীক্ষা শেষ হয়েছে

public abstract void testRunEnded (long elapsedTime, 
                Map<String, String> runMetrics)

পরীক্ষামূলক কার্যক্রমের সমাপ্তির প্রতিবেদন।

প্যারামিটার
elapsedTime	long : ডিভাইস দ্বারা রিপোর্ট করা অতিবাহিত সময়, মিলিসেকেন্ডে
runMetrics	Map : android.app.Instrumentation#addResults দ্বারা টেস্ট কেস নির্বাহের সময় নির্গত মেট্রিকগুলোর একটি Map । আপনি যদি একই কী একাধিকবার নির্গত না করেন, তবে ইনসারশন অর্ডার সংরক্ষিত থাকে। উল্লেখ্য যে, IInstrumentationResultParser.StatusKeys এ সংজ্ঞায়িত স্ট্যান্ডার্ড কীগুলো এই ম্যাপ থেকে ফিল্টার করে বাদ দেওয়া হয়। Ddmlib, IInstrumentationResultParser.StatusKeys এ সংজ্ঞায়িত অতিরিক্ত টেস্ট মেট্রিক যোগ করতে পারে।

পরীক্ষা ব্যর্থ হয়েছে

public abstract void testRunFailed (String errorMessage)

একটি মারাত্মক ত্রুটির কারণে রিপোর্ট টেস্ট রান সম্পন্ন হতে পারেনি।

প্যারামিটার
errorMessage	String : রান ব্যর্থ হওয়ার কারণ বর্ণনাকারী String ।

পরীক্ষা শুরু হয়েছে

public abstract void testRunStarted (String runName, 
                int testCount)

একটি পরীক্ষামূলক চালনা শুরুর ঘোষণা দেয়।

প্যারামিটার
runName	String : টেস্ট রানের নাম
testCount	int : টেস্ট রানে মোট পরীক্ষার সংখ্যা

testRunStopped

public abstract void testRunStopped (long elapsedTime)

এই পদ্ধতিটি অপ্রচলিত।
এই কলব্যাকটি আর কখনও কল করা হবে না। এটি মুছে ফেলা হবে।

একজন ব্যবহারকারীর অনুরোধের কারণে রিপোর্টের পরীক্ষামূলক চালনা সম্পূর্ণ হওয়ার আগেই বন্ধ করা হয়েছে।

প্যারামিটার
elapsedTime	long : ডিভাইস দ্বারা রিপোর্ট করা অতিবাহিত সময়, মিলিসেকেন্ডে

পরীক্ষা শুরু হয়েছে

public abstract void testStarted (TestIdentifier test)

একটি স্বতন্ত্র টেস্ট কেস শুরু হওয়ার প্রতিবেদন দেয়।

প্যারামিটার
test	TestIdentifier : পরীক্ষাটি শনাক্ত করে