ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

TradeFederation कमांड चलाने के लिए शेड्यूलर.

खास जानकारी

नेस्ट की गई क्लास

interface ICommandScheduler.IScheduledInvocationListener

जब अनुरोध पूरा हो जाता है, तब अनुरोध करने से जुड़े इवेंट के लिए लिसनर. 

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

abstract Pair<Boolean, Integer> addCommand(String[] args)

शेड्यूलर में कोई निर्देश जोड़ता है.

abstract void addCommandFile(String cmdFile, extraArgs)

यह शेड्यूलर में, दी गई फ़ाइल के सभी निर्देश जोड़ता है

abstract void await()

शेड्यूलर के चलने का इंतज़ार करता है. इसमें, अगर लागू हो, तो पुराने टीएफ़ से हैंडओवर की प्रोसेस पूरी होने का इंतज़ार भी शामिल है.

abstract void displayCommandQueue(PrintWriter printWriter)

निर्देश लागू करने की सूची की स्थिति के बारे में ज़्यादा जानकारी वाला डीबग फ़ंक्शन.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

मौजूदा निर्देशों की सूची आउटपुट करें.

abstract void displayInvocationsInfo(PrintWriter printWriter)

मौजूदा अनुरोधों की सूची दिखाता है.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

सभी मौजूदा निर्देशों के लिए तय की गई सभी Option वैल्यू के साथ, निर्देश के लिए बड़ी की गई एक्सएमएल फ़ाइल को डंप करें.

abstract long execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

यह किसी डिवाइस को सीधे तौर पर असाइन करता है और किसी मौजूदा IInvocationContext का इस्तेमाल करके, कमांड को कमांड कतार में जोड़े बिना उसे लागू करता है.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)

सीधे तौर पर किसी डिवाइस को असाइन करता है और उसे कमांड की सूची में जोड़े बिना कमांड को लागू करता है.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

पहले से असाइन किए गए डिवाइस पर सीधे तौर पर निर्देश लागू करें.

abstract long execCommand(ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args)

पहले से असाइन किए गए डिवाइसों पर सीधे तौर पर निर्देश लागू करें.

abstract CommandFileWatcher getCommandFileWatcher()

इस शेड्यूलर के लिए सही CommandFileWatcher पाना

abstract int getExecutingCommandCount()

यह उन निर्देशों की संख्या दिखाता है जो चल रहे हैं.

abstract String getInvocationInfo(int invocationId)

invocaton आईडी बताकर, invocaton की जानकारी दिखाएं.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

आखिरी बार ट्रिगर किए गए फ़ंक्शन के गड़बड़ी कोड को दिखाता है.

abstract Throwable getLastInvocationThrowable()

आखिरी बार चलने वाले Throwable को दिखाता है.

abstract int getReadyCommandCount()

यह फ़ंक्शन, सूची में मौजूद उन निर्देशों की संख्या दिखाता है जो इस्तेमाल के लिए तैयार हैं.

abstract boolean isDeviceInInvocationThread(ITestDevice device)

अगर डिवाइस का इस्तेमाल न्योता देने वाले किसी चालू थ्रेड के ज़रिए किया जाता है, तो 'सही' दिखाता है.

abstract void join()

शेड्यूलर के पूरा होने का इंतज़ार करता है.

abstract void join(long millis)

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

abstract void removeAllCommands()

शेड्यूलर से सभी निर्देश हटाना

abstract void setClearcutClient(ClearcutClient client)

हार्नेस डेटा की रिपोर्ट करने के लिए क्लाइंट सेट करना

abstract boolean shouldShutdownOnCmdfileError()

अगर हमें निर्देश से जुड़ी गड़बड़ियों की वजह से शेड्यूलर को बंद करना है, तो True दिखाएं

default void shutdown()

कमांड शेड्यूलर को सही तरीके से बंद करने की कोशिश करें.

abstract void shutdown(boolean notifyStop)

कमांड शेड्यूलर को सही तरीके से बंद करने की कोशिश करें.

abstract void shutdownHard(boolean killAdb)

कमांड शेड्यूलर को जबरदस्ती बंद करने की कोशिश करें.

abstract void shutdownHard()

कमांड शेड्यूलर को जबरदस्ती बंद करने की कोशिश करें.

abstract void shutdownOnEmpty()

shutdown() की तरह है, लेकिन बाहर निकलने से पहले सभी निर्देशों के लागू होने का इंतज़ार करेगा.

