Get (Apache Ant API)

org.apache.tools.ant.taskdefs
Class Get

java.lang.Object

  |

  +--org.apache.tools.ant.ProjectComponent

        |

        +--org.apache.tools.ant.Task

              |

              +--org.apache.tools.ant.taskdefs.Get

public class Get

extends Task

Gets a particular file from a URL source. Options include verbose reporting, timestamp based fetches and controlling actions on failures. NB: access through a firewall only works if the whole Java runtime is correctly configured.

Since:

Ant 1.1

Author:

costin@dnt.ro

, gg@grtmail.com (Added Java 1.1 style HTTP basic auth)

Field Summary

Fields inherited from class org.apache.tools.ant.Task

description, location, target, taskName, taskType, wrapper

Fields inherited from class org.apache.tools.ant.ProjectComponent

project

Constructor Summary

Get()

Method Summary

void	execute() Does the work.
void	setDest(java.io.File dest) Where to copy the source file.
void	setIgnoreErrors(boolean v) If true, log errors but do not treat as fatal.
void	setPassword(java.lang.String p) password for the basic authentication.
void	setSrc(java.net.URL u) Set the URL to get.
void	setUsername(java.lang.String u) Username for basic auth.
void	setUseTimestamp(boolean v) If true, conditionally download a file based on the timestamp of the local copy.
void	setVerbose(boolean v) If true, show verbose progress information.

Methods inherited from class org.apache.tools.ant.Task

getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, handleErrorOutput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName

Methods inherited from class org.apache.tools.ant.ProjectComponent

getProject, setProject

Methods inherited from class java.lang.Object

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

Constructor Detail

Get

public Get()

Method Detail

execute

public void execute()
             throws BuildException

Does the work.

Overrides:

execute in class Task

Throws:

BuildException - Thrown in unrecoverable error.

setSrc

public void setSrc(java.net.URL u)

Set the URL to get.

Parameters:

u - URL for the file.

setDest

public void setDest(java.io.File dest)

Where to copy the source file.

Parameters:

dest - Path to file.

setVerbose

public void setVerbose(boolean v)

If true, show verbose progress information.

Parameters:

v - if "true" then be verbose

setIgnoreErrors

public void setIgnoreErrors(boolean v)

If true, log errors but do not treat as fatal.

Parameters:

v - if "true" then don't report download errors up to ant

setUseTimestamp

public void setUseTimestamp(boolean v)

If true, conditionally download a file based on the timestamp of the local copy.

In this situation, the if-modified-since header is set so that the file is only fetched if it is newer than the local file (or there is no local file) This flag is only valid on HTTP connections, it is ignored in other cases. When the flag is set, the local copy of the downloaded file will also have its timestamp set to the remote file time.

Note that remote files of date 1/1/1970 (GMT) are treated as 'no timestamp', and web servers often serve files with a timestamp in the future by replacing their timestamp with that of the current time. Also, inter-computer clock differences can cause no end of grief.

Parameters:

v - "true" to enable file time fetching

setUsername

public void setUsername(java.lang.String u)

Username for basic auth.

Parameters:

u - username for authentication

setPassword

public void setPassword(java.lang.String p)

password for the basic authentication.

Parameters:

p - password for authentication