IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil

อินเทอร์เฟซสําหรับการดําเนินการแบบตั้งเวลาและคําสั่งของระบบ

สรุป

ชั้นเรียนที่ซ้อนกัน

interface IRunUtil.IRunnableResult

อินเทอร์เฟซสําหรับการดําเนินการแบบไม่พร้อมกันซึ่งแสดงผลสถานะบูลีน 

เมธอดสาธารณะ

abstract void allowInterrupt(boolean allow)

อนุญาต/ไม่อนุญาตการขัดจังหวะการเรียกใช้ในเธรดปัจจุบัน

abstract void interrupt(Thread thread, String message, ErrorIdentifier errorId)

ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ

abstract void interrupt(Thread thread, String message)

ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ

abstract boolean isInterruptAllowed()

ระบุสถานะการขัดจังหวะของ RunUtil

abstract Process runCmdInBackground(Redirect redirect, command)

วิธีการ runCmdInBackground(String) สำรองที่ยอมรับอาร์กิวเมนต์คำสั่งในรูปแบบ ERROR(/List)

abstract Process runCmdInBackground( command)

วิธีการ runCmdInBackground(String) สำรองที่ยอมรับอาร์กิวเมนต์คำสั่งในรูปแบบ ERROR(/List)

abstract Process runCmdInBackground( command, OutputStream output)

เรียกใช้คําสั่งที่มี ERROR(/OutputStream) จะบันทึกเอาต์พุตของคําสั่ง