abstract void start()

ICommandScheduler शुरू करें.

abstract boolean stopInvocation(int invocationId, String cause)

चल रहे अनुरोध का आईडी बताकर उसे रोकें.

default boolean stopInvocation(int invocationId)

चल रहे अनुरोध का आईडी बताकर उसे रोकें.

abstract boolean stopInvocation(ITestInvocation invocation)

चल रहे अनुरोध को रोकना.

default void stopScheduling()

इससे नए टेस्ट शेड्यूल करने और उन्हें स्वीकार करने की सुविधा बंद हो जाती है. हालांकि, Tradefed की सुविधा बंद नहीं होती.

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

addCommand

public abstract Pair<Boolean, Integer> addCommand (String[] args)

शेड्यूलर में कोई निर्देश जोड़ता है.

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

अगर "--help" आर्ग्युमेंट दिया जाता है, तो कॉन्फ़िगरेशन के लिए सहायता टेक्स्ट, स्टैंडर्ड आउटपुट (stdout) में दिखेगा. ऐसा न करने पर, कॉन्फ़िगरेशन को सूची में जोड़ दिया जाएगा.

पैरामीटर
args String: कॉन्फ़िगरेशन के आर्ग्युमेंट.
रिटर्न
Pair<Boolean, Integer> अगर कमांड सफलतापूर्वक जोड़ा गया हो, तो वैल्यू का जोड़ा, पहला मान बूलियन true होता है. अगर कमांड को सही तरीके से जोड़ा गया है, तो दूसरी वैल्यू, कमांड ट्रैकर आईडी(नॉन-नेगेटिव वैल्यू) होती है. सभी डिवाइसों के लिए कमांड जोड़ने पर 0 दिखाया जाता है. इसके अलावा, -1 भी दिख सकता है.
थ्रो
ConfigurationException यदि आदेश पार्स नहीं किया जा सका

इन्हें भी देखें:

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

दी गई फ़ाइल के सभी निर्देशों को शेड्यूलर में जोड़ता है

पैरामीटर
cmdFile String: कमांड फ़ाइल का फ़ाइल सिस्टम पाथ
extraArgs : फ़ाइल से पार्स किए गए हर कमांड में जोड़ने के लिए, String आर्ग्युमेंट का ERROR(/List). यह खाली हो सकता है, लेकिन शून्य नहीं होना चाहिए.
थ्रो
ConfigurationException अगर कमांड फ़ाइल को पार्स नहीं किया जा सका

इन्हें भी देखें:

await

public abstract void await ()

शेड्यूलर के चलने का इंतज़ार करता है. इसमें, अगर लागू हो, तो पुराने टीएफ़ से हैंडओवर की प्रोसेस पूरी होने का इंतज़ार भी शामिल है.

DisplayCommandसूची

public abstract void displayCommandQueue (PrintWriter printWriter)

निर्देशों को लागू करने की सूची की स्थिति के बारे में, डीबग की पूरी जानकारी दिखाता है.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

मौजूदा निर्देशों की सूची दिखाता है.

पैरामीटर
printWriter PrintWriter: आउटपुट करने के लिए ERROR(/PrintWriter).
regex String: वह रेगुलर एक्सप्रेशन जिससे मैच होने वाले निर्देशों को प्रिंट किया जाना है. अगर यह वैल्यू शून्य है, तो सभी निर्देश प्रिंट हो जाएंगे.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

इस्तेमाल किए जाने वाले मौजूदा नामों की सूची दिखाता है.

पैरामीटर
printWriter PrintWriter: वह ERROR(/PrintWriter) जिसमें आउटपुट करना है.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

सभी मौजूदा निर्देशों के लिए तय की गई सभी Option वैल्यू के साथ, निर्देश के लिए बड़ी की गई एक्सएमएल फ़ाइल को डंप करें.

पैरामीटर
printWriter PrintWriter: स्टेटस को आउटपुट करने के लिए ERROR(/PrintWriter).
regex String: एक्सएमएल फ़ाइल को डंप करने के लिए, रेगुलर एक्सप्रेशन से मैच होने वाले निर्देशों की जानकारी. अगर यह वैल्यू शून्य है, तो सभी निर्देशों को डंप कर दिया जाएगा.

execCommand

public abstract long execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

