pw.prok.download

Interface DownloadSpec

All Known Implementing Classes:

Download, DownloadAction

public interface DownloadSpec

An interface for classes that perform file downloads

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	cache(long amount, java.util.concurrent.TimeUnit unit) Sets minimal time of caching
void	compress(boolean compress) Specifies if compression should be used during download
void	dest(java.lang.Object dest) Sets the download destination
long	getCache()
java.io.File	getDest()
java.lang.String	getHeader(java.lang.String name)
java.util.Map<java.lang.String,java.lang.String>	getHeaders()
int	getMaxDownloadThreads()
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	maxDownloadThreads(int maxDownloadThreads) Sets maximal amount of parallel downloads
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

Method Detail

src

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

Sets the download source URL

Parameters:

src - the URL

Throws:

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

dest

void dest(java.lang.Object dest)

Sets the download destination

Parameters:

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

quiet

void quiet(boolean quiet)

Sets the quiet flag

Parameters:

quiet - true if download progress should not be logged

overwrite

void overwrite(boolean overwrite)

Sets the overwrite flag

Parameters:

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

onlyIfNewer

void onlyIfNewer(boolean onlyIfNewer)

Sets the onlyIfNewer flag

Parameters:

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

compress

void compress(boolean compress)

Specifies if compression should be used during download

Parameters:

compress - true if compression should be enabled

username

void username(java.lang.String username)

Sets the username for Basic authentication

Parameters:

username - the username

password

void password(java.lang.String password)

Sets the password for Basic authentication

Parameters:

password - the password

headers

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

Sets the HTTP request headers to us when downloading

Parameters:

headers - a Map of header names to values

header

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

Sets an HTTP request header to use when downloading

Parameters:

name - name of the HTTP header

value - value of the HTTP header

acceptAnyCertificate

void acceptAnyCertificate(boolean accept)

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.

Parameters:

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

cache

void cache(long amount,
           java.util.concurrent.TimeUnit unit)

Sets minimal time of caching

Parameters:

amount - cache time amount

unit - cache time unit

maxDownloadThreads

void maxDownloadThreads(int maxDownloadThreads)

Sets maximal amount of parallel downloads

Parameters:

maxDownloadThreads - amount of parallel downloads

getSrc

java.lang.Object getSrc()

Returns:

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

getDest

java.io.File getDest()

Returns:

the download destination

isQuiet

boolean isQuiet()

Returns:

the quiet flag

isOverwrite

boolean isOverwrite()

Returns:

the overwrite flag

isOnlyIfNewer

boolean isOnlyIfNewer()

Returns:

the onlyIfNewer flag

isCompress

boolean isCompress()

Returns:

true if compression is enabled

getUsername

java.lang.String getUsername()

Returns:

the username for Basic authentication

getPassword

java.lang.String getPassword()

Returns:

the password for Basic authentication

getHeaders

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

Returns:

the HTTP request headers to use when downloading

getHeader

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

Parameters:

name - name of the HTTP header

Returns:

the value of the HTTP header

isAcceptAnyCertificate

boolean isAcceptAnyCertificate()

Returns:

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

getCache

long getCache()

Returns:

minimal cache time in millis

getMaxDownloadThreads

int getMaxDownloadThreads()

Returns:

max amount of parallel downloads