abstract Process runCmdInBackground(String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งของระบบแบบไม่พร้อมกัน

abstract Process runCmdInBackground(Redirect redirect, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งระบบแบบไม่พร้อมกัน

abstract boolean runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

abstract boolean runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

abstract boolean runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

abstract CommandStatus runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)

บล็อกและดำเนินการ โดยจะยกเลิกหากใช้เวลานานกว่าที่ระบุ

abstract CommandResult runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ

abstract CommandResult runTimedCmd(long timeout, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

abstract CommandResult runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

abstract CommandResult runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

abstract CommandResult runTimedCmdSilently(long timeout, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

abstract CommandResult runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

abstract CommandResult runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ

abstract CommandResult runTimedCmdWithInput(long timeout, String input, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ

abstract CommandResult runTimedCmdWithInput(long timeout, String input, command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ

abstract CommandResult runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องเปลี่ยนเส้นทาง Stdin จากไฟล์ และยกเลิกหากใช้เวลานานกว่าที่ระบุ

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบที่มีการแคช

abstract boolean runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

abstract boolean runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

abstract CommandStatus runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)

บล็อกและดำเนินการ โดยจะยกเลิกหากใช้เวลานานกว่าที่ระบุ

abstract void setEnvVariable(String key, String value)

ตั้งค่าตัวแปรสภาพแวดล้อมที่จะใช้เมื่อเรียกใช้คำสั่งของระบบ

abstract void setEnvVariablePriority(IRunUtil.EnvPriority priority)

เลือกว่าเมื่อสร้างกระบวนการ การยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมจะมีความสำคัญมากกว่าการตั้งค่าหรือไม่

abstract void setInterruptibleInFuture(Thread thread, long timeMs)

ตั้งค่าเป็น "ขัดจังหวะได้" หลังจากรอระยะเวลาหนึ่ง

abstract void setLinuxInterruptProcess(boolean interrupt)

อนุญาตให้ใช้การขัดจังหวะ "kill" ของ Linux ในกระบวนการที่ทำงานผ่านเมธอด #runTimed เมื่อถึงเวลาหมด

abstract void setRedirectStderrToStdout(boolean redirect)

ตั้งค่าสตรีมข้อผิดพลาดมาตรฐานให้เปลี่ยนเส้นทางไปยังสตรีมเอาต์พุตมาตรฐานเมื่อเรียกใช้คำสั่งของระบบ

abstract void setWorkingDir(File dir)

ตั้งค่าไดเรกทอรีการทำงานสำหรับคำสั่งของระบบ

abstract void sleep(long time)

เมธอดตัวช่วยสำหรับหยุดทำงานเป็นระยะเวลาหนึ่งโดยไม่สนใจข้อยกเว้น

abstract void unsetEnvVariable(String key)

ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมเพื่อให้ระบบทำงานโดยไม่ใช้ตัวแปรสภาพแวดล้อมนี้

abstract void uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult)

อัปโหลด ExecutableActionResult รายการล่าสุดที่เรียกใช้ด้วย cacheClient

เมธอดสาธารณะ

allowInterrupt

public abstract void allowInterrupt (boolean allow)

อนุญาต/ไม่อนุญาตการขัดจังหวะการเรียกใช้ในเธรดปัจจุบัน หากได้รับอนุญาต การดำเนินการของเทรดปัจจุบันจะหยุดชะงักจากเทรดอื่นๆ ผ่านเมธอด interrupt(Thread, String) ได้

พารามิเตอร์
allow boolean: อนุญาตให้การเรียกใช้ขัดจังหวะในเธรดปัจจุบันหรือไม่

ขัดจังหวะ

public abstract void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ การดำเนินการเรียกใช้บนเธรดหนึ่งๆ จะแสดง RunInterruptedException

พารามิเตอร์
message String: ข้อความสำหรับ RunInterruptedException
errorId ErrorIdentifier: แสดงสาเหตุของการหยุดชะงัก (หากทราบ)

ขัดจังหวะ

public abstract void interrupt (Thread thread, 
                String message)

ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ การดำเนินการเรียกใช้บนเธรดหนึ่งๆ จะแสดง RunInterruptedException

พารามิเตอร์
message String: ข้อความสำหรับ RunInterruptedException

isInterruptAllowed

public abstract boolean isInterruptAllowed ()

ระบุสถานะการขัดจังหวะของ RunUtil

คิกรีเทิร์น
boolean จริงหากการเรียกใช้สามารถขัดจังหวะได้ หรือเป็นเท็จ

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                 command)

วิธีการ runCmdInBackground(String) สำรองที่ยอมรับอาร์กิวเมนต์คำสั่งในรูปแบบ ERROR(/List)

พารามิเตอร์
redirect Redirect: ERROR(/Redirect) ที่จะใช้กับ ProcessBuilder
command : ERROR(/List) ที่มีคําสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) เพื่อเรียกใช้
คิกรีเทิร์น
Process Process ของคําสั่งที่ดําเนินการ
โยน
if command failed to run

runCmdInBackground

public abstract Process runCmdInBackground ( command)

วิธีการ runCmdInBackground(String) สำรองที่ยอมรับอาร์กิวเมนต์คำสั่งในรูปแบบ ERROR(/List)

พารามิเตอร์
command : ERROR(/List) ที่มีคําสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) เพื่อเรียกใช้
คิกรีเทิร์น
Process Process ของคําสั่งที่ดําเนินการ
โยน
if command failed to run

runCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

เรียกใช้คําสั่งที่มี ERROR(/OutputStream) จะบันทึกเอาต์พุตของคําสั่ง Stdout และ stderr จะรวมเข้าด้วยกัน

พารามิเตอร์
command : คำสั่งที่จะเรียกใช้
output OutputStream: OutputStream เพื่อบันทึกเอาต์พุต
คิกรีเทิร์น
Process Process ที่เรียกใช้คําสั่ง
โยน
IOException

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งของระบบแบบไม่พร้อมกัน

จะแสดงผลทันทีหลังจากเปิดใช้คําสั่ง

พารามิเตอร์
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
Process Process ของคําสั่งที่ดําเนินการ
โยน
if command failed to run

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งของระบบแบบไม่พร้อมกัน

จะแสดงผลทันทีหลังจากเปิดใช้คําสั่ง

