com.izforge.izpack.util

Class PrivilegedRunner

java.lang.Object

com.izforge.izpack.util.PrivilegedRunner

public class PrivilegedRunner
extends Object

This class is responsible for allowing the installer to re-launch itself with administrator permissions. The way of achieving this greatly varies among the platforms. The JDK classes are of not help here as there is no way to tell a JVM to run as a different user but to launch a new one.

Author:

Julien Ponge

Constructor Summary

Constructors

Constructor and Description
PrivilegedRunner(Platform platform) Builds a default privileged runner.

Method Summary

Modifier and Type	Method and Description
protected File	extractMacElevator()
protected File	extractVistaElevator()
protected List<String>	getElevator(String javaCommand, String installer, String[] args)
boolean	hasCorrectPermissions(Info info, RulesEngine rules) Check if user has correct permissions to use the installer.
boolean	isAdminUser() Determine if user has administrative privileges.
boolean	isElevationNeeded() Determines if elevated rights are required to install/uninstall the application.
boolean	isElevationNeeded(String path) Determines if elevated rights are required to install/uninstall the application.
boolean	isPlatformSupported() Checks if the current platform is supported.
static boolean	isPrivilegedMode()
int	relaunchWithElevatedRights() Relaunches the installer with elevated rights.
int	relaunchWithElevatedRights(String... args)

Methods inherited from class java.lang.Object

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

Constructor Detail

PrivilegedRunner

public PrivilegedRunner(Platform platform)

Builds a default privileged runner.

Parameters:

platform - the current platform

Method Detail

isPlatformSupported

public boolean isPlatformSupported()

Checks if the current platform is supported.

Returns:

true if the platform is supported, false otherwise.

isElevationNeeded

public boolean isElevationNeeded()

Determines if elevated rights are required to install/uninstall the application.

Returns:

true if elevation is needed to have administrator permissions, false otherwise.

isElevationNeeded

public boolean isElevationNeeded(String path)

Determines if elevated rights are required to install/uninstall the application.

Parameters:

path - the installation path, or null if the installation path is unknown

Returns:

true if elevation is needed to have administrator permissions, false otherwise.

isAdminUser

public boolean isAdminUser()

Determine if user has administrative privileges.

Returns:

hasCorrectPermissions

public boolean hasCorrectPermissions(Info info,
                                     RulesEngine rules)

Check if user has correct permissions to use the installer.

Parameters:

info -

rules -

Returns:

relaunchWithElevatedRights

public int relaunchWithElevatedRights()
                               throws Exception

Relaunches the installer with elevated rights.

Returns:

the status code returned by the launched process (by convention, 0 means a success).

Throws:

IOException - if an I/O error occurs

InterruptedException - if the launch was interrupted

Exception

relaunchWithElevatedRights

public int relaunchWithElevatedRights(String... args)
                               throws Exception

Throws:

Exception

isPrivilegedMode

public static boolean isPrivilegedMode()

getElevator

protected List<String> getElevator(String javaCommand,
                                   String installer,
                                   String[] args)
                            throws IOException

Throws:

IOException

extractVistaElevator

protected File extractVistaElevator()
                             throws IOException

Throws:

IOException

extractMacElevator

protected File extractMacElevator()
                           throws IOException

Throws:

IOException