alma.acs.testsupport

Class ProcessUtil

java.lang.Object

alma.acs.testsupport.ProcessUtil

public class ProcessUtil
extends java.lang.Object

Helper class to be used by tests which need to verify that some other process exists or does not exist, or that need to kill some process. Don't use this class in operational code!

Constructor Summary

Constructors

Constructor and Description
ProcessUtil(java.util.logging.Logger logger)

Method Summary

Modifier and Type	Method and Description
protected java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getJavaPIDs() Gets a map with key=(running java main classes) and value=(list of the process IDs).
java.util.List<java.lang.String>	getJavaPIDs(java.lang.Class<?> mainClass) Gets the process IDs of all java processes run by the current user on the local host, whose main class is given as the parameter.
boolean	isJavaProcessRunning(java.lang.Class<?> mainClass) Returns true if one or more JVMs are running the given Java main class on the local host as the current user.
int	killProcess(java.lang.String pid, boolean tough) Kills a process with a given PID, which could be obtained from getJavaPIDs(Class).
void	setDebug(boolean DEBUG)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ProcessUtil

public ProcessUtil(java.util.logging.Logger logger)

Method Detail

getJavaPIDs

public java.util.List<java.lang.String> getJavaPIDs(java.lang.Class<?> mainClass)
                                             throws java.io.IOException

Gets the process IDs of all java processes run by the current user on the local host, whose main class is given as the parameter.

The "jps" command is used via Runtime.exec, which should work not only on Linux but also on Windows.

Throws:

java.io.IOException

isJavaProcessRunning

public boolean isJavaProcessRunning(java.lang.Class<?> mainClass)
                             throws java.io.IOException

Returns true if one or more JVMs are running the given Java main class on the local host as the current user.

Throws:

java.io.IOException

killProcess

public int killProcess(java.lang.String pid,
                       boolean tough)
                throws java.io.IOException,
                       java.lang.InterruptedException

Kills a process with a given PID, which could be obtained from getJavaPIDs(Class).

Parameters:

tough - if true, a tough way of killing is used (kill -9)

Returns:

Exit value of the kill command

Throws:

java.io.IOException

java.lang.InterruptedException

getJavaPIDs

protected java.util.Map<java.lang.String,java.util.List<java.lang.String>> getJavaPIDs()
                                                                                throws java.io.IOException

Gets a map with key=(running java main classes) and value=(list of the process IDs). Filters out sun.tools.jps.Jps which is the tool used to get the processes.

Returns:

Map

Throws:

java.io.IOException

java.lang.InterruptedException

setDebug

public void setDebug(boolean DEBUG)