พารามิเตอร์
redirect Redirect: ERROR(/Redirect) ที่จะใช้กับ ProcessBuilder
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
Process Process ของคําสั่งที่ดําเนินการ
โยน
if command failed to run

runEscalatingTimedRetry

public abstract boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

เพิ่มเวลารอระหว่างการพยายามดำเนินการแบบทวีคูณ ซึ่งจะใช้เมื่อดำเนินการต่างๆ เช่น โพลเซิร์ฟเวอร์ เพื่อให้เซิร์ฟเวอร์มีเวลากู้คืนในกรณีที่หยุดทำงานชั่วคราว

พารามิเตอร์
opTimeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับการพยายามดําเนินการครั้งเดียว
initialPollInterval long: เวลาที่รอระหว่างการพยายามดำเนินการครั้งแรก
maxPollInterval long: เวลาสูงสุดในการรอระหว่างการพยายามดำเนินการ
maxTime long: เวลาสูงสุดโดยประมาณทั้งหมดที่จะพยายามดำเนินการต่อ
runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult ที่จะดำเนินการ
คิกรีเทิร์น
boolean true หากการดำเนินการเสร็จสมบูรณ์ก่อนที่ maxTime จะหมดอายุ

runFixedTimedRetry

public abstract boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

พารามิเตอร์
opTimeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับการพยายามดําเนินการครั้งเดียว
pollInterval long: เวลาที่รอระหว่างการพยายามดำเนินการครั้งแรก
maxTime long: เวลาสูงสุดโดยประมาณทั้งหมดในการพยายามดำเนินการต่อ
runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult ที่จะดำเนินการ
คิกรีเทิร์น
boolean true หากการดำเนินการเสร็จสมบูรณ์ก่อนที่ maxTime จะหมดอายุ

runFixedTimedRetryWithOutputMonitor

public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ รวมถึงตรวจสอบกิจกรรมในสตรีมเอาต์พุตด้วย โดยจะหยุดทำงานหากไม่พบกิจกรรมในสตรีมเป็นระยะเวลาหนึ่งๆ หากตั้งค่า idleOutputTimeout เป็น 0 ระบบจะไม่ตรวจสอบสตรีม

พารามิเตอร์
opTimeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับการพยายามดําเนินการครั้งเดียว
idleOutputTimeout long: เวลาสูงสุดที่รอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต
pollInterval long: เวลาที่รอระหว่างการพยายามดำเนินการครั้งแรก
maxTime long: เวลาสูงสุดโดยประมาณทั้งหมดในการพยายามดำเนินการต่อ
runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult ที่จะดำเนินการ
คิกรีเทิร์น
boolean true หากการดำเนินการเสร็จสมบูรณ์ก่อนที่ maxTime จะหมดอายุ

runTimed

public abstract CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

บล็อกและดำเนินการ โดยจะยกเลิกหากใช้เวลานานกว่าที่ระบุ

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที
runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult ที่จะดำเนินการ
logErrors boolean: บันทึกข้อผิดพลาดเกี่ยวกับข้อยกเว้นหรือไม่
คิกรีเทิร์น
CommandStatus ผลลัพธ์ CommandStatus ของการดำเนินการ

runTimedCmd

public abstract CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ เมื่อระบุ ERROR(/OutputStream) ด้วยวิธีนี้ ระบบจะเปิด ERROR(/OutputStream) ไว้ที่ส่วนท้ายของฟังก์ชัน

พารามิเตอร์
timeout long: ระยะเวลาสูงสุดที่รอเมื่อหมดเวลา (เป็นมิลลิวินาที) 0 หมายถึงไม่หมดเวลา
stdout OutputStream: ERROR(/OutputStream) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุต std อาจเป็นค่าว่างได้
stderr OutputStream: ERROR(/OutputStream) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุตข้อผิดพลาด อาจเป็นค่าว่างได้
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmd

