프로세스 활용

public final class ProcessUtil
extends Object

java.lang.Object
com.android.sts.common.ProcessUtil


장치에서 프로세스를 찾고, 기다리고, 종료하는 다양한 도우미

요약

중첩 클래스

class ProcessUtil.KillException

상수

long PROCESS_POLL_PERIOD_MS

long PROCESS_WAIT_TIMEOUT_MS

공개 메소드

static Optional<IFileEntry> findFileLoadedByProcess (ITestDevice device, String process, String filenameSubstr)

지정된 이름을 가진 지정된 프로세스에 의해 로드된 첫 번째 파일의 파일 항목을 반환합니다.

static Optional<List<String>> findFilesLoadedByProcess (ITestDevice device, int pid, Pattern filePattern)

지정된 프로세스에 의해 로드된 지정된 파일의 파일 이름을 반환합니다.

static Optional<String> getProcessName (ITestDevice device, int pid)

/proc/pid/cmdline에서 내용을 가져옵니다.

static boolean killAll (ITestDevice device, String pgrepRegex, long timeoutMs, boolean expectExist)

패턴과 일치하는 모든 프로세스에 SIGKILL을 보냅니다.

static boolean killAll (ITestDevice device, String pgrepRegex, long timeoutMs)

패턴과 일치하는 모든 프로세스에 SIGKILL을 보냅니다.

static void killPid (ITestDevice device, int pid, long timeoutMs)

SIGKILL을 프로세스에 보내고 프로세스가 종료될 때까지 기다립니다.

static void killPid (ITestDevice device, int pid, int signal, long timeoutMs)

프로세스에 신호를 보내고 종료될 때까지 기다립니다.

static Optional<List<String>> listOpenFiles (ITestDevice device, int pid)

지정된 프로세스의 현재 열려 있는 파일 이름을 반환합니다.

static Optional<Integer> pidOf (ITestDevice device, String pgrepRegex)

`pgrep`에 전달된 패턴과 일치하는 단일 pid를 가져옵니다.

static Optional<Map<Integer, String>> pidsOf (ITestDevice device, String pgrepRegex)

`pgrep`에 전달된 패턴과 일치하는 PID를 가져옵니다.

static void waitPidExited (ITestDevice device, int pid)

프로세스가 종료될 때까지 기다립니다.

static void waitPidExited (ITestDevice device, int pid, long timeoutMs)

프로세스가 종료될 때까지 기다립니다.

static Map<Integer, String> waitProcessRunning (ITestDevice device, String pgrepRegex, long timeoutMs)

특정 정규식에 대해 실행 중인 프로세스를 찾을 때까지 기다립니다.

static Map<Integer, String> waitProcessRunning (ITestDevice device, String pgrepRegex)

특정 정규식에 대해 실행 중인 프로세스를 찾을 때까지 기다립니다.

static AutoCloseable withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill, long timeoutMs)

테스트 시작과 끝에서 프로세스를 종료합니다.

static AutoCloseable withProcessKill (ITestDevice device, String pgrepRegex, Runnable beforeCloseKill)

테스트 시작과 끝에서 프로세스를 종료합니다.

상수

PROCESS_POLL_PERIOD_MS

public static final long PROCESS_POLL_PERIOD_MS

상수값: 250(0x00000000000000fa)

PROCESS_WAIT_TIMEOUT_MS

public static final long PROCESS_WAIT_TIMEOUT_MS

상수값: 10000 (0x0000000000002710)

공개 메소드

findFileLoadedByProcess

public static Optional<IFileEntry> findFileLoadedByProcess (ITestDevice device, 
                String process, 
                String filenameSubstr)

지정된 이름을 가진 지정된 프로세스에 의해 로드된 첫 번째 파일의 파일 항목을 반환합니다.

매개변수
device ITestDevice : 실행될 장치

process String : 찾을 프로세스의 pgrep 패턴

filenameSubstr String : 프로세스가 로드한 파일 이름/경로의 일부

보고
Optional<IFileEntry> 존재하는 경우 장치에 있는 파일 경로의 IFileEntry 옵션입니다.

던지기
DeviceNotAvailableException

findFilesLoadedByProcess

