org.codehaus.cargo.container.installer

Class ZipURLInstaller

java.lang.Object

org.codehaus.cargo.util.log.LoggedObject

org.codehaus.cargo.container.installer.ZipURLInstaller

All Implemented Interfaces:

Installer, Loggable

public class ZipURLInstaller
extends LoggedObject
implements Installer

Installs a zipped container file from a URL to a location on your local disk.

Version:

$Id: ZipURLInstaller.java 3438 2012-10-09 11:03:13Z dnowicki $

Constructor Summary

Constructors

Constructor and Description
ZipURLInstaller(URL remoteLocation)
ZipURLInstaller(URL remoteLocation, String downloadDir, String extractDir)

Method Summary

Methods

Modifier and Type	Method and Description
void	download() Downloads the zip file containing the container files.
String	getDownloadDir()
String	getDownloadFile()
String	getExtractDir()
FileHandler	getFileHandler()
String	getHome()
protected String	getSourceFileName()
void	install() Installs the container.
boolean	isAlreadyDownloaded()
boolean	isAlreadyExtracted()
void	registerInstallation() Create timestamp file to register that the installation has been successful.
protected void	setAntTaskFactory(AntTaskFactory antTaskFactory) Convenience method used for testing in isolation.
void	setDownloadDir(String downloadDir)
void	setExtractDir(String extractDir)
void	setFileHandler(FileHandler fileHandler)
void	setProxy(Proxy proxy) Sets proxy details.

Methods inherited from class org.codehaus.cargo.util.log.LoggedObject

getLogger, setLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.codehaus.cargo.util.log.Loggable

getLogger, setLogger

Constructor Detail

ZipURLInstaller

public ZipURLInstaller(URL remoteLocation)

Parameters:

remoteLocation - URL where the zipped container is located

ZipURLInstaller

public ZipURLInstaller(URL remoteLocation,
               String downloadDir,
               String extractDir)

Parameters:

remoteLocation - URL where the zipped container is located

downloadDir - directory where the zipped container install will be downloaded.

extractDir - directory where the zipped container install will be extracted.

Method Detail

setDownloadDir

public void setDownloadDir(String downloadDir)

Parameters:

downloadDir - the destination directory where the zipped container install will be downloaded.

setExtractDir

public void setExtractDir(String extractDir)

Parameters:

extractDir - the destination directory where the zipped container install will be installed.

getDownloadDir

public String getDownloadDir()

Returns:

The destination directory where the zipped container install will be downloaded.

getDownloadFile

public String getDownloadFile()

Returns:

The destination file where the zipped container install will be downloaded.

getExtractDir

public String getExtractDir()

Returns:

The destination directory where the zipped container install will be extracted.

setAntTaskFactory

protected void setAntTaskFactory(AntTaskFactory antTaskFactory)

Convenience method used for testing in isolation. Test cases can use it for introducing a custom AntTaskFactory that returns a custom test-made Ant task.

Parameters:

antTaskFactory - the test-provided AntTaskFactory

getFileHandler

public FileHandler getFileHandler()

Returns:

the file utility class to use for performing all file I/O.

setFileHandler

public void setFileHandler(FileHandler fileHandler)

Parameters:

fileHandler - the file utility class to use for performing all file I/O.

install

public void install()

Description copied from interface: Installer

Installs the container.

Specified by:

install in interface Installer

See Also:

Installer.install()

registerInstallation

public void registerInstallation()

Create timestamp file to register that the installation has been successful. This allows to prevent installing again next time. If the remote URL changes, then the container will be reinstalled.

isAlreadyDownloaded

public boolean isAlreadyDownloaded()

Returns:

true if the container has already been downloaded, false otherwise

isAlreadyExtracted

public boolean isAlreadyExtracted()

Returns:

true if the container has already been extracted, false otherwise

getHome

public String getHome()

Specified by:

getHome in interface Installer

Returns:

the directory where the container has been installed. Note that we're returning a String instead of a File because we want to leave the possibility of using URIs for specifying the home location.

See Also:

Installer.getHome()

download

public void download()

Downloads the zip file containing the container files.

getSourceFileName

protected String getSourceFileName()

Returns:

the name of the source zip file (without the path)

setProxy

public void setProxy(Proxy proxy)

Sets proxy details.

Parameters:

proxy - the proxy configuration to set