public abstract CommandResult runTimedCmd (long timeout, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที 0 หมายถึงไม่หมดเวลา
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdRetry

public abstract CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับแต่ละครั้งที่พยายาม
retryInterval long: เวลาที่รอระหว่างการพยายามดำเนินการคำสั่งอีกครั้ง
attempts int: จำนวนครั้งที่พยายามสูงสุด
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdRetryWithOutputMonitor

public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                long retryInterval, 
                int attempts, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ รวมถึงตรวจสอบสตรีมเอาต์พุตเพื่อหากิจกรรมด้วย โดยจะหยุดทำงานหากไม่พบกิจกรรมในสตรีมเป็นระยะเวลาหนึ่งๆ หากตั้งค่า idleOutputTimeout เป็น 0 ระบบจะไม่ตรวจสอบสตรีม

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับแต่ละครั้งที่พยายาม
idleOutputTimeout long: เวลาสูงสุดที่รอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต
retryInterval long: เวลาที่รอระหว่างการพยายามดำเนินการคำสั่งอีกครั้ง
attempts int: จำนวนครั้งที่พยายามสูงสุด
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdSilently

public abstract CommandResult runTimedCmdSilently (long timeout, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ คล้ายกับ runTimedCmd(long, String) แต่จะไม่บันทึกข้อผิดพลาดใดๆ เกี่ยวกับข้อยกเว้น

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdSilentlyRetry

public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ คล้ายกับ runTimedCmdRetry(long, long, int, String[]) แต่จะไม่บันทึกข้อผิดพลาดใดๆ เกี่ยวกับข้อยกเว้น

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที
retryInterval long: ระยะเวลารอระหว่างการพยายามดำเนินการคำสั่งอีกครั้ง
attempts int: จำนวนครั้งที่พยายามสูงสุด
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ

พารามิเตอร์
timeout long: ระยะเวลาสูงสุดที่รอเมื่อหมดเวลา (เป็นมิลลิวินาที) 0 หมายถึงไม่หมดเวลา
input String: อินพุต stdin เพื่อส่งไปยังกระบวนการ
stdoutFile File: ERROR(/File) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุต std อาจเป็นค่าว่างได้
stderrFile File: ERROR(/File) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุตข้อผิดพลาด อาจเป็นค่าว่างได้
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที
input String: อินพุต stdin เพื่อส่งไปยังกระบวนการ
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที
input String: อินพุต stdin เพื่อส่งไปยังกระบวนการ
command : ERROR(/List) ที่มีคําสั่งระบบและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdWithInputRedirect

public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องเปลี่ยนเส้นทาง Stdin จากไฟล์ และยกเลิกหากใช้เวลานานกว่าที่ระบุ

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที
inputRedirect File: ERROR(/File) เพื่อเปลี่ยนเส้นทางเป็นอินพุตมาตรฐานโดยใช้ ProcessBuilder.redirectInput() หากเป็นค่าว่าง ระบบจะไม่เปลี่ยนเส้นทาง stdin
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ เมื่อระบุ ERROR(/OutputStream) ด้วยวิธีนี้ ระบบจะเปิด ERROR(/OutputStream) ไว้ที่ส่วนท้ายของฟังก์ชัน

พารามิเตอร์
timeout long: ระยะเวลาสูงสุดที่รอเมื่อหมดเวลา (เป็นมิลลิวินาที) 0 หมายถึงไม่หมดเวลา
idleOutputTimeout long: เวลาสูงสุดที่รอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต
stdout OutputStream: ERROR(/OutputStream) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุต std อาจเป็นค่าว่างได้
stderr OutputStream: ERROR(/OutputStream) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุตข้อผิดพลาด อาจเป็นค่าว่างได้
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ รวมถึงตรวจสอบสตรีมเอาต์พุตเพื่อหากิจกรรมด้วย โดยจะหยุดทำงานหากไม่พบกิจกรรมในสตรีมเป็นระยะเวลาหนึ่งๆ หากตั้งค่า idleOutputTimeout เป็น 0 ระบบจะไม่ตรวจสอบสตรีม

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที 0 หมายถึงไม่หมดเวลา
idleOutputTimeout long: เวลาสูงสุดที่รอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                ICacheClient cacheClient, 
                String... command)

เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบที่มีการแคช

หากระบุ cacheClient ระบบจะเปิดใช้การแคช หากแคชพร้อมใช้งาน ระบบจะแสดงผลลัพธ์ที่แคชไว้ มิเช่นนั้น ระบบจะใช้ runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String) เพื่อเรียกใช้คําสั่งและอัปโหลดผลลัพธ์เพื่อแคช

