সাবপ্রসেসরেজাল্টসরিপোর্টার

public class SubprocessResultsReporter
extends Object implements AutoCloseable, ILogSaverListener , ISupportGranularResults , ITestInvocationListener

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


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,LogDataType,InputStreamSource,LogFile) কলব্যাকে তা করার সুযোগ নেই।

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, HashMap<String, MetricMeasurement.Metric> metrics)

testEnded(TestDescription,Map) এর একটি বিকল্প যেখানে আমরা সরাসরি শেষের সময় নির্দিষ্ট করতে পারি।

void testEnded ( TestDescription testId, HashMap<String, MetricMeasurement.Metric> 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, HashMap<String, MetricMeasurement.Metric> 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(TestDescription) এর একটি বিকল্প, যেখানে আমরা পরীক্ষাটি কখন শুরু হয়েছিল তাও উল্লেখ করি, এবং সঠিক পরিমাপের জন্য testEnded(TestDescription,long,Map) এর সাথে একত্রিত করা হয়।

void testStarted ( TestDescription testId)

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

সরকারি নির্মাণকারী

সাবপ্রসেসরেজাল্টসরিপোর্টার

public SubprocessResultsReporter ()

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

বন্ধ

public void close ()

সারসংক্ষেপ পান

public TestSummary getSummary ()

InvocationListener-কে একটি সারাংশ ফেরত দেওয়ার অনুমতি দেয়।

ফেরত
TestSummary রানটির সারসংক্ষেপকারী একটি TestSummary , অথবা নাল

আহ্বান শেষ হয়েছে

public void invocationEnded (long elapsedTime)

রিপোর্ট করছে যে আহ্বানটি সফলভাবে অথবা কোনো ত্রুটির কারণে সমাপ্ত হয়েছে।

ট্রেডফেডারেশন ফ্রেমওয়ার্ক দ্বারা স্বয়ংক্রিয়ভাবে কল করা হবে।

প্যারামিটার
elapsedTime long : আহ্বানের অতিবাহিত সময় (মিলিসেকেন্ডে)

আহ্বান ব্যর্থ হয়েছে

public void invocationFailed (FailureDescription failure)

কোনো ত্রুটির কারণে আহ্বানটি অসম্পূর্ণ রয়েছে বলে জানানো হয়েছে।

ট্রেডফেডারেশন ফ্রেমওয়ার্ক দ্বারা স্বয়ংক্রিয়ভাবে কল করা হবে।

প্যারামিটার
failure FailureDescription : ব্যর্থতার কারণ বর্ণনা করে এমন FailureDescription

আহ্বান ব্যর্থ হয়েছে

public void invocationFailed (Throwable cause)

কোনো ত্রুটির কারণে আহ্বানটি অসম্পূর্ণ রয়েছে বলে জানানো হয়েছে।

ট্রেডফেডারেশন ফ্রেমওয়ার্ক দ্বারা স্বয়ংক্রিয়ভাবে কল করা হবে।

প্যারামিটার
cause Throwable : ব্যর্থতার Throwable কারণ

আহ্বান শুরু হয়েছে

public void invocationStarted (IInvocationContext context)

টেস্ট আহ্বানের সূচনা রিপোর্ট করে।

ট্রেডফেডারেশন ফ্রেমওয়ার্ক দ্বারা এটি স্বয়ংক্রিয়ভাবে কল করা হবে। একাধিক ডিভাইস থেকে রিপোর্টিং সমর্থন করার জন্য রিপোর্টারদের এই মেথডটি ওভাররাইড করতে হবে।

প্যারামিটার
context IInvocationContext : আহ্বান সম্পর্কিত তথ্য

লগঅ্যাসোসিয়েশন

public void logAssociation (String dataName, 
                LogFile logFile)

কিছু ক্ষেত্রে, লগ-কে টেস্ট কেসের সাথে দৃঢ়ভাবে যুক্ত করতে হয়, কিন্তু সরাসরি testLogSaved(String,LogDataType,InputStreamSource,LogFile) কলব্যাকে তা করার সুযোগ থাকে না। তাই, এই কলব্যাকটি সুস্পষ্টভাবে একটি দৃঢ় সংযোগ প্রদানের সুযোগ করে দেয়।

প্যারামিটার
dataName String : ডেটার নাম

logFile LogFile : পূর্বে লগ করা LogFile , যা টেস্ট কেসের সাথে যুক্ত থাকা উচিত।

প্রিন্টইভেন্ট

public void printEvent (String key, 
                Object event)

প্রথমে ইভেন্ট কী এবং তারপর json অবজেক্টটি প্রিন্ট করার সহায়ক।

প্যারামিটার
key String

event Object

আউটপুট টেস্ট লগ সেট করুন

public void setOutputTestLog (boolean outputTestLog)

টেস্ট লগটি আউটপুট করা হবে কি না, তা নির্ধারণ করে।

প্যারামিটার
outputTestLog boolean

দানাদার ফলাফল সমর্থন করুন

public boolean supportGranularResults ()

রিপোর্টারটি সূক্ষ্ম ফলাফল সমর্থন করলে True, অন্যথায় False রিটার্ন করে।

ফেরত
boolean

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

public void testAssumptionFailure (TestDescription testId, 
                String trace)

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

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

trace String : ব্যর্থতার স্ট্যাক ট্রেস

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

public void testAssumptionFailure (TestDescription testId, 
                FailureDescription failure)

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

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

failure FailureDescription : ব্যর্থতা এবং এর প্রেক্ষাপট বর্ণনা করে এমন FailureDescription

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

public void testEnded (TestDescription testId, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> metrics)

testEnded(TestDescription,Map) -এর একটি বিকল্প, যেখানে আমরা সরাসরি শেষের সময় নির্দিষ্ট করতে পারি। সঠিক পরিমাপের জন্য testStarted(TestDescription,long) এর সাথে একত্রিত করুন।

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

endTime long : পরীক্ষা শেষ হওয়ার সময়, যা System.currentTimeMillis() এর মাধ্যমে পরিমাপ করা হয়।

metrics HashMap : নির্গত মেট্রিকগুলোর একটি Map

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

public void testEnded (TestDescription testId, 
                HashMap<String, MetricMeasurement.Metric> metrics)

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

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

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

metrics HashMap : নির্গত মেট্রিকগুলোর একটি Map

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

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 : পরীক্ষাটি শনাক্ত করে

টেস্টলগ

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

টেস্ট আহ্বানের সাথে সম্পর্কিত লগ বা ডিবাগ ডেটা প্রদান করে।

ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) অথবা ERROR(/ITestInvocationListener#invocationEnded(long)) এর আগে অবশ্যই কল করতে হবে।

TradeFederation ফ্রেমওয়ার্কটি হোস্ট লগ এবং প্রযোজ্য ক্ষেত্রে ডিভাইস লগক্যাট প্রদান করে স্বয়ংক্রিয়ভাবে এই মেথডটি কল করবে।

প্যারামিটার
dataName String : ডেটার একটি বর্ণনামূলক String নাম। যেমন "device_logcat"। উল্লেখ্য যে, প্রতিবার ব্যবহারের ক্ষেত্রে dataName অনন্য নাও হতে পারে। অর্থাৎ, বাস্তবায়নকারীদের অবশ্যই একই dataName দিয়ে একাধিক কল পরিচালনা করতে সক্ষম হতে হবে।

dataType LogDataType : ডেটার LogDataType

dataStream InputStreamSource : ডেটার InputStreamSource । বাস্তবায়নকারীদের ডেটা পড়া শুরু করার জন্য createInputStream কল করতে হবে এবং কাজ শেষ হলে প্রাপ্ত InputStream-টি বন্ধ করা নিশ্চিত করতে হবে। কলারদের নিশ্চিত করতে হবে যে testLog মেথডটি সম্পূর্ণ না হওয়া পর্যন্ত ডেটার উৎসটি উপস্থিত এবং অ্যাক্সেসযোগ্য থাকে।

টেস্টমডিউল শেষ হয়েছে

public void testModuleEnded ()

একটি মডিউল চালনার সমাপ্তি ঘোষণা করে।

টেস্টমডিউলশুরু হয়েছে

public void testModuleStarted (IInvocationContext moduleContext)

একটি মডিউলের চলমান অবস্থা রিপোর্ট করে। এই কলব্যাকটি testModuleEnded() এর সাথে যুক্ত এবং সিকোয়েন্সে এটি ঐচ্ছিক। এটি শুধুমাত্র সেইসব রানের সময় ব্যবহৃত হয় যেগুলো মডিউল ব্যবহার করে: স্যুট ভিত্তিক রানার।

প্যারামিটার
moduleContext IInvocationContext : মডিউলটির IInvocationContext

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

public void testRunEnded (long time, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

টেস্ট রান শেষ হওয়ার রিপোর্ট। সংশোধন: আমরা ভিন্ন টাইপের দুটি Map<> ইন্টারফেস ব্যবহার করতে পারি না, তাই এখানে HashMap ব্যবহার করতে হবে।

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

runMetrics HashMap : Metric ব্যবহার করে একটি পরীক্ষা চালানোর শেষে রিপোর্ট করা কী-ভ্যালু পেয়ারসমূহ।

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

public void testRunFailed (FailureDescription failure)

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

প্যারামিটার
failure FailureDescription : ব্যর্থতা এবং এর প্রেক্ষাপট বর্ণনা করে এমন FailureDescription

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

public void testRunFailed (String reason)

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

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

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

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

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

প্যারামিটার
runName String : টেস্ট রানের নাম

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

attemptNumber int : ক্রমিক সংখ্যা, যা একই runName-এর একাধিকবার চালিত হওয়া বিভিন্ন প্রচেষ্টাকে শনাক্ত করে। attemptNumber-টি ০-ভিত্তিক এবং প্রতিবার নতুন করে রান হওয়ার সাথে সাথে এর মান বাড়া উচিত। যেমন, একটি টেস্টকে যদি ৩ বার সুনির্দিষ্টভাবে পুনরায় চালানো হয়, তাহলে একই runName-এর অধীনে মোট ৪টি রান হবে এবং attemptNumber-এর মান ০ থেকে ৩-এর মধ্যে হবে।

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

public void testRunStarted (String runName, 
                int testCount)

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

প্যারামিটার
runName String : টেস্ট রানের নাম

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

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

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

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

প্যারামিটার
runName String : টেস্ট রানের নাম

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

attemptNumber int : ক্রমিক সংখ্যা, যা একই runName-এর একাধিকবার চালিত হওয়া বিভিন্ন প্রচেষ্টাকে শনাক্ত করে। attemptNumber-টি ০-ভিত্তিক এবং প্রতিবার নতুন করে রান হওয়ার সাথে সাথে এর মান বাড়া উচিত। যেমন, একটি টেস্টকে যদি ৩ বার সুনির্দিষ্টভাবে পুনরায় চালানো হয়, তাহলে একই runName-এর অধীনে মোট ৪টি রান হবে এবং attemptNumber-এর মান ০ থেকে ৩-এর মধ্যে হবে।

startTime long : রান শুরু হওয়ার সময়, যা System.currentTimeMillis() এর মাধ্যমে পরিমাপ করা হয়।

testRunStopped

public void testRunStopped (long arg0)

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

করণীয়: বর্তমানে অব্যবহৃত, সরিয়ে ফেলার কথা বিবেচনা করুন।

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

পরীক্ষা এড়িয়ে যাওয়া হয়েছে

public void testSkipped (TestDescription testId, 
                SkipReason reason)

যখন কোনো টেস্ট অপ্রত্যাশিত কোনো কারণে বাদ পড়ে যায় বা সম্পাদিত হয় না, তখন এটি কল করা হয়। এই টেস্টগুলো সঠিকভাবে সম্পাদনের চেষ্টা করার জন্য পুনরায় চেষ্টা করা হবে।

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

reason SkipReason : SkipReason

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

public void testStarted (TestDescription testId, 
                long startTime)

testStarted(TestDescription) এর একটি বিকল্প, যেখানে আমরা পরীক্ষাটি কখন শুরু হয়েছিল তাও উল্লেখ করি, এবং সঠিক পরিমাপের জন্য testEnded(TestDescription,long,Map) এর সাথে একত্রিত করা হয়।

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

startTime long : পরীক্ষা শুরুর সময়, যা System.currentTimeMillis() এর মাধ্যমে পরিমাপ করা হয়।

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

public void testStarted (TestDescription testId)

একটি স্বতন্ত্র টেস্ট কেসের শুরু রিপোর্ট করে। এটি পুরোনো ইন্টারফেস, সম্ভব হলে testStarted(TestDescription) ব্যবহার করা উচিত।

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