weka.core.packageManagement

Class DefaultPackageManager

java.lang.Object

weka.core.packageManagement.PackageManager

weka.core.packageManagement.DefaultPackageManager

public class DefaultPackageManager
extends PackageManager

A concrete implementation of PackageManager that uses Java properties files/class to manage package meta data. Assumes that meta data for individual packages is stored on the central repository (accessible via http) in properties files that live in a subdirectory with the same name as the package. Furthermore, each property file is assumed to be named as the version number of the package in question with a ".props" extension. A "Latest.props" file should exist for each package and should always hold meta data on the latest version of a package.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	DefaultPackageManager.DefaultPMDefaults Default settings for the default package manager implementation

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	BUFF_SIZE buffer size for copying files
protected static java.lang.String	INSTALLED_PACKAGE_CACHE_FILE
protected static byte[]	m_buffer buffer used in copying files
protected int	m_timeout Timeout to use for comms
protected static java.util.List<Package>	s_installedPackageList
protected static java.lang.String	TIMEOUT_PROPERTY Key for the socket timeout property

Fields inherited from class weka.core.packageManagement.PackageManager

m_authenticatorSet, m_baseSystemName, m_baseSystemVersion, m_httpProxy, m_packageHome, m_packageRepository, m_proxyPassword, m_proxyUsername

Constructor Summary

Constructors

Constructor and Description
DefaultPackageManager() Constructor

Method Summary

Modifier and Type	Method and Description
void	applySettings(Settings settings) Apply settings.
protected static boolean	checkDependencies(PackageConstraint toCheck, java.util.Map<java.lang.String,Dependency> lookup, java.util.Map<java.lang.String,java.util.List<Dependency>> conflicts) Checks a given package's list of dependencies for any conflicts with the packages in the supplied Map.
static void	deleteDir(java.io.File dir, java.io.PrintStream... progress)
protected void	deleteInstalledPackageCacheFile()
protected java.io.File	downloadArchive(java.net.URL packageURL, java.lang.String fileExtension, java.io.PrintStream... progress)
protected boolean	establishPackageHome() Checks to see if the package home exists and creates it if necessary.
java.util.List<Dependency>	getAllDependenciesForPackage(Package target, java.util.Map<java.lang.String,java.util.List<Dependency>> conflicts) Gets a full list of packages (encapsulated in Dependency objects) that are required by directly and indirectly by the named target package.
java.util.List<Package>	getAllPackages(java.io.PrintStream... progress) Get all packages that the system knows about (i.e. all packages contained in the repository).
java.util.List<Package>	getAvailablePackages() Get a list of packages that are not currently installed.
Defaults	getDefaultSettings() Get the default settings for the default package manager
Package	getInstalledPackageInfo(java.lang.String packageName) Get package information on the named installed package.
java.util.List<Package>	getInstalledPackages() Get a list of installed packages.
Package	getPackageArchiveInfo(java.lang.String packageArchivePath) Get package information from the supplied package archive file.
Package	getRepositoryPackageInfo(java.lang.String packageName) Get package information on the named package from the repository.
Package	getRepositoryPackageInfo(java.lang.String packageName, java.lang.Object version) Get package information on the named package from the repository.
byte[]	getRepositoryPackageMetaDataOnlyAsZip(java.io.PrintStream... progress) Gets an array of bytes containing a zip of all the repository meta data and supporting files.
byte[]	getRepositoryPackageMetaDataOnlyAsZipLegacy(java.io.PrintStream... progress) Gets an array of bytes containing a zip of all the repository meta data and supporting files using the legacy approach.
java.util.List<java.lang.Object>	getRepositoryPackageVersions(java.lang.String packageName) Get a list of available versions of the named package.
Package	getURLPackageInfo(java.net.URL packageURL) Get package information on the package at the given URL.
protected void	installAdditionalLibs(java.lang.String packageName, java.lang.String[] additionalLibURLs, java.io.PrintStream... progress) Installs additional library jar files (as specified in the AdditionalLibs entry in the Description.props file).
protected void	installPackage(java.lang.String packageArchivePath, java.lang.String packageName, java.io.PrintStream... progress) Installs a package from a zip/jar archive.
java.lang.String	installPackageFromArchive(java.lang.String packageArchivePath, java.io.PrintStream... progress) Install a package from an archive on the local file system.
void	installPackageFromRepository(java.lang.String packageName, java.lang.Object version, java.io.PrintStream... progress) Install a package sourced from the repository.
java.lang.String	installPackageFromURL(java.net.URL packageURL, java.io.PrintStream... progress) Install a package sourced from a given URL.
void	installPackages(java.util.List<Package> toInstall, java.io.PrintStream... progress) Installs all the packages in the supplied list.
protected java.util.List<Package>	loadInstalledPackageCache() Load the serialized installed package cache file
static void	main(java.lang.String[] args)
protected static java.lang.String	padLeft(java.lang.String inString, int length) Pads a string to a specified length, inserting spaces on the left as required.
protected static java.lang.String	padRight(java.lang.String inString, int length) Pads a string to a specified length, inserting spaces on the right as required.
protected void	saveInstalledPackageCache(java.util.List<Package> cacheToSave) Save the supplied list of Packages to the installed package cache file
void	uninstallPackage(java.lang.String packageName, java.io.PrintStream... progress) Uninstall a package.