พารามิเตอร์
timeout long: ระยะเวลาสูงสุดที่รอเมื่อหมดเวลา (เป็นมิลลิวินาที) 0 หมายถึงไม่หมดเวลา
idleOutputTimeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต
stdout OutputStream: ERROR(/OutputStream) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุต std อาจเป็นค่าว่างได้
stderr OutputStream: ERROR(/OutputStream) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุตข้อผิดพลาด อาจเป็นค่าว่างได้
cacheClient ICacheClient: อินสแตนซ์ของ ICacheClient ที่ใช้จัดการการแคช
command String: คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec
คิกรีเทิร์น
CommandResult CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง

runTimedRetry

public abstract boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ

พารามิเตอร์
opTimeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับการพยายามดําเนินการ 1 ครั้ง
pollInterval long: เวลาที่รอระหว่างการพยายามดำเนินการคำสั่งอีกครั้ง
attempts int: จำนวนครั้งที่พยายามสูงสุด
runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult ที่จะดำเนินการ
คิกรีเทิร์น
boolean true หากการดำเนินการเสร็จสมบูรณ์ก่อนที่จะถึงจำนวนครั้งที่พยายาม

runTimedRetryWithOutputMonitor

public abstract boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ รวมถึงตรวจสอบกิจกรรมในสตรีมเอาต์พุตด้วย โดยจะหยุดทำงานหากไม่พบกิจกรรมในสตรีมเป็นระยะเวลาหนึ่งๆ หากตั้งค่า idleOutputTimeout เป็น 0 ระบบจะไม่ตรวจสอบสตรีม

พารามิเตอร์
opTimeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับการพยายามดําเนินการ 1 ครั้ง
idleOutputTimeout long: เวลาสูงสุดที่รอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต
pollInterval long: เวลาที่รอระหว่างการพยายามดำเนินการคำสั่งอีกครั้ง
attempts int: จำนวนครั้งที่พยายามสูงสุด
runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult ที่จะดำเนินการ
คิกรีเทิร์น
boolean true หากการดำเนินการเสร็จสมบูรณ์ก่อนที่จะถึงจำนวนครั้งที่พยายาม

runTimedWithOutputMonitor

public abstract CommandStatus runTimedWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

บล็อกและดำเนินการ โดยจะยกเลิกหากใช้เวลานานกว่าที่ระบุ รวมถึงตรวจสอบกิจกรรมในสตรีมเอาต์พุตด้วย โดยจะหยุดทำงานหากไม่พบกิจกรรมในสตรีมเป็นระยะเวลาหนึ่งตามที่ระบุ หากตั้งค่า idleOutputTimeout เป็น 0 ระบบจะไม่ตรวจสอบสตรีม

พารามิเตอร์
timeout long: เวลาสูงสุดในการรอเป็นมิลลิวินาที
idleOutputTimeout long: เวลาสูงสุดที่รอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต
runnable IRunUtil.IRunnableResult: IRunUtil.IRunnableResult ที่จะดำเนินการ
logErrors boolean: บันทึกข้อผิดพลาดเกี่ยวกับข้อยกเว้นหรือไม่
คิกรีเทิร์น
CommandStatus ผลลัพธ์ CommandStatus ของการดำเนินการ

setEnvVariable

public abstract void setEnvVariable (String key, 
                String value)

