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 ()

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

displayCommandQueue

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 अगर कोई डिवाइस इस्तेमाल करने के लिए उपलब्ध नहीं है

execCommand

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

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

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

execCommand

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

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

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

रिटर्न
int

getInvocationInfo

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 बंद करने के अनुरोधों की सूचना दी जाती है.

shutdownHard

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() देखें.

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

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

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

stopInvocation

public boolean stopInvocation (int invocationId)

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

पैरामीटर
invocationId int

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

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

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

पैरामीटर
invocation ITestInvocation

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

stopScheduling

public void stopScheduling ()

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