Methods inherited from class weka.core.packageManagement.PackageManager

create, establishProxy, getBaseSystemName, getBaseSystemVersion, getPackageHome, getPackageRepositoryURL, getProxy, setBaseSystemName, setBaseSystemVersion, setPackageHome, setPackageRepositoryURL, setProxy, setProxyAuthentication, setProxyPassword, setProxyUsername

Methods inherited from class java.lang.Object

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

Field Detail

BUFF_SIZE

protected static final int BUFF_SIZE

buffer size for copying files

See Also:

Constant Field Values

m_buffer

protected static final byte[] m_buffer

buffer used in copying files

INSTALLED_PACKAGE_CACHE_FILE

protected static final java.lang.String INSTALLED_PACKAGE_CACHE_FILE

See Also:

Constant Field Values

s_installedPackageList

protected static java.util.List<Package> s_installedPackageList

m_timeout

protected int m_timeout

Timeout to use for comms

TIMEOUT_PROPERTY

protected static final java.lang.String TIMEOUT_PROPERTY

Key for the socket timeout property

See Also:

Constant Field Values

Constructor Detail

DefaultPackageManager

public DefaultPackageManager()

Constructor

Method Detail

getDefaultSettings

public Defaults getDefaultSettings()

Get the default settings for the default package manager

Overrides:

getDefaultSettings in class PackageManager

Returns:

the default settings

applySettings

public void applySettings(Settings settings)

Apply settings.

Overrides:

applySettings in class PackageManager

Parameters:

settings - the settings to apply

downloadArchive

protected java.io.File downloadArchive(java.net.URL packageURL,
                                       java.lang.String fileExtension,
                                       java.io.PrintStream... progress)
                                throws java.lang.Exception

Throws:

java.lang.Exception

getURLPackageInfo

public Package getURLPackageInfo(java.net.URL packageURL)
                          throws java.lang.Exception

Get package information on the package at the given URL.

Specified by:

getURLPackageInfo in class PackageManager

Parameters:

packageURL - the URL to the package.

Returns:

a Package object encapsulating the package meta data

Throws:

java.lang.Exception - if the package meta data can't be retrieved.

getRepositoryPackageInfo

public Package getRepositoryPackageInfo(java.lang.String packageName)
                                 throws java.lang.Exception

Get package information on the named package from the repository. If multiple versions of the package are available, it assumes that the most recent is required.

Specified by:

getRepositoryPackageInfo in class PackageManager

Parameters:

packageName - the name of the package to get information about.

Returns:

a Package object encapsulating the package meta data.

Throws:

java.lang.Exception - if the package meta data can't be retrieved.

getRepositoryPackageVersions

public java.util.List<java.lang.Object> getRepositoryPackageVersions(java.lang.String packageName)
                                                              throws java.lang.Exception

Get a list of available versions of the named package.

Specified by:

getRepositoryPackageVersions in class PackageManager

Parameters:

packageName - the name of the package to get versions.

Returns:

a list of available versions (or null if not applicable)

Throws:

java.lang.Exception - if something goes wrong while trying to retrieve the list of versions.

getRepositoryPackageInfo

public Package getRepositoryPackageInfo(java.lang.String packageName,
                                        java.lang.Object version)
                                 throws java.lang.Exception

Get package information on the named package from the repository.

Specified by:

getRepositoryPackageInfo in class PackageManager

Parameters:

packageName - the name of the package to get information about.

version - the version of the package to retrieve (may be null if not applicable).

Returns:

a Package object encapsulating the package meta data.

Throws:

java.lang.Exception - if the package meta data can't be retrieved.

getPackageArchiveInfo

public Package getPackageArchiveInfo(java.lang.String packageArchivePath)
                              throws java.lang.Exception

Get package information from the supplied package archive file.

Specified by:

getPackageArchiveInfo in class PackageManager

Parameters:

packageArchivePath - the path to the package archive file

Returns:

a Package object encapsulating the package meta data.

Throws:

java.lang.Exception - if the package meta data can't be retrieved.

getInstalledPackageInfo

public Package getInstalledPackageInfo(java.lang.String packageName)
                                throws java.lang.Exception

