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) addCommandFile (String cmdFile, extraArgs)

เพิ่มคำสั่งทั้งหมดจากไฟล์ที่กำหนดไปยังตัวกำหนดตารางเวลา

abstract void await ()

รอให้ตัวกำหนดตารางเวลาเริ่มทำงาน รวมถึงการรอการส่งมอบจาก TF เก่าให้เสร็จสิ้น หากมี

abstract void displayCommandQueue (PrintWriter printWriter)

ส่งออกข้อมูลการดีบักโดยละเอียดเกี่ยวกับสถานะของคิวดำเนินการคำสั่ง

abstract void displayCommandsInfo (PrintWriter printWriter, String regex)

ส่งออกรายการคำสั่งปัจจุบัน

abstract void displayInvocationsInfo (PrintWriter printWriter)

แสดงรายการคำร้องปัจจุบัน

abstract void dumpCommandsXml (PrintWriter printWriter, String regex)

ดัมพ์ไฟล์ xml ที่ขยายสำหรับคำสั่งที่มีค่า 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, devices, String[] args) execCommand ( ICommandScheduler.IScheduledInvocationListener listener, devices, String[] args)

ดำเนินการคำสั่งโดยตรงบนอุปกรณ์ที่จัดสรรไว้แล้ว

abstract CommandFileWatcher getCommandFileWatcher ()

รับ CommandFileWatcher ที่เหมาะสมสำหรับตัวกำหนดตารางเวลานี้

abstract int getExecutingCommandCount ()

ส่งกลับจำนวนคำสั่งในสถานะดำเนินการ

abstract String getInvocationInfo (int invocationId)

ส่งคืนข้อมูลในการเรียกใช้ bu โดยระบุรหัสการเรียกใช้

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

คืนค่าจริงหากเราจำเป็นต้องปิดตัวกำหนดตารางเวลาเมื่อเกิดข้อผิดพลาดของคำสั่ง

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)

หยุดการเรียกใช้งาน

วิธีการสาธารณะ

เพิ่มคำสั่ง

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

เพิ่มคำสั่งไปยังตัวกำหนดตารางเวลา

คำสั่งคืออินสแตนซ์ของคอนฟิกูเรชันที่จะรันและอาร์กิวเมนต์ที่เกี่ยวข้อง

หากระบุอาร์กิวเมนต์ "--help" ข้อความช่วยเหลือสำหรับการกำหนดค่าจะถูกส่งออกไปยัง stdout มิฉะนั้น config จะถูกเพิ่มลงในคิวเพื่อรัน

พารามิเตอร์
args String : อาร์กิวเมนต์การกำหนดค่า

ส่งคืน
Pair <Boolean, Integer> คู่ของค่า ค่าแรกเป็นบูลีน true หากเพิ่มคำสั่งสำเร็จ ค่าที่สองคือรหัสตัวติดตามคำสั่งที่รู้จัก (ค่าที่ไม่ใช่ค่าลบ) หากเพิ่มคำสั่งสำเร็จ ให้คืนค่า 0 เมื่อมีการเพิ่มคำสั่งสำหรับอุปกรณ์ทั้งหมด มิฉะนั้น -1

พ่น
ConfigurationException หากไม่สามารถแยกวิเคราะห์คำสั่งได้

ดูสิ่งนี้ด้วย:

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

เพิ่มคำสั่งทั้งหมดจากไฟล์ที่กำหนดไปยังตัวกำหนดตารางเวลา

พารามิเตอร์
cmdFile String : เส้นทางระบบไฟล์ของไฟล์ comand

extraArgs : ERROR(/List) ของอาร์กิวเมนต์ String ที่จะต่อท้ายแต่ละคำสั่งที่แยกวิเคราะห์จากไฟล์ สามารถว่างเปล่าได้ แต่ไม่ควรเป็นโมฆะ

พ่น
ConfigurationException หากไม่สามารถแยกวิเคราะห์ไฟล์คำสั่งได้

ดูสิ่งนี้ด้วย:

รอ

public abstract void await ()

รอให้ตัวกำหนดตารางเวลาเริ่มทำงาน รวมถึงการรอการส่งมอบจาก TF เก่าให้เสร็จสิ้น หากมี

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

ส่งออกข้อมูลการดีบักโดยละเอียดเกี่ยวกับสถานะของคิวดำเนินการคำสั่ง

แสดงข้อมูลคำสั่ง

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

ส่งออกรายการคำสั่งปัจจุบัน

พารามิเตอร์
printWriter PrintWriter : ERROR(/PrintWriter) เพื่อส่งออกไปยัง

regex String : นิพจน์ทั่วไปที่ควรจับคู่คำสั่งเพื่อพิมพ์ หากเป็น null คำสั่งทั้งหมดจะถูกพิมพ์

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

แสดงรายการคำร้องปัจจุบัน

พารามิเตอร์
printWriter PrintWriter : ERROR(/PrintWriter) เพื่อส่งออกไปยัง

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

ดัมพ์ไฟล์ xml ที่ขยายสำหรับคำสั่งที่มีค่า Option ทั้งหมดที่ระบุสำหรับคำสั่งปัจจุบันทั้งหมด

พารามิเตอร์
printWriter PrintWriter : ERROR(/PrintWriter) เพื่อส่งออกสถานะไปที่

regex String : นิพจน์ทั่วไปที่ควรจับคู่คำสั่งเพื่อให้ไฟล์ xml ถูกดัมพ์ หากเป็น null คำสั่งทั้งหมดจะถูกทิ้ง

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 หากคำสั่งไม่ถูกต้อง
NoDeviceException ถ้าไม่มีอุปกรณ์ใช้

