org.jodconverter.local.process

Interface ProcessManager

All Known Implementing Classes:

AbstractProcessManager, FreeBSDProcessManager, MacProcessManager, PureJavaProcessManager, UnixProcessManager, WindowsProcessManager

public interface ProcessManager

Provides services required to manage a running process.

Field Summary

Fields

Modifier and Type	Field and Description
static long	PID_NOT_FOUND
static long	PID_UNKNOWN

Method Summary

Modifier and Type	Method and Description
default boolean	canFindPid() Indicates whether the pid of the process can be found using a command line.
default long	findPid(@NonNull ProcessQuery query) Finds a PID of a running process that has the specified command line.
default void	kill(@Nullable Process process, long pid) Kills the specified process.

Field Detail

PID_NOT_FOUND

static final long PID_NOT_FOUND

See Also:

Constant Field Values

PID_UNKNOWN

static final long PID_UNKNOWN

See Also:

Constant Field Values

Method Detail

canFindPid

default boolean canFindPid()

Indicates whether the pid of the process can be found using a command line.

Returns:

true if the pid can be found using a command line, false otherwise.

findPid

default long findPid(@NonNull ProcessQuery query)
              throws IOException

Finds a PID of a running process that has the specified command line.

Parameters:

query - A query used to find the process with the pid we are looking for.

Returns:

The pid if found, PID_NOT_FOUND if not, or PID_UNKNOWN if this implementation is unable to find out

Throws:

IOException - If an IO error occurs.

kill

default void kill(@Nullable Process process,
                  long pid)
           throws IOException

Kills the specified process.

Parameters:

process - The process to kill.

pid - The id of the process to kill.

Throws:

IOException - If an IO error occurs.