public static Optional<List<String>> findFilesLoadedByProcess (ITestDevice device, 
                int pid, 
                Pattern filePattern)

지정된 프로세스에 의해 로드된 지정된 파일의 파일 이름을 반환합니다.

매개변수
device ITestDevice : 실행될 장치

pid int : 검색할 프로세스의 ID

filePattern Pattern : 반환할 파일 이름의 패턴

보고
Optional<List<String>> 필터링된 파일의 선택 사항입니다. 프로세스를 찾을 수 없거나 열린 파일을 읽을 수 없으면 비어 있습니다.

던지기
DeviceNotAvailableException

getProcessName

public static Optional<String> getProcessName (ITestDevice device, 
                int pid)

/proc/pid/cmdline에서 내용을 가져옵니다.

매개변수
device ITestDevice : 사용할 장치

pid int : 이름을 가져올 프로세스의 ID

보고
Optional<String> /proc/pid/cmdline 내용의 선택적 문자열; pid를 찾을 수 없으면 비어 있습니다.

던지기
DeviceNotAvailableException

다 죽여

public static boolean killAll (ITestDevice device, 
                String pgrepRegex, 
                long timeoutMs, 
                boolean expectExist)

패턴과 일치하는 모든 프로세스에 SIGKILL을 보냅니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep의 정규식을 나타내는 문자열

timeoutMs long : TimeoutException이 발생하기 전까지 기다려야 하는 시간

expectExist boolean : 프로세스가 종료되지 않았을 때 예외를 발생시켜야 하는지 여부

보고
boolean 프로세스가 종료되었는지 여부

던지기
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

다 죽여

public static boolean killAll (ITestDevice device, 
                String pgrepRegex, 
                long timeoutMs)

패턴과 일치하는 모든 프로세스에 SIGKILL을 보냅니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep의 정규식을 나타내는 문자열

timeoutMs long : TimeoutException이 발생하기 전까지 기다려야 하는 시간

보고
boolean 프로세스가 종료되었는지 여부

던지기
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

killPid

public static void killPid (ITestDevice device, 
                int pid, 
                long timeoutMs)

SIGKILL을 프로세스에 보내고 프로세스가 종료될 때까지 기다립니다.

매개변수
device ITestDevice : 사용할 장치

pid int : 종료될 때까지 기다리는 프로세스의 ID

timeoutMs long : TimeoutException이 발생하기 전까지 기다려야 하는 시간

던지기
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

killPid

public static void killPid (ITestDevice device, 
                int pid, 
                int signal, 
                long timeoutMs)

프로세스에 신호를 보내고 종료될 때까지 기다립니다.

매개변수
device ITestDevice : 사용할 장치

pid int : 종료될 때까지 기다리는 프로세스의 ID

signal int : 프로세스에 보낼 신호

timeoutMs long : TimeoutException이 발생하기 전까지 기다려야 하는 시간

던지기
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

목록열린파일

public static Optional<List<String>> listOpenFiles (ITestDevice device, 
                int pid)

지정된 프로세스의 현재 열려 있는 파일 이름을 반환합니다.

매개변수
device ITestDevice : 실행될 장치

pid int : 검색할 프로세스의 ID

보고
Optional<List<String>> 열려 있는 파일의 선택 사항입니다. 프로세스를 찾을 수 없거나 열린 파일을 읽을 수 없으면 비어 있습니다.

던지기
DeviceNotAvailableException

pidOf

public static Optional<Integer> pidOf (ITestDevice device, 
                String pgrepRegex)

`pgrep`에 전달된 패턴과 일치하는 단일 pid를 가져옵니다. 패턴과 일치하는 PID가 두 개 이상인 경우 IllegalArgumentException 이 발생합니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep의 정규식을 나타내는 문자열

보고
Optional<Integer> pid의 선택적 정수; pgrep이 EXIT_SUCCESS를 반환하지 않으면 비어 있습니다.

던지기
DeviceNotAvailableException
IllegalArgumentException

pidsOf

public static Optional<Map<Integer, String>> pidsOf (ITestDevice device, 
                String pgrepRegex)

