Module com.aoindustries.aoserv.daemon

Package com.aoindustries.aoserv.daemon.posix.linux

Class PackageManager

java.lang.Object

com.aoindustries.aoserv.daemon.posix.linux.PackageManager

public final class PackageManager
extends Object

Manages the set of packages on a server.

Author:

AO Industries, Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	PackageManager.Architecture
static interface	PackageManager.PackageListener	Called when the package list is updated or first loaded.
static enum	PackageManager.PackageName	The set of all managed package names.
static class	PackageManager.Rpm
static class	PackageManager.Version

Field Summary

Fields

Modifier and Type	Field	Description
static final String	APACHE_TOMCAT_PREFIX	The name prefix used to match any Apache Tomcat package installations after the move to AORepo.org.
static final String	OLD_APACHE_TOMCAT_PREFIX	The name prefix used to match any Apache Tomcat package installations before the move to AORepo.org.

Method Summary

Modifier and Type	Method	Description
static void	addPackageListener(PackageManager.PackageListener listener)	Adds a new package listener to be notified when the package list is updated or first loaded.
static SortedSet<PackageManager.Rpm>	getAllRpms()	Gets the set of all packages installed on the server.
static PackageManager.Rpm	getInstalledPackage(PackageManager.PackageName name)	Gets the highest version of an installed package or null if not installed.
static PackageManager.Rpm	installPackage(PackageManager.PackageName name)	Installs a package if it is not currently installed.
static PackageManager.Rpm	installPackage(PackageManager.PackageName name, Runnable onInstall)	Installs a package if it is not currently installed.
static void	installPackages(PackageManager.PackageName... packageNames)	Installs all of the packages that are not currently installed.
static void	installPackages(Iterable<PackageManager.PackageName> packageNames)	Installs all of the packages that are not currently installed.
static boolean	removePackage(PackageManager.PackageName name)	Removes the package with the provided name.
static boolean	removePackageListener(PackageManager.PackageListener listener)	Removes a package listener.

Methods inherited from class java.lang.Object

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

Field Details

APACHE_TOMCAT_PREFIX

public static final String APACHE_TOMCAT_PREFIX

The name prefix used to match any Apache Tomcat package installations after the move to AORepo.org.

See Also:

• Constant Field Values

OLD_APACHE_TOMCAT_PREFIX

public static final String OLD_APACHE_TOMCAT_PREFIX

The name prefix used to match any Apache Tomcat package installations before the move to AORepo.org.

See Also:

• Constant Field Values

Method Details

getAllRpms

public static SortedSet<PackageManager.Rpm> getAllRpms()
                                                throws IOException

Gets the set of all packages installed on the server. Because rpm -aq can take several seconds to run, the results are cached and only updated when a file in /var/lib/rpm has been modified.

Throws:

IOException

getInstalledPackage

public static PackageManager.Rpm getInstalledPackage(PackageManager.PackageName name)
                                              throws IOException

Gets the highest version of an installed package or null if not installed.

Throws:

IOException

installPackage

public static PackageManager.Rpm installPackage(PackageManager.PackageName name)
                                         throws IOException

Installs a package if it is not currently installed. If the package is already installed, no action is taken. The package is installed with "yum -q -y install $NAME". If multiple packages are already installed, the highest version is returned.

Returns:

the highest version of RPM that is installed

Throws:

IOException

installPackage

public static PackageManager.Rpm installPackage(PackageManager.PackageName name,
 Runnable onInstall)
                                         throws IOException

Installs a package if it is not currently installed. If the package is already installed, no action is taken. The package is installed with "yum -q -y install $NAME". If multiple packages are already installed, the highest version is returned.

Parameters:

onInstall - Called when the RPM is actually installed. Not called if already installed.

Returns:

the highest version of RPM that is installed

Throws:

IOException

installPackages

public static void installPackages(Iterable<PackageManager.PackageName> packageNames)
                            throws IOException

Installs all of the packages that are not currently installed. If a package is already installed, no action is taken for that package.

Throws:

IOException

See Also:

• installPackage(com.aoindustries.aoserv.daemon.unix.linux.PackageManager.PackageName)

installPackages

public static void installPackages(PackageManager.PackageName... packageNames)
                            throws IOException

Installs all of the packages that are not currently installed. If a package is already installed, no action is taken for that package.

Throws:

IOException

See Also:

• installPackage(com.aoindustries.aoserv.daemon.unix.linux.PackageManager.PackageName)

removePackage

public static boolean removePackage(PackageManager.PackageName name)
                             throws IOException

Removes the package with the provided name. There must be only one match for the provided name. If the RPM is not installed, no action is taken. If more than one version is installed, an exception is thrown.

Returns:

true when a package was removed

Throws:

IOException

See Also:

• Call remove on a specific RPM when multiple version may be installed

addPackageListener

public static void addPackageListener(PackageManager.PackageListener listener)

Adds a new package listener to be notified when the package list is updated or first loaded.

See Also:

• removePackageListener(com.aoindustries.aoserv.daemon.unix.linux.PackageManager.PackageListener)
• ConcurrentListenerManager.addListener(java.lang.Object, boolean)

removePackageListener

public static boolean removePackageListener(PackageManager.PackageListener listener)

Removes a package listener.

Returns:

true if the listener was removed, false when not found

See Also:

• addPackageListener(com.aoindustries.aoserv.daemon.unix.linux.PackageManager.PackageListener)
• ConcurrentListenerManager.removeListener(java.lang.Object)