यह किसी डिवाइस को सीधे तौर पर असाइन करता है और किसी मौजूदा IInvocationContext का इस्तेमाल करके, कमांड को कमांड कतार में जोड़े बिना उसे लागू करता है.

पैरामीटर
context IInvocationContext: पहले से मौजूद IInvocationContext.
listener ICommandScheduler.IScheduledInvocationListener: जिस ICommandScheduler.IScheduledInvocationListener को सूचना देनी है
args String: कमांड आर्ग्युमेंट
रिटर्न
long

थ्रो
ConfigurationException if command was invalid
NoDeviceException अगर कोई डिवाइस इस्तेमाल करने के लिए उपलब्ध नहीं है

एक्ज़ीक्यूट करें

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

सीधे तौर पर किसी डिवाइस को असाइन करता है और उसे कमांड की सूची में जोड़े बिना कमांड को लागू करता है.

पैरामीटर
listener ICommandScheduler.IScheduledInvocationListener: जिस ICommandScheduler.IScheduledInvocationListener को सूचना देनी है
args String: कमांड आर्ग्युमेंट
रिटर्न
long शेड्यूल किए गए निर्देश का शुरू करने का आईडी.
थ्रो
ConfigurationException if command was invalid
NoDeviceException अगर कोई डिवाइस इस्तेमाल करने के लिए उपलब्ध नहीं है

एक्ज़ीक्यूट करें

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

पहले से असाइन किए गए डिवाइस पर सीधे तौर पर निर्देश लागू करें.

पैरामीटर
listener ICommandScheduler.IScheduledInvocationListener: जिस ICommandScheduler.IScheduledInvocationListener को सूचना देनी है
device ITestDevice: इस्तेमाल करने के लिए ITestDevice
args String: कमांड आर्ग्युमेंट
रिटर्न
long शेड्यूल किए गए निर्देश का शुरू करने का आईडी.
थ्रो
ConfigurationException if command was invalid

execCommand

public abstract long execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                 devices, 
                String[] args)

पहले से असाइन किए गए डिवाइसों पर सीधे तौर पर निर्देश लागू करें.

पैरामीटर
listener ICommandScheduler.IScheduledInvocationListener: जिस ICommandScheduler.IScheduledInvocationListener को सूचना देनी है
devices : इस्तेमाल करने के लिए ERROR(/List)
args String: कमांड के आर्ग्युमेंट
रिटर्न
long शेड्यूल किए गए निर्देश का शुरू करने का आईडी.
थ्रो
ConfigurationException if command was invalid

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

इस शेड्यूलर के लिए सही CommandFileWatcher पाना

रिटर्न
CommandFileWatcher

get प्रोसेस करने के लिए कमांड और गिनती

public abstract int getExecutingCommandCount ()

यह उन निर्देशों की संख्या दिखाता है जो चल रहे हैं.

रिटर्न
int

CANNOT TRANSLATE

public abstract String getInvocationInfo (int invocationId)

invocaton आईडी बताकर, invocaton की जानकारी दिखाएं.

पैरामीटर
invocationId int: ट्रिगर करने का ट्रैकिंग आईडी.
रिटर्न
String एक String, जिसमें शुरू करने की जानकारी दी गई हो.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

आखिरी बार ट्रिगर किए गए फ़ंक्शन के गड़बड़ी कोड को दिखाता है. अगर अब तक कोई अनुरोध नहीं किया गया है, तो 0 (कोई गड़बड़ी नहीं) दिखाएं.

रिटर्न
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

पिछली बार शुरू किए गए निर्देश से Throwable को वापस भेजें. अगर कोई थ्रोएबल उपलब्ध नहीं है, तो शून्य दिखाता है.

रिटर्न
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

यह फ़ंक्शन, सूची में मौजूद उन निर्देशों की संख्या दिखाता है जो इस्तेमाल के लिए तैयार हैं.

रिटर्न
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

अगर डिवाइस का इस्तेमाल किसी चालू इनवोकेशन थ्रेड ने किया है, तो यह फ़ंक्शन 'सही' दिखाता है.

पैरामीटर
device ITestDevice

रिटर्न
boolean

शामिल हों

public abstract void join ()

शेड्यूलर के पूरा होने का इंतज़ार करता है.

इन्हें भी देखें:

शामिल हों

public abstract void join (long millis)

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

पैरामीटर
millis long

इन्हें भी देखें:

removeAllCommands

public abstract void removeAllCommands ()