ตั้งค่าตัวแปรสภาพแวดล้อมที่จะใช้เมื่อเรียกใช้คำสั่งของระบบ

พารามิเตอร์
key String: ชื่อตัวแปร
value String: ค่าตัวแปร

ดูเพิ่มเติม

setEnvVariablePriority

public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)

เลือกว่าเมื่อสร้างกระบวนการ การยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมจะมีความสำคัญมากกว่าการตั้งค่าหรือไม่ โดยค่าเริ่มต้น การยกเลิกการตั้งค่าจะมีลําดับความสําคัญสูงกว่า ซึ่งหมายความว่าหากมีการพยายามตั้งค่าตัวแปรที่มีชื่อเดียวกัน ระบบจะไม่ทําเช่นนั้นเนื่องจากจะยกเลิกการตั้งค่าตัวแปร ใช้กับอินสแตนซ์ IRunUtil เริ่มต้นไม่ได้

พารามิเตอร์
priority IRunUtil.EnvPriority

setInterruptibleInFuture

public abstract void setInterruptibleInFuture (Thread thread, 
                long timeMs)

ตั้งค่าเป็น "ขัดจังหวะได้" หลังจากรอระยะเวลาหนึ่ง ERROR(/CommandScheduler#shutdownHard()) เพื่อบังคับใช้การสิ้นสุดในท้ายที่สุด

พารามิเตอร์
thread Thread: ด้ายที่จะหยุดชั่วคราวได้
timeMs long: ระยะเวลารอก่อนที่จะตั้งค่าให้หยุดชั่วคราวได้

setLinuxInterruptProcess

public abstract void setLinuxInterruptProcess (boolean interrupt)

อนุญาตให้ใช้การขัดจังหวะ "kill" ของ Linux ในกระบวนการที่ทำงานผ่านเมธอด #runTimed เมื่อถึงเวลาหมด ใช้กับอินสแตนซ์ IRunUtil เริ่มต้นไม่ได้

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

setRedirectStderrToStdout

public abstract void setRedirectStderrToStdout (boolean redirect)

ตั้งค่าสตรีมข้อผิดพลาดมาตรฐานให้เปลี่ยนเส้นทางไปยังสตรีมเอาต์พุตมาตรฐานเมื่อเรียกใช้คำสั่งของระบบ ค่าเริ่มต้นคือ False

พารามิเตอร์
redirect boolean: ค่าใหม่สำหรับการเปลี่ยนเส้นทางหรือไม่

ดูเพิ่มเติม

setWorkingDir

public abstract void setWorkingDir (File dir)

ตั้งค่าไดเรกทอรีการทำงานสำหรับคำสั่งของระบบ

พารามิเตอร์
dir File: ไดเรกทอรีที่ทำงาน

ดูเพิ่มเติม

การนอนหลับ

public abstract void sleep (long time)

เมธอดตัวช่วยสำหรับหยุดทำงานเป็นระยะเวลาหนึ่งโดยไม่สนใจข้อยกเว้น

พารามิเตอร์
time long: มิลลิวินาทีที่จะหยุดทำงาน ระบบจะไม่สนใจค่าที่น้อยกว่าหรือเท่ากับ 0

unsetEnvVariable

public abstract void unsetEnvVariable (String key)

ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมเพื่อให้ระบบทำงานโดยไม่ใช้ตัวแปรสภาพแวดล้อมนี้

พารามิเตอร์
key String: ชื่อตัวแปร

ดูเพิ่มเติม

uploadCache

public abstract void uploadCache (ICacheClient cacheClient, 
                ExecutableActionResult actionResult)

อัปโหลด ExecutableActionResult รายการล่าสุดที่เรียกใช้ด้วย cacheClient

พารามิเตอร์
cacheClient ICacheClient: ICacheClient ที่ใช้อัปโหลดผล
actionResult ExecutableActionResult: ExecutableActionResult ที่จะอัปโหลด