เรียกใช้ยูทิลิตี

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 ใหม่ที่จะใช้

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

void allowInterrupt(boolean allow)

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

static IRunUtil getDefault()

ดูการอ้างอิงออบเจ็กต์ RunUtil เริ่มต้น

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

ขัดจังหวะการดำเนินการที่ดำเนินอยู่/ที่กำลังจะถึงในชุดข้อความที่ระบุ

void interrupt(Thread thread, String message)

ขัดจังหวะการดำเนินการที่ดำเนินอยู่/ที่กำลังจะถึงในชุดข้อความที่ระบุ

boolean isInterruptAllowed()

กำหนดสถานะการรบกวนของ RunUtil

Process runCmdInBackground(Redirect redirect, command)

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

Process runCmdInBackground( command)

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

Process runCmdInBackground( command, OutputStream output)

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

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, command)

เมธอด 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)

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

void setRedirectStderrToStdout(boolean redirect)

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

void setWorkingDir(File dir)

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

void sleep(long time)

วิธีการของ Helper ให้นอนหลับตามเวลาที่กำหนดโดยไม่สนใจข้อยกเว้นใดๆ

void unsetEnvVariable(String key)

ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อม คำสั่งของระบบจึงจะทำงานโดยไม่มีตัวแปรสภาพแวดล้อมนี้ ตัวแปรสภาพแวดล้อมอาจรับค่าจากกระบวนการระดับบนสุด เราจึงต้องลบตัวแปรสภาพแวดล้อมออกจาก ProcessBuilder.environment()

ช่อง

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

ช่างก่อสร้างสาธารณะ

เรียกใช้ยูทิลิตี

public RunUtil ()

สร้างออบเจ็กต์ RunUtil ใหม่ที่จะใช้

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

อนุญาตการพัก

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 หากไม่เช่นนั้น

เรียกใช้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 เพื่อเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ นอกจากนี้ ให้ตรวจสอบสตรีมเอาต์พุตสำหรับกิจกรรม โดยล้มเลิกหากไม่มีกิจกรรมการสตรีมในเวลาที่ระบุ หากตั้งค่า iframeOutputTimeout เป็น 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 เพื่อเรียกใช้คำสั่งระบบ และล้มเลิกหากใช้เวลานานกว่าเวลาที่ระบุ นอกจากนี้ ให้ตรวจสอบสตรีมเอาต์พุตสำหรับกิจกรรม โดยล้มเลิกหากไม่มีกิจกรรมการสตรีมในเวลาที่ระบุ หากตั้งค่า iframeOutputTimeout เป็น 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)

อนุญาตให้ใช้การขัดจังหวะ 'kill' ของ Linux ในกระบวนการที่ทำงานผ่านเมธอด #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 จะถูกละเว้น

ตัวแปรไม่ได้ตั้งค่าEnv

public void unsetEnvVariable (String key)

ยกเลิกการตั้งค่าตัวแปรสภาพแวดล้อม คำสั่งของระบบจึงจะทำงานโดยไม่มีตัวแปรสภาพแวดล้อมนี้ ตัวแปรสภาพแวดล้อมอาจรับค่าจากกระบวนการระดับบนสุด เราจึงต้องลบตัวแปรสภาพแวดล้อมออกจาก ProcessBuilder.environment()

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

ดูเพิ่มเติม