शेड्यूलर से सभी निर्देश हटाना

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

हार्नेस डेटा की रिपोर्ट करने के लिए क्लाइंट सेट करें

पैरामीटर
client ClearcutClient

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

अगर हमें निर्देश से जुड़ी गड़बड़ियों की वजह से शेड्यूलर को बंद करना है, तो True दिखाएं

रिटर्न
boolean

बंद करना

public void shutdown ()

कमांड शेड्यूलर को सही तरीके से बंद करने की कोशिश करें.

जिन निर्देशों की जांच बाकी है उन्हें मिटाता है. साथ ही, यह अनुरोध करता है कि चल रहे सभी अनुरोधों को सही तरीके से बंद किया जाए.

शटडाउन का अनुरोध करने के बाद, शेड्यूलर का मुख्य लूप पूरी तरह से बाहर निकलने से पहले, सभी अनुरोधों के पूरा होने का इंतज़ार करेगा.

बंद करना

public abstract void shutdown (boolean notifyStop)

कमांड शेड्यूलर को सही तरीके से बंद करने की कोशिश करें.

पैरामीटर
notifyStop boolean: अगर सही है, तो TF के बंद होने की सूचना देता है.

शटडाउन हार्ड

public abstract void shutdownHard (boolean killAdb)

कमांड शेड्यूलर को जबरदस्ती बंद करने की कोशिश करें.

यह shutdown() जैसा ही है. हालांकि, यह ज़रूरी नहीं है कि यह adb कनेक्शन को बंद करे. ऐसा इसलिए किया जाता है, ताकि चल रहे अनुरोधों को तेज़ी से पूरा किया जा सके.

पैरामीटर
killAdb boolean

shutdownHard

public abstract void shutdownHard ()

कमांड शेड्यूलर को जबरदस्ती बंद करने की कोशिश करें. shutdownHard(true) के जैसा ही.

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

shutdown() की तरह ही, लेकिन बाहर निकलने से पहले सभी निर्देशों के लागू होने का इंतज़ार करेगा.

ध्यान दें कि अगर कोई निर्देश लूप मोड में है, तो शेड्यूलर कभी भी बंद नहीं होगा.

शुरू करें

public abstract void start ()

ICommandScheduler शुरू करें.

अन्य तरीकों को कॉल करने से पहले, इसे कॉल करना ज़रूरी है.

यह तब तक चलेगा, जब तक shutdown() को कॉल नहीं किया जाता. Thread.start() देखें.

शुरू करना बंद करो

public abstract boolean stopInvocation (int invocationId, 
                String cause)

चल रहे अनुरोध का आईडी बताकर उसे रोकें.

पैरामीटर
invocationId int: शुरू करने के अनुरोध का ट्रैकिंग आईडी.
cause String: कॉल को रोकने की वजह.
रिटर्न
boolean अगर अनुरोध रोक दिया गया था, तो 'सही'. अगर नहीं, तो 'गलत'
थ्रो
UnsupportedOperationException अगर लागू करने की सुविधा इसकी अनुमति नहीं देती है

शुरू करना बंद करो

public boolean stopInvocation (int invocationId)

चल रहे अनुरोध का आईडी बताकर उसे रोकें.

पैरामीटर
invocationId int

रिटर्न
boolean अगर अनुरोध रोक दिया गया था, तो 'सही'. अगर नहीं, तो 'गलत'
थ्रो
UnsupportedOperationException अगर लागू करने की सुविधा इसकी अनुमति नहीं देती है

शुरू करना बंद करें

public abstract boolean stopInvocation (ITestInvocation invocation)

चल रहे अनुरोध को रोकना.

पैरामीटर
invocation ITestInvocation

रिटर्न
boolean अगर अनुरोध रोक दिया गया था, तो 'सही'. अगर नहीं, तो 'गलत'
थ्रो
UnsupportedOperationException अगर लागू करने की सुविधा इसकी अनुमति नहीं देती है

stopScheduling

public void stopScheduling ()

इससे नए टेस्ट शेड्यूल करने और उन्हें स्वीकार करने की सुविधा बंद हो जाती है. हालांकि, Tradefed की सुविधा बंद नहीं होती. इसका मकसद, दो चरणों में बंद करने की सुविधा चालू करना है. इसमें, पहले हम चल रहे सभी टेस्ट को बंद कर देते हैं और फिर Tradefed प्रोसेस को बंद कर देते हैं.