Get package information on the named installed package.

Specified by:

getInstalledPackageInfo in class PackageManager

Parameters:

packageName - the name of the package to get information about.

Returns:

a Package object encapsulating the package meta data or null if the package is not installed.

Throws:

java.lang.Exception - if the package meta data can't be retrieved.

establishPackageHome

protected boolean establishPackageHome()

Checks to see if the package home exists and creates it if necessary.

Returns:

true if the package home exists/was created successfully.

deleteDir

public static void deleteDir(java.io.File dir,
                             java.io.PrintStream... progress)
                      throws java.lang.Exception

Throws:

java.lang.Exception

uninstallPackage

public void uninstallPackage(java.lang.String packageName,
                             java.io.PrintStream... progress)
                      throws java.lang.Exception

Uninstall a package.

Specified by:

uninstallPackage in class PackageManager

Parameters:

packageName - the package to uninstall.

progress - optional varargs parameter, that, if supplied, is expected to contain one or more PrintStream objects to write progress to.

Throws:

java.lang.Exception - if the named package could not be removed for some reason.

installPackageFromArchive

public java.lang.String installPackageFromArchive(java.lang.String packageArchivePath,
                                                  java.io.PrintStream... progress)
                                           throws java.lang.Exception

Install a package from an archive on the local file system.

Specified by:

installPackageFromArchive in class PackageManager

Parameters:

packageArchivePath - the path to the package archive file.

progress - optional varargs parameter, that, if supplied, is expected to contain one or more PrintStream objects to write progress to.

Returns:

the name of the package installed

Throws:

java.lang.Exception - if the package can't be installed for some reason.

installAdditionalLibs

protected void installAdditionalLibs(java.lang.String packageName,
                                     java.lang.String[] additionalLibURLs,
                                     java.io.PrintStream... progress)
                              throws java.lang.Exception

Installs additional library jar files (as specified in the AdditionalLibs entry in the Description.props file).

Parameters:

packageName - the name of the package that will receive the downloaded libraries into its lib directory

additionalLibURLs - an array of urls to the libraries to download

progress - for progress reporting

Throws:

java.lang.Exception - if a problem occurs

installPackages

public void installPackages(java.util.List<Package> toInstall,
                            java.io.PrintStream... progress)
                     throws java.lang.Exception

Installs all the packages in the supplied list.

Specified by:

installPackages in class PackageManager

Parameters:

toInstall - a list of Packages to install.

progress - optional varargs parameter, that, if supplied, is expected to contain one or more PrintStream objects to write progress to.

Throws:

java.lang.Exception - if something goes wrong during the installation process.

checkDependencies

protected static boolean checkDependencies(PackageConstraint toCheck,
                                           java.util.Map<java.lang.String,Dependency> lookup,
                                           java.util.Map<java.lang.String,java.util.List<Dependency>> conflicts)
                                    throws java.lang.Exception

Checks a given package's list of dependencies for any conflicts with the packages in the supplied Map. Any packages from this packages dependency list that are not in the Map are simply added and checkDependencies is called recursively for each.

Parameters:

toCheck - the package to check.

lookup - a Map of package name, Dependency pairs to check against.

conflicts - a list of Dependency objects for any conflicts that are detected.

Returns:

true if no conflicts are found.

Throws:

java.lang.Exception - if a problem occurs when checking for conflicts.

getAllDependenciesForPackage

public java.util.List<Dependency> getAllDependenciesForPackage(Package target,
                                                               java.util.Map<java.lang.String,java.util.List<Dependency>> conflicts)
                                                        throws java.lang.Exception

Gets a full list of packages (encapsulated in Dependency objects) that are required by directly and indirectly by the named target package. Also builds a Map of any packages that are required by more than one package and where there is a conflict of some sort (e.g. multiple conflicting versions). The keys of this map are package names (strings), and each associated value is a list of Dependency objects.

Specified by:

getAllDependenciesForPackage in class PackageManager

Parameters:

target - the package for which a list of dependencies is required.

conflicts - will hold any conflicts that are discovered while building the full dependency list.

Returns:

a list of packages that are directly and indirectly required by the named target package.

Throws:

java.lang.Exception - if a problem occurs while building the dependency list.

installPackageFromRepository

public void installPackageFromRepository(java.lang.String packageName,
                                         java.lang.Object version,
                                         java.io.PrintStream... progress)
                                  throws java.lang.Exception

Install a package sourced from the repository.

Specified by:

installPackageFromRepository in class PackageManager

Parameters:

packageName - the name of the package to install

version - the version of the package to install (may be null if not applicable).

progress - optional varargs parameter, that, if supplied, is expected to contain one or more PrintStream objects to write progress to.

