org.to2mbn.jmccc.mcdownloader.download

Class DownloadTask<T>

java.lang.Object

org.to2mbn.jmccc.mcdownloader.download.DownloadTask<T>

Type Parameters:

T - the type of result

Direct Known Subclasses:

FileDownloadTask, MemoryDownloadTask

public abstract class DownloadTask<T>
extends Object

Describes a download task.

A download task has the uri of resource to download, and the location to save, such as file, memory. The save location is handled by subclasses.

Author:

yushijinhun

Constructor Summary

Constructors

Constructor and Description
DownloadTask(String uri) Constructs a DownloadTask.
DownloadTask(URI uri) Constructs a DownloadTask.

Method Summary

Modifier and Type	Method and Description
<R> DownloadTask<R>	andThen(ResultProcessor<T,R> processor)
abstract DownloadSession<T>	createSession() Calls when the download task begins.
DownloadSession<T>	createSession(long length) Calls when the download task begins.
URI	getURI() Gets the uri of the resource to download.

Methods inherited from class java.lang.Object

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

Constructor Detail

DownloadTask

public DownloadTask(String uri)

Constructs a DownloadTask.

Parameters:

uri - the uri of resource to download

Throws:

NullPointerException - if uri==null

IllegalArgumentException - if uri is not in a valid URI format

DownloadTask

public DownloadTask(URI uri)

Constructs a DownloadTask.

Parameters:

uri - the uri of resource to download

Throws:

NullPointerException - if uri==null

Method Detail

getURI

public URI getURI()

Gets the uri of the resource to download.

Returns:

the uri of the resource to download

createSession

public abstract DownloadSession<T> createSession()
                                          throws IOException

Calls when the download task begins.

Returns:

a new download session

Throws:

IOException - if an I/O error occurs

createSession

public DownloadSession<T> createSession(long length)
                                 throws IOException

Calls when the download task begins.

Parameters:

length - the possible length of data

Returns:

a new download session

Throws:

IOException - if an I/O error occurs

andThen

public <R> DownloadTask<R> andThen(ResultProcessor<T,R> processor)