execCommand

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

จัดสรรอุปกรณ์โดยตรงและดำเนินการคำสั่งโดยไม่ต้องเพิ่มลงในคิวคำสั่ง

พารามิเตอร์
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener ที่จะแจ้งให้ทราบ

args String : อาร์กิวเมนต์ของคำสั่ง

ส่งคืน
long รหัสการเรียกใช้ของคำสั่งที่กำหนดเวลาไว้

พ่น
ConfigurationException หากคำสั่งไม่ถูกต้อง
NoDeviceException ถ้าไม่มีอุปกรณ์ใช้

execCommand

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

ดำเนินการคำสั่งโดยตรงบนอุปกรณ์ที่จัดสรรไว้แล้ว

พารามิเตอร์
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener ที่จะแจ้งให้ทราบ

devices : ERROR(/List ) ERROR(/List ) เพื่อใช้

args String : อาร์กิวเมนต์ของคำสั่ง

ส่งคืน
long รหัสการเรียกใช้ของคำสั่งที่กำหนดเวลาไว้

พ่น
ConfigurationException หากคำสั่งไม่ถูกต้อง

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

รับ CommandFileWatcher ที่เหมาะสมสำหรับตัวกำหนดตารางเวลานี้

ส่งคืน
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

ส่งกลับจำนวนคำสั่งในสถานะดำเนินการ

ส่งคืน
int

รับข้อมูลการร้องขอ

public abstract String getInvocationInfo (int invocationId)

ส่งคืนข้อมูลในการเรียกใช้ bu โดยระบุรหัสการเรียกใช้

พารามิเตอร์
invocationId int : รหัสการติดตามของการร้องขอ

ส่งคืน
String String ที่มีข้อมูลเกี่ยวกับการเรียกใช้

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

ส่งคืนรหัสข้อผิดพลาดของการเรียกใช้ครั้งล่าสุดที่เรียกใช้ ส่งคืน 0 (ไม่มีข้อผิดพลาด) หากยังไม่มีการเรียกใช้

ส่งคืน
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

คืนค่า Throwable จากการร้องขอครั้งล่าสุดที่เรียกใช้ คืนค่า null ถ้าไม่มีการโยนทิ้ง

ส่งคืน
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

ส่งกลับจำนวนคำสั่งในสถานะพร้อมในคิว

ส่งคืน
int

isDeviceInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

คืนค่าจริงหากอุปกรณ์ถูกใช้โดยเธรดการเรียกใช้ที่ใช้งานอยู่

พารามิเตอร์
device ITestDevice

ส่งคืน
boolean

เข้าร่วม

public abstract void join ()

รอให้ตัวกำหนดตารางเวลาเสร็จสิ้น

ดูสิ่งนี้ด้วย:

เข้าร่วม

public abstract void join (long millis)

รอให้ตัวกำหนดตารางเวลาเสร็จสิ้นหรือหมดเวลาหลังจากระยะเวลาที่ระบุเป็นมิลลิวินาที

พารามิเตอร์
millis long

ดูสิ่งนี้ด้วย:

ลบคำสั่งทั้งหมด

public abstract void removeAllCommands ()

ลบคำสั่งทั้งหมดออกจากตัวกำหนดตารางเวลา

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

ตั้งค่าไคลเอ็นต์ให้รายงานข้อมูลสายรัด

พารามิเตอร์
client ClearcutClient

ควรShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

คืนค่าจริงหากเราจำเป็นต้องปิดตัวกำหนดตารางเวลาเมื่อเกิดข้อผิดพลาดของคำสั่ง

ส่งคืน
boolean

ปิดตัวลง

public void shutdown ()

พยายามปิดตัวกำหนดตารางเวลาคำสั่งอย่างสง่างาม

ล้างคำสั่งที่รอการทดสอบ และขอให้การเรียกใช้ที่กำลังดำเนินการทั้งหมดปิดลงอย่างสง่างาม

หลังจากเรียกการปิดระบบ ลูปหลักของตัวกำหนดตารางเวลาจะรอให้การร้องขอทั้งหมดที่กำลังดำเนินอยู่เสร็จสิ้นก่อนที่จะออกโดยสมบูรณ์

ปิดตัวลง

public abstract void shutdown (boolean notifyStop)

พยายามปิดตัวกำหนดตารางเวลาคำสั่งอย่างสง่างาม

พารามิเตอร์
notifyStop boolean : ถ้าเป็นจริง แจ้งการร้องขอการปิดระบบ TF

ปิดฮาร์ด

public abstract void shutdownHard (boolean killAdb)

พยายามบังคับปิดตัวกำหนดตารางเวลาคำสั่ง

คล้ายกับ shutdown() แต่จะเลือกปิดการเชื่อมต่อ adb ด้วยเพื่อพยายาม 'สร้างแรงบันดาลใจ' การร้องขอที่กำลังดำเนินอยู่ให้เสร็จเร็วขึ้น

พารามิเตอร์
killAdb boolean

ปิดฮาร์ด

public abstract void shutdownHard ()

พยายามบังคับปิดตัวกำหนดตารางเวลาคำสั่ง เช่นเดียวกับการปิดระบบฮาร์ด (จริง)

ปิดเมื่อว่างเปล่า

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 หากการดำเนินการไม่รองรับสิ่งนี้