RunUtil
public
class
RunUtil
extends Object
implements
IRunUtil
java.lang.Object | |
↳ | com.android.tradefed.util.RunUtil |
ชุดเมธอดตัวช่วยสําหรับดําเนินการ
สรุป
ช่อง | |
---|---|
public
static
final
String |
INHERITIO_PREFIX
|
public
static
final
String |
RUNNABLE_NOTIFIER_NAME
|
ตัวสร้างแบบสาธารณะ | |
---|---|
RunUtil()
สร้างออบเจ็กต์ |
|
RunUtil(boolean inheritEnvVars)
|
เมธอดสาธารณะ | |
---|---|
void
|
allowInterrupt(boolean allow)
อนุญาต/ไม่อนุญาตการขัดจังหวะการเรียกใช้ในเธรดปัจจุบัน |
ProcessBuilder
|
createProcessBuilder(Redirect redirect,
|
static
IRunUtil
|
getDefault()
รับการอ้างอิงไปยังออบเจ็กต์ |
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ |
void
|
interrupt(Thread thread, String message)
ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ |
boolean
|
isInterruptAllowed()
ระบุสถานะการขัดจังหวะของ RunUtil |
Process
|
runCmdInBackground(Redirect redirect,
วิธีการ |
Process
|
runCmdInBackground(
วิธีการ |
Process
|
runCmdInBackground(
เรียกใช้คําสั่งที่มี |
Process
|
runCmdInBackground(String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งระบบแบบไม่พร้อมกัน |
Process
|
runCmdInBackground(Redirect redirect, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งระบบแบบไม่พร้อมกัน |
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ |
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ |
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ |
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
บล็อกและดำเนินการ โดยจะยกเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ |
CommandResult
|
runTimedCmd(long timeout, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องเปลี่ยนเส้นทาง Stdin จากไฟล์ และยกเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบ ยกเลิกหากใช้เวลานานกว่าที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์หากระบุ |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ |
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ |
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
บล็อกและดำเนินการหลายครั้งจนกว่าจะสำเร็จ |
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
บล็อกและดำเนินการ โดยจะยกเลิกหากใช้เวลานานกว่าที่ระบุ |
void
|
setEnvVariable(String name, String value)
ตั้งค่าตัวแปรสภาพแวดล้อมที่จะใช้เมื่อเรียกใช้คำสั่งของระบบ |
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
เลือกว่าเมื่อสร้างกระบวนการ การยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมจะมีความสำคัญมากกว่าการตั้งค่าหรือไม่ |
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
ตั้งค่าเป็น "ขัดจังหวะได้" หลังจากรอระยะเวลาหนึ่ง |
void
|
setLinuxInterruptProcess(boolean interrupt)
อนุญาตให้ใช้การขัดจังหวะ "kill" ของ Linux ในกระบวนการที่ทำงานผ่านเมธอด #runTimed เมื่อถึงเวลาหมด |
void
|
setRedirectStderrToStdout(boolean redirect)
ตั้งค่าสตรีมข้อผิดพลาดมาตรฐานให้เปลี่ยนเส้นทางไปยังสตรีมเอาต์พุตมาตรฐานเมื่อเรียกใช้คำสั่งของระบบ |
void
|
setWorkingDir(File dir)
ตั้งค่าไดเรกทอรีการทำงานสำหรับคำสั่งของระบบ |
void
|
sleep(long time)
เมธอดตัวช่วยสำหรับหยุดทำงานเป็นระยะเวลาหนึ่งโดยไม่สนใจข้อยกเว้น |
void
|
unsetEnvVariable(String key)
ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมเพื่อให้ระบบทำงานโดยไม่มีตัวแปรสภาพแวดล้อมนี้
ตัวแปรสภาพแวดล้อมอาจรับค่าจากกระบวนการหลัก เราจึงต้องลบตัวแปรสภาพแวดล้อมออกจาก |
ช่อง
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
ตัวสร้างแบบสาธารณะ
RunUtil
public RunUtil (boolean inheritEnvVars)
พารามิเตอร์ | |
---|---|
inheritEnvVars |
boolean |
เมธอดสาธารณะ
allowInterrupt
public void allowInterrupt (boolean allow)
อนุญาต/ไม่อนุญาตการขัดจังหวะการเรียกใช้ในเธรดปัจจุบัน หากได้รับอนุญาต การดำเนินการของเทรดปัจจุบันจะหยุดชะงักจากเทรดอื่นๆ ผ่านเมธอด interrupt(Thread, String)
ได้
พารามิเตอร์ | |
---|---|
allow |
boolean : อนุญาตให้การเรียกใช้ขัดจังหวะในเธรดปัจจุบันหรือไม่ |
createProcessBuilder
public ProcessBuilder createProcessBuilder (Redirect redirect,commandList, boolean enableCache)
พารามิเตอร์ | |
---|---|
redirect |
Redirect |
commandList |
|
enableCache |
boolean |
คิกรีเทิร์น | |
---|---|
ProcessBuilder |
getDefault
public static IRunUtil getDefault ()
รับการอ้างอิงไปยังออบเจ็กต์ RunUtil
เริ่มต้น
ซึ่งมีประโยชน์สำหรับผู้โทรที่ต้องการใช้ IRunUtil โดยไม่ต้องปรับแต่ง
เราขอแนะนำให้ผู้เรียกใช้ที่ต้องการอินสแตนซ์ IRunUtil ที่กําหนดเอง (เช่น ต้องเรียก setEnvVariable(String, String)
หรือ setWorkingDir(File)
) สร้างสําเนาของตนเอง
คิกรีเทิร์น | |
---|---|
IRunUtil |
ขัดจังหวะ
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ การดำเนินการเรียกใช้บนเธรดหนึ่งๆ จะแสดง RunInterruptedException
พารามิเตอร์ | |
---|---|
message |
String : ข้อความสำหรับ RunInterruptedException |
errorId |
ErrorIdentifier : แสดงสาเหตุของการหยุดชะงัก (หากทราบ) |
ขัดจังหวะ
public void interrupt (Thread thread, String message)
ขัดจังหวะการดำเนินการที่ทำงานอยู่/กำลังจะเกิดขึ้นในเธรดหนึ่งๆ การดำเนินการเรียกใช้บนเธรดหนึ่งๆ จะแสดง RunInterruptedException
พารามิเตอร์ | |
---|---|
message |
String : ข้อความสำหรับ RunInterruptedException |
isInterruptAllowed
public boolean isInterruptAllowed ()
ระบุสถานะการขัดจังหวะของ RunUtil
คิกรีเทิร์น | |
---|---|
boolean |
จริงหากการเรียกใช้สามารถขัดจังหวะได้ หรือเป็นเท็จ |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,command)
วิธีการ runCmdInBackground(String)
สำรองที่ยอมรับอาร์กิวเมนต์คำสั่งในรูปแบบ ERROR(/List)
พารามิเตอร์ | |
---|---|
redirect |
Redirect : ERROR(/Redirect) ที่จะใช้กับ ProcessBuilder |
command |
: ERROR(/List) ที่มีคําสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) เพื่อเรียกใช้ |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคําสั่งที่ดําเนินการ |
runCmdInBackground
public Process runCmdInBackground (command)
วิธีการ runCmdInBackground(String)
สำรองที่ยอมรับอาร์กิวเมนต์คำสั่งในรูปแบบ ERROR(/List)
พารามิเตอร์ | |
---|---|
command |
: ERROR(/List) ที่มีคำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) เพื่อเรียกใช้ |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคําสั่งที่ดําเนินการ |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
เรียกใช้คําสั่งที่มี ERROR(/OutputStream)
จะบันทึกเอาต์พุตของคําสั่ง
Stdout และ stderr จะรวมเข้าด้วยกัน
พารามิเตอร์ | |
---|---|
command |
: คำสั่งที่จะเรียกใช้ |
output |
OutputStream : OutputStream เพื่อบันทึกเอาต์พุต |
คิกรีเทิร์น | |
---|---|
Process |
Process ที่เรียกใช้คําสั่ง |
runCmdInBackground
public Process runCmdInBackground (String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งระบบแบบไม่พร้อมกัน
จะแสดงผลทันทีหลังจากเปิดใช้คําสั่ง
พารามิเตอร์ | |
---|---|
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคําสั่งที่ดําเนินการ |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คำสั่งระบบแบบไม่พร้อมกัน
จะแสดงผลทันทีหลังจากเปิดใช้คําสั่ง
พารามิเตอร์ | |
---|---|
redirect |
Redirect : ERROR(/Redirect) ที่จะใช้กับ ProcessBuilder |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคําสั่งที่ดําเนินการ |
runEscalatingTimedRetry
public 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 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 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 CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
บล็อกและดำเนินการ โดยจะยกเลิกหากใช้เวลานานกว่าที่ระบุ
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาที |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult ที่จะดำเนินการ |
logErrors |
boolean : บันทึกข้อผิดพลาดเกี่ยวกับข้อยกเว้นหรือไม่ |
คิกรีเทิร์น | |
---|---|
CommandStatus |
ผลลัพธ์ CommandStatus ของการดำเนินการ |
runTimedCmd
public 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 CommandResult runTimedCmd (long timeout, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาที 0 หมายถึงไม่หมดเวลา |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง |
runTimedCmdRetry
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาทีสําหรับแต่ละครั้งที่พยายาม |
retryInterval |
long : ระยะเวลารอระหว่างการพยายามดำเนินการคำสั่งอีกครั้ง |
attempts |
int : จำนวนครั้งที่พยายามสูงสุด |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง |
runTimedCmdRetryWithOutputMonitor
public 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 CommandResult runTimedCmdSilently (long timeout, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ คล้ายกับ runTimedCmd(long, String)
แต่จะไม่บันทึกข้อผิดพลาดใดๆ เกี่ยวกับข้อยกเว้น
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาที |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง |
runTimedCmdSilentlyRetry
public 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 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 CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาที |
input |
String : อินพุต stdin ที่ส่งไปยังกระบวนการ |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งระบบที่ต้องใช้อินพุต stdin และยกเลิกหากใช้เวลานานกว่าที่ระบุ
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาที |
input |
String : อินพุต stdin ที่ส่งไปยังกระบวนการ |
command |
: ERROR(/List) ที่มีคําสั่งระบบและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง |
runTimedCmdWithInputRedirect
public 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 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 CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
เมธอดตัวช่วยสำหรับเรียกใช้คําสั่งของระบบและยกเลิกหากใช้เวลานานกว่าที่ระบุไว้ รวมถึงตรวจสอบสตรีมเอาต์พุตเพื่อหากิจกรรมด้วย โดยจะหยุดทำงานหากไม่พบกิจกรรมในสตรีมเป็นระยะเวลาหนึ่งๆ หากตั้งค่า idleOutputTimeout เป็น 0 ระบบจะไม่ตรวจสอบสตรีม
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาที 0 หมายถึงไม่หมดเวลา |
idleOutputTimeout |
long : เวลาสูงสุดที่รอเป็นมิลลิวินาทีสําหรับเอาต์พุตในสตรีมเอาต์พุต |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) สำหรับ exec |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คําสั่ง |
runTimedRetry
public 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 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 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 void setEnvVariable (String name, String value)
ตั้งค่าตัวแปรสภาพแวดล้อมที่จะใช้เมื่อเรียกใช้คำสั่งของระบบ
พารามิเตอร์ | |
---|---|
name |
String : ชื่อตัวแปร |
value |
String : ค่าตัวแปร |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
เลือกว่าเมื่อสร้างกระบวนการ การยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมจะมีความสำคัญมากกว่าการตั้งค่าหรือไม่
โดยค่าเริ่มต้น การยกเลิกการตั้งค่าจะมีลําดับความสําคัญสูงกว่า ซึ่งหมายความว่าหากมีการพยายามตั้งค่าตัวแปรที่มีชื่อเดียวกัน ระบบจะไม่ทําเช่นนั้นเนื่องจากจะยกเลิกการตั้งค่าตัวแปร
ใช้กับอินสแตนซ์ IRunUtil
เริ่มต้นไม่ได้
พารามิเตอร์ | |
---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread, long timeMs)
ตั้งค่าเป็น "ขัดจังหวะได้" หลังจากรอระยะเวลาหนึ่ง
ERROR(/CommandScheduler#shutdownHard())
เพื่อบังคับใช้การสิ้นสุดในท้ายที่สุด
พารามิเตอร์ | |
---|---|
thread |
Thread : ด้ายที่จะหยุดชั่วคราวได้ |
timeMs |
long : ระยะเวลารอก่อนที่จะตั้งค่าให้หยุดชั่วคราวได้ |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
อนุญาตให้ใช้การขัดจังหวะ "kill" ของ Linux ในกระบวนการที่ทำงานผ่านเมธอด #runTimed เมื่อถึงเวลาหมด
ใช้กับอินสแตนซ์ IRunUtil
เริ่มต้นไม่ได้
พารามิเตอร์ | |
---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
ตั้งค่าสตรีมข้อผิดพลาดมาตรฐานให้เปลี่ยนเส้นทางไปยังสตรีมเอาต์พุตมาตรฐานเมื่อเรียกใช้คำสั่งของระบบ ค่าเริ่มต้นคือ False
พารามิเตอร์ | |
---|---|
redirect |
boolean : ค่าใหม่สำหรับการเปลี่ยนเส้นทางหรือไม่ |
setWorkingDir
public void setWorkingDir (File dir)
ตั้งค่าไดเรกทอรีการทำงานสำหรับคำสั่งของระบบ
พารามิเตอร์ | |
---|---|
dir |
File : ไดเรกทอรีที่ทำงาน |
การนอนหลับ
public void sleep (long time)
เมธอดตัวช่วยสำหรับหยุดทำงานเป็นระยะเวลาหนึ่งโดยไม่สนใจข้อยกเว้น
พารามิเตอร์ | |
---|---|
time |
long : มิลลิวินาทีที่จะหยุดทำงาน ระบบจะไม่สนใจค่าที่น้อยกว่าหรือเท่ากับ 0 |
unsetEnvVariable
public void unsetEnvVariable (String key)
ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมเพื่อให้ระบบทำงานโดยไม่มีตัวแปรสภาพแวดล้อมนี้
ตัวแปรสภาพแวดล้อมอาจรับค่าจากกระบวนการหลัก เราจึงต้องลบตัวแปรสภาพแวดล้อมออกจาก ProcessBuilder.environment()
พารามิเตอร์ | |
---|---|
key |
String : ชื่อตัวแปร |
ดูเพิ่มเติม