Throws:

java.lang.Exception - if the package can't be installed for some reason.

installPackageFromURL

public java.lang.String installPackageFromURL(java.net.URL packageURL,
                                              java.io.PrintStream... progress)
                                       throws java.lang.Exception

Install a package sourced from a given URL.

Specified by:

installPackageFromURL in class PackageManager

Parameters:

packageURL - the URL to the package.

progress - optional varargs parameter, that, if supplied, is expected to contain one or more PrintStream objects to write progress to.

Returns:

the name of the package installed

Throws:

java.lang.Exception - if the package can't be installed for some reason.

installPackage

protected void installPackage(java.lang.String packageArchivePath,
                              java.lang.String packageName,
                              java.io.PrintStream... progress)
                       throws java.lang.Exception

Installs a package from a zip/jar archive.

Parameters:

packageArchivePath - the full path to the archived package to install.

packageName - the name of the package to install.

progress - optional varargs parameter, that, if supplied, is expected to contain one or more PrintStream objects to write progress to.

Throws:

java.lang.Exception - if the package can't be installed for some reason.

getRepositoryPackageMetaDataOnlyAsZip

public byte[] getRepositoryPackageMetaDataOnlyAsZip(java.io.PrintStream... progress)
                                             throws java.lang.Exception

Gets an array of bytes containing a zip of all the repository meta data and supporting files. Does *not* contain any package archives etc., only a snapshot of the meta data. Could be used by clients to establish a cache of meta data.

Specified by:

getRepositoryPackageMetaDataOnlyAsZip in class PackageManager

Parameters:

progress - optional varargs parameter, that, if supplied, is expected to contain one or more PrintStream objects to write progress to.

Returns:

a zip compressed array of bytes.

Throws:

java.lang.Exception - if the repository meta data can't be returned as a zip

getRepositoryPackageMetaDataOnlyAsZipLegacy

public byte[] getRepositoryPackageMetaDataOnlyAsZipLegacy(java.io.PrintStream... progress)
                                                   throws java.lang.Exception

Gets an array of bytes containing a zip of all the repository meta data and supporting files using the legacy approach. Does *not* contain any package archives etc., only a snapshot of the meta data. Could be used by clients to establish a cache of meta data.

Returns:

a zip compressed array of bytes.

Throws:

java.lang.Exception

getAllPackages

public java.util.List<Package> getAllPackages(java.io.PrintStream... progress)
                                       throws java.lang.Exception

Get all packages that the system knows about (i.e. all packages contained in the repository).

Specified by:

getAllPackages in class PackageManager

Parameters:

progress - optional varargs parameter, that, if supplied is expected to contain one or more PrintStream objects to write progress to.

Returns:

a list of all packages.

Throws:

java.lang.Exception - if a list of packages can't be determined.

getAvailablePackages

public java.util.List<Package> getAvailablePackages()
                                             throws java.lang.Exception

Get a list of packages that are not currently installed.

Specified by:

getAvailablePackages in class PackageManager

Returns:

a list of packages that are not currently installed.

Throws:

java.lang.Exception - if a list of packages can't be determined.

getInstalledPackages

public java.util.List<Package> getInstalledPackages()
                                             throws java.lang.Exception

Get a list of installed packages.

Specified by:

getInstalledPackages in class PackageManager

Returns:

a list of installed packages.

Throws:

java.lang.Exception - if a list of packages can't be determined.

deleteInstalledPackageCacheFile

protected void deleteInstalledPackageCacheFile()
                                        throws java.lang.Exception

Throws:

java.lang.Exception

saveInstalledPackageCache

protected void saveInstalledPackageCache(java.util.List<Package> cacheToSave)
                                  throws java.lang.Exception

Save the supplied list of Packages to the installed package cache file

Parameters:

cacheToSave - the list of packages to save

Throws:

java.lang.Exception - if a problem occurs

loadInstalledPackageCache

protected java.util.List<Package> loadInstalledPackageCache()
                                                     throws java.lang.Exception

Load the serialized installed package cache file

Returns:

a list of installed packages (loaded from the cache file)

Throws:

java.lang.Exception - if a problem occurs

padLeft

protected static java.lang.String padLeft(java.lang.String inString,
                                          int length)

Pads a string to a specified length, inserting spaces on the left as required. If the string is too long, characters are removed (from the right).

Parameters:

inString - the input string

length - the desired length of the output string

Returns:

the output string

padRight

protected static java.lang.String padRight(java.lang.String inString,
                                           int length)

Pads a string to a specified length, inserting spaces on the right as required. If the string is too long, characters are removed (from the right).

Parameters:

inString - the input string

length - the desired length of the output string

Returns:

the output string

main

public static void main(java.lang.String[] args)