org.jodconverter.local.process

Class UnixProcessManager

java.lang.Object

org.jodconverter.local.process.AbstractProcessManager

org.jodconverter.local.process.UnixProcessManager

All Implemented Interfaces:

ProcessManager

Direct Known Subclasses:

FreeBSDProcessManager, MacProcessManager

public class UnixProcessManager
extends AbstractProcessManager

ProcessManager implementation for *nix systems. Uses the ps and kill commands.

Works for Linux. Works for Solaris too, except that the command line string returned by ps there is limited to 80 characters and this affects AbstractProcessManager.findPid(ProcessQuery).

Field Summary

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

PID_NOT_FOUND, PID_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
UnixProcessManager()

Method Summary

Modifier and Type	Method and Description
protected @NonNull List<String>	execute(String... cmdarray) Executes the specified command and return the output.
static @NonNull UnixProcessManager	getDefault() Gets the default instance of UnixProcessManager.
protected @NonNull String[]	getRunningProcessesCommand(@NonNull String process) Gets the command to be executed to get a snapshot of all the running processes identified by the specified argument (process).
protected @NonNull Pattern	getRunningProcessLinePattern() Gets the pattern to be used to match an output line containing the information about a running process.
void	kill(@Nullable Process process, long pid) Kills the specified process.
void	setRunAsArgs(String... runAsArgs) Sets The sudo command arguments.

Methods inherited from class org.jodconverter.local.process.AbstractProcessManager

findPid

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

Constructor Detail

UnixProcessManager

public UnixProcessManager()

Method Detail

getDefault

public static @NonNull UnixProcessManager getDefault()

Gets the default instance of UnixProcessManager.

Returns:

The default UnixProcessManager instance.

execute

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

Description copied from class: AbstractProcessManager

Executes the specified command and return the output.

Overrides:

execute in class AbstractProcessManager

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.

getRunningProcessesCommand

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

Description copied from class: AbstractProcessManager

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

Specified by:

getRunningProcessesCommand in class AbstractProcessManager

Parameters:

process - The name of the process to query for.

Returns:

An array containing the command to call and its arguments.

getRunningProcessLinePattern

protected @NonNull Pattern getRunningProcessLinePattern()

Description copied from class: AbstractProcessManager

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.

Specified by:

getRunningProcessLinePattern in class AbstractProcessManager

Returns:

The pattern.

See Also:

AbstractProcessManager.getRunningProcessesCommand(String)

kill

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

Description copied from interface: ProcessManager

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.

setRunAsArgs

public void setRunAsArgs(String... runAsArgs)

Sets The sudo command arguments.

Parameters:

runAsArgs - The sudo command arguments.