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

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

RunUtil(boolean inheritEnvVars)

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

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

static void linkFile(File destRoot, String relToRoot, File target)

เชื่อมโยง target ไปยังสถานที่ภายใต้ destRoot

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)

อนุญาตให้ใช้ 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)

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

ช่อง

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

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

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

public RunUtil ()

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

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

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: ชื่อตัวแปร

ดูเพิ่มเติม