`pgrep`에 전달된 패턴과 일치하는 PID를 가져옵니다. /proc/pid/comm이 잘렸기 때문에 전체 명령줄을 확인하기 위해 `pgrep`이 `-f`와 함께 전달됩니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep의 정규식을 나타내는 문자열

보고
Optional<Map<Integer, String>> 명령줄에 대한 pid의 선택적 맵; pgrep이 EXIT_SUCCESS를 반환하지 않으면 비어 있습니다.

던지기
DeviceNotAvailableException

waitPid종료됨

public static void waitPidExited (ITestDevice device, 
                int pid)

프로세스가 종료될 때까지 기다립니다. 이것은 변화하기를 기다리는 것이 아니라 단순히 존재하지 않는 것입니다. 폴링 간에 PID를 재사용하는 것은 가능하지만 가능성은 낮습니다.

매개변수
device ITestDevice : 사용할 장치

pid int : 종료될 때까지 기다리는 프로세스의 ID

던지기
TimeoutException
DeviceNotAvailableException
ProcessUtil.KillException

waitPid종료됨

public static void waitPidExited (ITestDevice device, 
                int pid, 
                long timeoutMs)

프로세스가 종료될 때까지 기다립니다. 이것은 변화하기를 기다리는 것이 아니라 단순히 존재하지 않는 것입니다. 폴링 간에 PID를 재사용하는 것은 가능하지만 가능성은 낮습니다.

매개변수
device ITestDevice : 사용할 장치

pid int : 종료될 때까지 기다리는 프로세스의 ID

timeoutMs long : TimeoutException이 발생하기 전까지 기다려야 하는 시간

던지기
TimeoutException
DeviceNotAvailableException
ProcessUtil.KillException

대기프로세스실행중

public static Map<Integer, String> waitProcessRunning (ITestDevice device, 
                String pgrepRegex, 
                long timeoutMs)

특정 정규식에 대해 실행 중인 프로세스를 찾을 때까지 기다립니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep의 정규식을 나타내는 문자열

timeoutMs long : TimeoutException이 발생하기 전까지 기다려야 하는 시간

보고
Map<Integer, String> pidsOf(...)의 명령 맵에 대한 pid

던지기
TimeoutException
DeviceNotAvailableException

대기프로세스실행중

public static Map<Integer, String> waitProcessRunning (ITestDevice device, 
                String pgrepRegex)

특정 정규식에 대해 실행 중인 프로세스를 찾을 때까지 기다립니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep의 정규식을 나타내는 문자열

보고
Map<Integer, String> pidsOf(...)의 명령 맵에 대한 pid

던지기
TimeoutException
DeviceNotAvailableException

withProcessKill

public static AutoCloseable withProcessKill (ITestDevice device, 
                String pgrepRegex, 
                Runnable beforeCloseKill, 
                long timeoutMs)

테스트 시작과 끝에서 프로세스를 종료합니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep에 제공하기 위해 종료할 프로세스의 이름 패턴

beforeCloseKill Runnable : 테스트가 끝날 때 일반 환경에서 프로세스를 종료하기 전에 정리해야 하는 모든 작업에 대한 실행 가능 파일입니다. null일 수 있습니다.

timeoutMs long : 프로세스가 종료될 때까지 기다리는 시간(밀리초)

보고
AutoCloseable 프로세스가 닫힐 때 프로세스를 다시 종료하는 객체

던지기
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException

withProcessKill

public static AutoCloseable withProcessKill (ITestDevice device, 
                String pgrepRegex, 
                Runnable beforeCloseKill)

테스트 시작과 끝에서 프로세스를 종료합니다.

매개변수
device ITestDevice : 사용할 장치

pgrepRegex String : pgrep에 제공하기 위해 종료할 프로세스의 이름 패턴

beforeCloseKill Runnable : 테스트가 끝날 때 일반 환경에서 프로세스를 종료하기 전에 정리해야 하는 모든 작업에 대한 실행 가능 파일입니다. null일 수 있습니다.

보고
AutoCloseable 프로세스가 닫힐 때 프로세스를 다시 종료하는 객체

던지기
DeviceNotAvailableException
TimeoutException
ProcessUtil.KillException