de.undercouch.gradle.tasks.download

Class Download

java.lang.Object

org.gradle.api.internal.AbstractTask

org.gradle.api.DefaultTask

de.undercouch.gradle.tasks.download.Download

All Implemented Interfaces:

DownloadSpec, java.lang.Comparable<org.gradle.api.Task>, org.gradle.api.internal.DynamicObjectAware, org.gradle.api.internal.TaskInternal, org.gradle.api.plugins.ExtensionAware, org.gradle.api.Task, org.gradle.util.Configurable<org.gradle.api.Task>

public class Download
extends org.gradle.api.DefaultTask
implements DownloadSpec

Downloads a file and displays progress. Example:

 task downloadFile(type: Download) {
     src 'http://www.example.com/file.ext'
     dest buildDir
 }
 

Nested Class Summary

Nested classes/interfaces inherited from interface org.gradle.api.Task

org.gradle.api.Task.Namer

Field Summary

Fields inherited from interface org.gradle.api.Task

TASK_ACTION, TASK_DEPENDS_ON, TASK_DESCRIPTION, TASK_GROUP, TASK_NAME, TASK_OVERWRITE, TASK_TYPE

Constructor Summary

Constructors

Constructor and Description
Download() Default constructor

Method Summary

Modifier and Type	Method and Description
void	acceptAnyCertificate(boolean accept) Specifies if HTTPS certificate verification errors should be ignored and any certificate (even an invalid one) should be accepted.
void	compress(boolean compress) Specifies if compression should be used during download
void	dest(java.lang.Object dest) Sets the download destination
void	download() Starts downloading
java.io.File	getDest()
java.lang.String	getHeader(java.lang.String name)
java.util.Map<java.lang.String,java.lang.String>	getHeaders()
java.util.List<java.io.File>	getOutputFiles()
java.lang.String	getPassword()
java.lang.Object	getSrc()
java.lang.String	getUsername()
void	header(java.lang.String name, java.lang.String value) Sets an HTTP request header to use when downloading
void	headers(java.util.Map<java.lang.String,java.lang.String> headers) Sets the HTTP request headers to us when downloading
boolean	isAcceptAnyCertificate()
boolean	isCompress()
boolean	isOnlyIfNewer()
boolean	isOverwrite()
boolean	isQuiet()
void	onlyIfNewer(boolean onlyIfNewer) Sets the onlyIfNewer flag
void	overwrite(boolean overwrite) Sets the overwrite flag
void	password(java.lang.String password) Sets the password for Basic authentication
void	quiet(boolean quiet) Sets the quiet flag
void	src(java.lang.Object src) Sets the download source URL
void	username(java.lang.String username) Sets the username for Basic authentication

Methods inherited from class org.gradle.api.internal.AbstractTask

addValidator, appendParallelSafeAction, compareTo, configure, deleteAllActions, dependsOn, dependsOnTaskDidWork, doFirst, doFirst, doLast, doLast, execute, finalizedBy, getActions, getAnt, getAsDynamicObject, getConvention, getDependsOn, getDescription, getDidWork, getEnabled, getExecuter, getExtensions, getFinalizedBy, getGroup, getImpliesSubProjects, getInputs, getLogger, getLogging, getMustRunAfter, getName, getOnlyIf, getOutputs, getPath, getProject, getServices, getShouldRunAfter, getStandardOutputCapture, getState, getTaskActions, getTaskDependencies, getTemporaryDir, getTemporaryDirFactory, getValidators, hasProperty, injectIntoNewInstance, isEnabled, isHasCustomActions, leftShift, mustRunAfter, onlyIf, onlyIf, prependParallelSafeAction, property, setActions, setDependsOn, setDescription, setDidWork, setEnabled, setExecuter, setFinalizedBy, setGroup, setImpliesSubProjects, setMustRunAfter, setName, setOnlyIf, setOnlyIf, setProject, setProperty, setShouldRunAfter, shouldRunAfter, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

Download

public Download()

Default constructor

Method Detail

download

public void download()
              throws java.io.IOException

Starts downloading

Throws:

java.io.IOException - if the file could not downloaded

getOutputFiles

@OutputFiles
public java.util.List<java.io.File> getOutputFiles()

src

public void src(java.lang.Object src)
         throws java.net.MalformedURLException

Description copied from interface: DownloadSpec

Sets the download source URL

Specified by:

