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,
วิธีการ |
abstract
Process
|
runCmdInBackground(
วิธีการ |
abstract
Process
|
runCmdInBackground(
เรียกใช้คําสั่งที่มี |
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,
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต 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
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)
ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมเพื่อให้ระบบทำงานโดยไม่มีตัวแปรสภาพแวดล้อมนี้ |
เมธอดสาธารณะ
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) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน อาจเป็นค่าว่างได้ |
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) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน อาจเป็นค่าว่างได้ |
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) ซึ่งระบบจะเปลี่ยนเส้นทางเอาต์พุตมาตรฐาน อาจเป็นค่าว่างได้ |
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 ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง |
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: ชื่อตัวแปร |
ดูเพิ่มเติม