เรียกใช้ยูทิลิตี
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)
อนุญาต/ไม่อนุญาตการเรียกใช้การรบกวนในชุดข้อความปัจจุบัน |
static
IRunUtil
|
getDefault()
ดูการอ้างอิงออบเจ็กต์ |
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
ขัดจังหวะการดำเนินการที่ดำเนินอยู่/ที่กำลังจะถึงในชุดข้อความที่ระบุ |
void
|
interrupt(Thread thread, String message)
ขัดจังหวะการดำเนินการที่ดำเนินอยู่/ที่กำลังจะถึงในชุดข้อความที่ระบุ |
boolean
|
isInterruptAllowed()
กำหนดสถานะการรบกวนของ RunUtil |
static
void
|
linkFile(File destRoot, String relToRoot, File target)
เชื่อมโยง |
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)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ ล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์ หากระบุไว้ |
CommandResult
|
runTimedCmd(long timeout, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ ล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์ หากระบุไว้ |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
เมธอด Helper เพื่อเรียกใช้คำสั่งระบบที่ต้องใช้อินพุต stdin และล้มเลิกหาก ใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
เมธอด Helper เพื่อเรียกใช้คำสั่งระบบที่ต้องใช้อินพุต stdin และล้มเลิกหาก ใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
เมธอด Helper เพื่อเรียกใช้คำสั่งของระบบที่ต้องเปลี่ยนเส้นทาง Stdin จากไฟล์ และ ล้มเลิกหากใช้เวลานานกว่าที่ระบุไว้ |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ ล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์ หากระบุไว้ |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
เมธอด Helper สำหรับเรียกใช้คำสั่งระบบกับการแคช |
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)
อนุญาตให้ใช้ Linux "kill" การหยุดชะงักของกระบวนการที่ทำงานผ่านเมธอด #runTimed เมื่อ ถึงระยะหมดเวลา |
void
|
setRedirectStderrToStdout(boolean redirect)
ตั้งค่าสตรีมข้อผิดพลาดมาตรฐานให้เปลี่ยนเส้นทางไปยังสตรีมเอาต์พุตมาตรฐานเมื่อเรียกใช้ระบบ คำสั่ง |
void
|
setWorkingDir(File dir)
ตั้งค่าไดเรกทอรีการทำงานสำหรับคำสั่งของระบบ |
void
|
sleep(long time)
วิธีการของ Helper ให้นอนหลับตามเวลาที่กำหนดโดยไม่สนใจข้อยกเว้นใดๆ |
static
String
|
toRelative(File start, String target)
|
void
|
unsetEnvVariable(String key)
ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อม คำสั่งของระบบจึงจะทำงานโดยไม่มีตัวแปรสภาพแวดล้อมนี้
ตัวแปรสภาพแวดล้อมอาจรับค่าจากกระบวนการระดับบนสุด เราจึงต้องลบ
ตัวแปรสภาพแวดล้อมจาก |
ช่อง
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
ช่างก่อสร้างสาธารณะ
เรียกใช้ยูทิลิตี
public RunUtil (boolean inheritEnvVars)
พารามิเตอร์ | |
---|---|
inheritEnvVars |
boolean |
วิธีการสาธารณะ
อนุญาตการพัก
public void allowInterrupt (boolean allow)
อนุญาต/ไม่อนุญาตการเรียกใช้การรบกวนในชุดข้อความปัจจุบัน หากได้รับอนุญาต ให้เรียกใช้การดำเนินการ
ชุดข้อความปัจจุบันอาจถูกขัดจังหวะจากชุดข้อความอื่นผ่านเมธอด interrupt(Thread, String)
พารามิเตอร์ | |
---|---|
allow |
boolean : จะอนุญาตให้เรียกใช้การรบกวนในชุดข้อความปัจจุบันหรือไม่ |
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 |
ไม่ได้รับอนุญาต
public boolean isInterruptAllowed ()
กำหนดสถานะการรบกวนของ RunUtil
คิกรีเทิร์น | |
---|---|
boolean |
true หากการเรียกใช้สามารถหยุดชะงัก หรือ false หากไม่เช่นนั้น |
linkFile
public static void linkFile (File destRoot, String relToRoot, File target)
เชื่อมโยง target
ไปยังสถานที่ภายใต้ destRoot
ถ้าไฟล์เป้าหมายหรือลิงก์สัญลักษณ์มีอยู่แล้วใน destRoot
ไฟล์นั้น
จะไม่มีการเชื่อมโยง
พารามิเตอร์ | |
---|---|
destRoot |
File : รูทของปลายทาง |
relToRoot |
String : เส้นทางแบบสัมพัทธ์จากไดเรกทอรีปลายทางไปยังรูท |
target |
File : ไฟล์เป้าหมายที่จะลิงก์ |
การขว้าง | |
---|---|
|
หากไม่สามารถลิงก์ไฟล์เป้าหมายได้ |
เรียกใช้CmdInพื้นหลัง
public Process runCmdInBackground (Redirect redirect,command)
เมธอด runCmdInBackground(String)
สำรองที่ยอมรับอาร์กิวเมนต์คำสั่ง
ในแบบฟอร์ม ERROR(/List)
พารามิเตอร์ | |
---|---|
redirect |
Redirect : ERROR(/Redirect) ที่นำไปใช้กับ ProcessBuilder |
command |
: ERROR(/List) ที่มีคำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับ
เป็นผู้บริหาร |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคำสั่งที่ดำเนินการแล้ว |
เรียกใช้CmdInพื้นหลัง
public Process runCmdInBackground (command)
เมธอด runCmdInBackground(String)
สำรองที่ยอมรับอาร์กิวเมนต์คำสั่ง
ในแบบฟอร์ม ERROR(/List)
พารามิเตอร์ | |
---|---|
command |
: ERROR(/List) ที่มีคำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับ
เป็นผู้บริหาร |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคำสั่งที่ดำเนินการแล้ว |
เรียกใช้CmdInพื้นหลัง
public Process runCmdInBackground (command, OutputStream output)
การเรียกใช้คำสั่งด้วย ERROR(/OutputStream)
จะบันทึกเอาต์พุตของคำสั่ง
Stdout และ Stderr รวมกัน
พารามิเตอร์ | |
---|---|
command |
: คำสั่งที่จะเรียกใช้ |
output |
OutputStream : OutputStream เพื่อบันทึกเอาต์พุต |
คิกรีเทิร์น | |
---|---|
Process |
Process ที่เรียกใช้คำสั่ง |
เรียกใช้CmdInพื้นหลัง
public Process runCmdInBackground (String... command)
เมธอดตัวช่วยในการเรียกใช้คำสั่งระบบแบบไม่พร้อมกัน
จะแสดงผลทันทีหลังจากเปิดคำสั่ง
พารามิเตอร์ | |
---|---|
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคำสั่งที่ดำเนินการแล้ว |
เรียกใช้CmdInพื้นหลัง
public Process runCmdInBackground (Redirect redirect, String... command)
เมธอดตัวช่วยในการเรียกใช้คำสั่งระบบแบบไม่พร้อมกัน
จะแสดงผลทันทีหลังจากเปิดคำสั่ง
พารามิเตอร์ | |
---|---|
redirect |
Redirect : ERROR(/Redirect) ที่นำไปใช้กับ ProcessBuilder |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
Process |
Process ของคำสั่งที่ดำเนินการแล้ว |
ดำเนินการส่งต่อเวลาลองอีกครั้ง
public boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
บล็อกและเรียกใช้การดำเนินการหลายครั้งจนกว่าจะสำเร็จ
เพิ่มเวลารอแบบทวีคูณระหว่างการดำเนินการแต่ละครั้ง เป้าหมายนี้มีไว้เพื่อใช้ เมื่อดำเนินการบางอย่าง เช่น การสำรวจเซิร์ฟเวอร์ เพื่อให้เวลาในการกู้คืนในกรณี ขัดข้องชั่วคราว
พารามิเตอร์ | |
---|---|
opTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับความพยายามในการดำเนินการ 1 ครั้ง |
initialPollInterval |
long : เวลาเริ่มต้นที่จะรอระหว่างการพยายามดำเนินการ |
maxPollInterval |
long : เวลาสูงสุดที่จะรอระหว่างการพยายามดำเนินการ |
maxTime |
long : เวลารวมสูงสุดโดยประมาณในการลองดำเนินการต่อไป |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult เพื่อเรียกใช้ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากดำเนินการสำเร็จก่อนที่ maxTime จะหมดอายุ |
ดำเนินการแก้ไขเวลาลองใหม่
public boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
บล็อกและเรียกใช้การดำเนินการหลายครั้งจนกว่าจะสำเร็จ
พารามิเตอร์ | |
---|---|
opTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับความพยายามในการดำเนินการ 1 ครั้ง |
pollInterval |
long : เวลาเริ่มต้นที่จะรอระหว่างการพยายามดำเนินการ |
maxTime |
long : เวลารวมสูงสุดโดยประมาณในการลองดำเนินการต่อไป |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult เพื่อเรียกใช้ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากดำเนินการสำเร็จก่อนที่ maxTime จะหมดอายุ |
เรียกใช้FixedTimedRetryWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
บล็อกและเรียกใช้การดำเนินการหลายครั้งจนกว่าจะสำเร็จ รวมถึงติดตามดู สตรีมเอาต์พุตสำหรับกิจกรรม ระบบจะล้มเลิกหากไม่มีกิจกรรมการสตรีมในเวลาที่ระบุ หากตั้งค่า iframeOutputTimeout เป็น 0 จะไม่มีการตรวจสอบสตรีม
พารามิเตอร์ | |
---|---|
opTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับความพยายามในการดำเนินการ 1 ครั้ง |
idleOutputTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับเอาต์พุตไปยังสตรีมเอาต์พุต |
pollInterval |
long : เวลาเริ่มต้นที่จะรอระหว่างการพยายามดำเนินการ |
maxTime |
long : เวลารวมสูงสุดโดยประมาณในการลองดำเนินการต่อไป |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult เพื่อเรียกใช้ |
คิกรีเทิร์น | |
---|---|
boolean |
true หากดำเนินการสำเร็จก่อนที่ maxTime จะหมดอายุ |
จับเวลา
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
บล็อกและดำเนินการอย่างใดอย่างหนึ่ง รวมถึงล้มเลิกหากใช้เวลานานกว่าที่ระบุไว้
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult เพื่อเรียกใช้ |
logErrors |
boolean : บันทึกข้อผิดพลาดเกี่ยวกับข้อยกเว้นหรือไม่ |
คิกรีเทิร์น | |
---|---|
CommandStatus |
ผลการดำเนินงาน CommandStatus |
เวลาที่เรียกใช้ Cmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ ล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ
และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์ หากระบุไว้ เมื่อมีการให้ ERROR(/OutputStream)
ด้วยวิธีนี้
ก็จะเปิดค้างไว้ในช่วงท้ายของฟังก์ชัน
พารามิเตอร์ | |
---|---|
timeout |
long : ระยะหมดเวลาสูงสุดที่จะรอ หน่วยเป็นมิลลิวินาที 0 หมายความว่าไม่มีการหมดเวลา |
stdout |
OutputStream : ERROR(/OutputStream) ที่จะมีการเปลี่ยนเส้นทางเอาต์พุต Std อาจเป็นค่าว่างได้ |
stderr |
OutputStream : ERROR(/OutputStream) ที่จะเปลี่ยนเส้นทางเอาต์พุตที่เป็นข้อผิดพลาด อาจเป็นค่าว่างได้ |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
เวลาที่เรียกใช้ Cmd
public CommandResult runTimedCmd (long timeout, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที 0 หมายความว่าไม่มีการหมดเวลา |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
เรียกใช้TimedCmdลองใหม่
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาทีสำหรับความพยายามในการรอแต่ละครั้ง |
retryInterval |
long : เวลาที่ต้องรอระหว่างลองส่งคำสั่งอีกครั้ง |
attempts |
int : จำนวนครั้งสูงสุดในการลองตอบ |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
เรียกใช้TimedCmdลองใหม่ด้วยเอาต์พุตการตรวจสอบ
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ ตรวจสอบสตรีมเอาต์พุตสำหรับกิจกรรมด้วย และล้มเลิกหากไม่มีกิจกรรมการสตรีม สังเกตการณ์ในเวลาที่ระบุ หากตั้งค่า iframeOutputระยะหมดเวลา เป็น 0 จะไม่มีการตรวจสอบสตรีม จะปรากฏขึ้น
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอเป็นมิลลิวินาทีสำหรับความพยายามในการรอแต่ละครั้ง |
idleOutputTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับเอาต์พุตไปยังสตรีมเอาต์พุต |
retryInterval |
long : เวลาที่ต้องรอระหว่างลองส่งคำสั่งอีกครั้ง |
attempts |
int : จำนวนครั้งสูงสุดในการลองตอบ |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
ทำงานตามลำดับเวลาCmdSไม่ต้อง
public CommandResult runTimedCmdSilently (long timeout, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ
คล้ายกับ runTimedCmd(long, String)
แต่ไม่ได้บันทึกข้อผิดพลาดใดๆ ใน
ข้อยกเว้น
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
จับเวลาCmdSilely โปรดลองอีกครั้ง
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ
คล้ายกับ runTimedCmdRetry(long, long, int, String[])
แต่ไม่บันทึกข้อผิดพลาดใดๆ เกี่ยวกับข้อยกเว้น
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที |
retryInterval |
long : เวลาที่ต้องรอระหว่างลองส่งคำสั่งอีกครั้ง |
attempts |
int : จำนวนครั้งสูงสุดในการลองตอบ |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
การเรียกใช้เวลา CmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ ล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์ หากระบุไว้
พารามิเตอร์ | |
---|---|
timeout |
long : ระยะหมดเวลาสูงสุดที่จะรอ หน่วยเป็นมิลลิวินาที 0 หมายความว่าไม่มีการหมดเวลา |
input |
String : อินพุต Stin ที่จะส่งผ่านไปประมวลผล |
stdoutFile |
File : ERROR(/File) ที่จะมีการเปลี่ยนเส้นทางเอาต์พุต Std อาจเป็นค่าว่างได้ |
stderrFile |
File : ERROR(/File) ที่จะเปลี่ยนเส้นทางเอาต์พุตที่เป็นข้อผิดพลาด อาจเป็นค่าว่างได้ |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
การเรียกใช้เวลา CmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
เมธอด Helper เพื่อเรียกใช้คำสั่งระบบที่ต้องใช้อินพุต stdin และล้มเลิกหาก ใช้เวลานานกว่าที่ระบุไว้
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที |
input |
String : อินพุต Stin ที่จะส่งผ่านไปประมวลผล |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
การเรียกใช้เวลา CmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
เมธอด Helper เพื่อเรียกใช้คำสั่งระบบที่ต้องใช้อินพุต stdin และล้มเลิกหาก ใช้เวลานานกว่าที่ระบุไว้
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที |
input |
String : อินพุต Stin ที่จะส่งผ่านไปประมวลผล |
command |
: ERROR(/List) ที่มีคำสั่งระบบและอาร์กิวเมนต์ที่ไม่บังคับให้เป็นปฏิบัติการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
RunTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
เมธอด Helper เพื่อเรียกใช้คำสั่งของระบบที่ต้องเปลี่ยนเส้นทาง Stdin จากไฟล์ และ ล้มเลิกหากใช้เวลานานกว่าที่ระบุไว้
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที |
inputRedirect |
File : ERROR(/File) ที่จะเปลี่ยนเส้นทางเป็นอินพุตมาตรฐานโดยใช้ ProcessBuilder.redirectInput() หากเป็น Null ระบบจะไม่เปลี่ยนเส้นทาง stdin |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
RunTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ ล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ
และเปลี่ยนเส้นทางเอาต์พุตไปยังไฟล์ หากระบุไว้ เมื่อมีการให้ ERROR(/OutputStream)
ด้วยวิธีนี้
ก็จะเปิดค้างไว้ในช่วงท้ายของฟังก์ชัน
พารามิเตอร์ | |
---|---|
timeout |
long : ระยะหมดเวลาสูงสุดที่จะรอ หน่วยเป็นมิลลิวินาที 0 หมายความว่าไม่มีการหมดเวลา |
idleOutputTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับเอาต์พุตไปยังสตรีมเอาต์พุต |
stdout |
OutputStream : ERROR(/OutputStream) ที่จะมีการเปลี่ยนเส้นทางเอาต์พุต Std อาจเป็นค่าว่างได้ |
stderr |
OutputStream : ERROR(/OutputStream) ที่จะเปลี่ยนเส้นทางเอาต์พุตที่เป็นข้อผิดพลาด อาจเป็นค่าว่างได้ |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
RunTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
เมธอด Helper ในการเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าที่ระบุ ตรวจสอบสตรีมเอาต์พุตสำหรับกิจกรรมด้วย และล้มเลิกหากไม่มีกิจกรรมการสตรีม สังเกตการณ์ในเวลาที่ระบุ หากตั้งค่า iframeOutputระยะหมดเวลา เป็น 0 จะไม่มีการตรวจสอบสตรีม จะปรากฏขึ้น
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที 0 หมายความว่าไม่มีการหมดเวลา |
idleOutputTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับเอาต์พุตไปยังสตรีมเอาต์พุต |
command |
String : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ที่ไม่บังคับดำเนินการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
RunTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
เมธอด Helper สำหรับเรียกใช้คำสั่งระบบกับการแคช
หากระบุ 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 : คำสั่งระบบที่ระบุและอาร์กิวเมนต์ (ไม่บังคับ) ที่จะปฏิบัติการ |
คิกรีเทิร์น | |
---|---|
CommandResult |
CommandResult ที่มีผลลัพธ์จากการเรียกใช้คำสั่ง |
จับเวลา ลองใหม่
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 หากดำเนินการสำเร็จก่อนที่จะถึงจำนวนที่กำหนด |
เรียกใช้Timedลองใหม่กับเอาต์พุตตรวจสอบ
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
บล็อกและเรียกใช้การดำเนินการหลายครั้งจนกว่าจะสำเร็จ รวมถึงติดตามดู สตรีมเอาต์พุตสำหรับกิจกรรม ระบบจะล้มเลิกหากไม่มีกิจกรรมการสตรีมในเวลาที่ระบุ หากตั้งค่า iframeOutputTimeout เป็น 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)
บล็อกและดำเนินการอย่างใดอย่างหนึ่ง รวมถึงล้มเลิกหากใช้เวลานานกว่าที่ระบุไว้ และ ตรวจสอบสตรีมเอาต์พุตสำหรับกิจกรรม และล้มเลิกหากไม่พบกิจกรรมการสตรีมสำหรับ เวลาที่ระบุ หากตั้งค่า iframeOutputTimeout เป็น 0 จะไม่มีการตรวจสอบสตรีม
พารามิเตอร์ | |
---|---|
timeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาที |
idleOutputTimeout |
long : เวลาสูงสุดในการรอ หน่วยเป็นมิลลิวินาทีสำหรับเอาต์พุตไปยังสตรีมเอาต์พุต |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult เพื่อเรียกใช้ |
logErrors |
boolean : บันทึกข้อผิดพลาดเกี่ยวกับข้อยกเว้นหรือไม่ |
คิกรีเทิร์น | |
---|---|
CommandStatus |
ผลการดำเนินงาน CommandStatus |
ตัวแปร setEnv
public void setEnvVariable (String name, String value)
ตั้งค่าตัวแปรสภาพแวดล้อมที่จะใช้เมื่อเรียกใช้คำสั่งของระบบ
พารามิเตอร์ | |
---|---|
name |
String : ชื่อตัวแปร |
value |
String : ค่าตัวแปร |
ตั้งค่าตัวแปรลำดับความสำคัญ
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
เลือกว่าจะสร้างกระบวนการหรือไม่ การยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อมจะสูงกว่าหรือไม่
ลำดับความสำคัญมากกว่าการตั้งค่า
โดยค่าเริ่มต้น การยกเลิกการตั้งค่าจะมีลำดับความสำคัญสูงกว่า ซึ่งหมายความว่าหากพยายามที่จะตั้งค่าตัวแปรด้วย
มีการตั้งชื่อเดียวกัน ก็จะไม่เกิดขึ้นเนื่องจากจะไม่มีการตั้งค่าตัวแปร
ใช้กับอินสแตนซ์ IRunUtil
เริ่มต้นไม่ได้
พารามิเตอร์ | |
---|---|
priority |
IRunUtil.EnvPriority |
ตั้งให้ช่ำชองในอนาคต
public void setInterruptibleInFuture (Thread thread, long timeMs)
ตั้งค่าเป็น "รบกวนได้" หลังจากรอสักระยะหนึ่ง
ERROR(/CommandScheduler#shutdownHard())
ในการบังคับใช้จะสิ้นสุดในที่สุด
พารามิเตอร์ | |
---|---|
thread |
Thread : ชุดข้อความที่จะขัดจังหวะได้ |
timeMs |
long : เวลาที่ต้องรอก่อนการตั้งค่าขัดจังหวะ |
setLinux หยุดชะงัก
public void setLinuxInterruptProcess (boolean interrupt)
อนุญาตให้ใช้ Linux "kill" การหยุดชะงักของกระบวนการที่ทำงานผ่านเมธอด #runTimed เมื่อ
ถึงระยะหมดเวลา
ใช้กับอินสแตนซ์ IRunUtil
เริ่มต้นไม่ได้
พารามิเตอร์ | |
---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
ตั้งค่าสตรีมข้อผิดพลาดมาตรฐานให้เปลี่ยนเส้นทางไปยังสตรีมเอาต์พุตมาตรฐานเมื่อเรียกใช้ระบบ คำสั่ง ค่าเริ่มต้นคือ false
พารามิเตอร์ | |
---|---|
redirect |
boolean : ค่าใหม่สำหรับการเปลี่ยนเส้นทางหรือไม่ |
ตั้งค่า WorkingDir
public void setWorkingDir (File dir)
ตั้งค่าไดเรกทอรีการทำงานสำหรับคำสั่งของระบบ
พารามิเตอร์ | |
---|---|
dir |
File : ไดเรกทอรีที่ใช้งานอยู่ |
การนอนหลับ
public void sleep (long time)
วิธีการของ Helper ให้นอนหลับตามเวลาที่กำหนดโดยไม่สนใจข้อยกเว้นใดๆ
พารามิเตอร์ | |
---|---|
time |
long : ms เข้าสู่โหมดสลีป ระบบจะไม่สนใจค่าที่น้อยกว่าหรือเท่ากับ 0 |
เปรียบเทียบ
public static String toRelative (File start, String target)
พารามิเตอร์ | |
---|---|
start |
File |
target |
String |
คิกรีเทิร์น | |
---|---|
String |
ตัวแปรไม่ได้ตั้งค่าEnv
public void unsetEnvVariable (String key)
ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อม คำสั่งของระบบจึงจะทำงานโดยไม่มีตัวแปรสภาพแวดล้อมนี้
ตัวแปรสภาพแวดล้อมอาจรับค่าจากกระบวนการระดับบนสุด เราจึงต้องลบ
ตัวแปรสภาพแวดล้อมจาก ProcessBuilder.environment()
พารามิเตอร์ | |
---|---|
key |
String : ชื่อตัวแปร |
ดูเพิ่มเติม