src in interface DownloadSpec

Parameters:

src - the URL

Throws:

java.net.MalformedURLException - if the download source is not a URL

dest

public void dest(java.lang.Object dest)

Description copied from interface: DownloadSpec

Sets the download destination

Specified by:

dest in interface DownloadSpec

Parameters:

dest - a file or directory where to store the retrieved file

quiet

public void quiet(boolean quiet)

Description copied from interface: DownloadSpec

Sets the quiet flag

Specified by:

quiet in interface DownloadSpec

Parameters:

quiet - true if download progress should not be logged

overwrite

public void overwrite(boolean overwrite)

Description copied from interface: DownloadSpec

Sets the overwrite flag

Specified by:

overwrite in interface DownloadSpec

Parameters:

overwrite - true if existing files should be overwritten, false otherwise

onlyIfNewer

public void onlyIfNewer(boolean onlyIfNewer)

Description copied from interface: DownloadSpec

Sets the onlyIfNewer flag

Specified by:

onlyIfNewer in interface DownloadSpec

Parameters:

onlyIfNewer - true if the file should only be downloaded if it has been modified on the server since the last download

compress

public void compress(boolean compress)

Description copied from interface: DownloadSpec

Specifies if compression should be used during download

Specified by:

compress in interface DownloadSpec

Parameters:

compress - true if compression should be enabled

username

public void username(java.lang.String username)

Description copied from interface: DownloadSpec

Sets the username for Basic authentication

Specified by:

username in interface DownloadSpec

Parameters:

username - the username

password

public void password(java.lang.String password)

Description copied from interface: DownloadSpec

Sets the password for Basic authentication

Specified by:

password in interface DownloadSpec

Parameters:

password - the password

headers

public void headers(java.util.Map<java.lang.String,java.lang.String> headers)

Description copied from interface: DownloadSpec

Sets the HTTP request headers to us when downloading

Specified by:

headers in interface DownloadSpec

Parameters:

headers - a Map of header names to values

header

public void header(java.lang.String name,
                   java.lang.String value)

Description copied from interface: DownloadSpec

Sets an HTTP request header to use when downloading

Specified by:

header in interface DownloadSpec

Parameters:

name - name of the HTTP header

value - value of the HTTP header

acceptAnyCertificate

public void acceptAnyCertificate(boolean accept)

Description copied from interface: DownloadSpec

Specifies if HTTPS certificate verification errors should be ignored and any certificate (even an invalid one) should be accepted. By default certificates are validated and errors are not being ignored.

Specified by:

acceptAnyCertificate in interface DownloadSpec

Parameters:

accept - true if certificate errors should be ignored (default: false)

getSrc

public java.lang.Object getSrc()

Specified by:

getSrc in interface DownloadSpec

Returns:

the download source(s), either a URL or a list of URLs

getDest

public java.io.File getDest()

Specified by:

getDest in interface DownloadSpec

Returns:

the download destination

isQuiet

public boolean isQuiet()

Specified by:

isQuiet in interface DownloadSpec

Returns:

the quiet flag

isOverwrite

public boolean isOverwrite()

Specified by:

isOverwrite in interface DownloadSpec

Returns:

the overwrite flag

isOnlyIfNewer

public boolean isOnlyIfNewer()

Specified by:

isOnlyIfNewer in interface DownloadSpec

Returns:

the onlyIfNewer flag

isCompress

public boolean isCompress()

Specified by:

isCompress in interface DownloadSpec

Returns:

true if compression is enabled

getUsername

public java.lang.String getUsername()

Specified by:

getUsername in interface DownloadSpec

Returns:

the username for Basic authentication

getPassword

public java.lang.String getPassword()

Specified by:

getPassword in interface DownloadSpec

Returns:

the password for Basic authentication

getHeaders

public java.util.Map<java.lang.String,java.lang.String> getHeaders()

Specified by:

getHeaders in interface DownloadSpec

Returns:

the HTTP request headers to use when downloading

getHeader

public java.lang.String getHeader(java.lang.String name)

Specified by:

getHeader in interface DownloadSpec

Parameters:

name - name of the HTTP header

Returns:

the value of the HTTP header

isAcceptAnyCertificate

public boolean isAcceptAnyCertificate()

Specified by:

isAcceptAnyCertificate in interface DownloadSpec

Returns:

true if HTTPS certificate verification errors should be ignored, default value is false