org.jodconverter.local.process

Class AbstractProcessManager

java.lang.Object

org.jodconverter.local.process.AbstractProcessManager

All Implemented Interfaces:

ProcessManager

Direct Known Subclasses:

UnixProcessManager, WindowsProcessManager

public abstract class AbstractProcessManager
extends Object
implements ProcessManager

Base class for all process manager implementations included in the standard JODConverter distribution.

Field Summary

Fields inherited from interface org.jodconverter.local.process.ProcessManager

PID_NOT_FOUND, PID_UNKNOWN

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractProcessManager() Initializes a new instance of the class.

Method Summary

Modifier and Type	Method and Description
protected @NonNull List<String>	execute(String... cmdarray) Executes the specified command and return the output.
long	findPid(@NonNull ProcessQuery query) Finds a PID of a running process that has the specified command line.
protected abstract @NonNull String[]	getRunningProcessesCommand(String process) Gets the command to be executed to get a snapshot of all the running processes identified by the specified argument (process).
protected abstract @NonNull Pattern	getRunningProcessLinePattern() Gets the pattern to be used to match an output line containing the information about a running process.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jodconverter.local.process.ProcessManager

canFindPid, kill

Constructor Detail

AbstractProcessManager

protected AbstractProcessManager()

Initializes a new instance of the class.

Method Detail

execute

protected @NonNull List<String> execute(String... cmdarray)
                                 throws IOException

Executes the specified command and return the output.

Parameters:

cmdarray - An array containing the command to call and its arguments.

Returns:

The command execution output.

Throws:

IOException - If an I/O error occurs.

findPid

public long findPid(@NonNull ProcessQuery query)
             throws IOException

Description copied from interface: ProcessManager

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

Specified by:

findPid in interface ProcessManager

Parameters:

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

Returns:

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

Throws:

IOException - If an IO error occurs.

getRunningProcessesCommand

protected abstract @NonNull String[] getRunningProcessesCommand(String process)

Gets the command to be executed to get a snapshot of all the running processes identified by the specified argument (process).

Parameters:

process - The name of the process to query for.

Returns:

An array containing the command to call and its arguments.

getRunningProcessLinePattern

protected abstract @NonNull Pattern getRunningProcessLinePattern()

Gets the pattern to be used to match an output line containing the information about a running process. The output lines being tested against this pattern are the result of the execution of the command returned by the getRunningProcessesCommand function.

Returns:

The pattern.

See Also:

getRunningProcessesCommand(String)