com.liulishuo.filedownloader.database

Class SqliteDatabaseImpl

java.lang.Object

com.liulishuo.filedownloader.database.SqliteDatabaseImpl

All Implemented Interfaces:

FileDownloadDatabase

public class SqliteDatabaseImpl
extends Object
implements FileDownloadDatabase

Persist data to SQLite database. You can valid this database implementation through:

class MyApplication extends Application { ... public void onCreate() { ... FileDownloader.setupOnApplicationOnCreate(this) .database(SqliteDatabaseImpl.createMaker()) ... .commit(); ... } ... }

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	SqliteDatabaseImpl.Maintainer
static class	SqliteDatabaseImpl.Maker

Field Summary

Fields

Modifier and Type	Field and Description
static String	CONNECTION_TABLE_NAME
static String	TABLE_NAME

Constructor Summary

Constructors

Constructor and Description
SqliteDatabaseImpl()

Method Summary

Modifier and Type	Method and Description
void	clear() Clear all models in this database.
static SqliteDatabaseImpl.Maker	createMaker()
FileDownloadModel	find(int id) Find the model which identify is id.
List<ConnectionModel>	findConnectionModel(int id) Find the connection model which download identify is id
void	insert(FileDownloadModel downloadModel) Insert the model to the database.
void	insertConnectionModel(ConnectionModel model) Insert the model to connection table.
FileDownloadDatabase.Maintainer	maintainer() Get the maintainer for the database, this maintainer will be used when the database is initializing.
FileDownloadDatabase.Maintainer	maintainer(SparseArray<FileDownloadModel> downloaderModelMap, SparseArray<List<ConnectionModel>> connectionModelListMap)
void	onTaskStart(int id) Invoked when task is started.
boolean	remove(int id) Remove the model which identify is id.
void	removeConnections(int id) Delete all connection model store on database through the download id.
void	update(FileDownloadModel downloadModel) Update the data compare to the downloadModel
void	updateCompleted(int id, long total) Update the data because of the download status alternative to FileDownloadStatus.completed.
void	updateConnected(int id, long total, String etag, String filename) Update the data because of the download status alternative to FileDownloadStatus.connected.
void	updateConnectionCount(int id, int count) Update the count of connection.
void	updateConnectionModel(int id, int index, long currentOffset) Update the currentOffset with currentOffset which id is id, index is index
void	updateError(int id, Throwable throwable, long sofar) Update the data because of the download status alternative to FileDownloadStatus.error.
void	updateOldEtagOverdue(int id, String newEtag, long sofar, long total, int connectionCount) Update when the old one is overdue.
void	updatePause(int id, long sofar) Update the data because of the download status alternative to FileDownloadStatus.paused.
void	updatePending(int id) Update the data because of the download status alternative to FileDownloadStatus.pending.
void	updateProgress(int id, long sofarBytes) Update the sofar bytes with the status progress, so don't forget to store the FileDownloadStatus.progress too.
void	updateRetry(int id, Throwable throwable) Update the data because of the download status alternative to FileDownloadStatus.retry.

Methods inherited from class java.lang.Object

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

Field Detail

TABLE_NAME

public static final String TABLE_NAME

See Also:

Constant Field Values

CONNECTION_TABLE_NAME

public static final String CONNECTION_TABLE_NAME

See Also:

Constant Field Values

Constructor Detail

SqliteDatabaseImpl

public SqliteDatabaseImpl()

Method Detail

createMaker

public static SqliteDatabaseImpl.Maker createMaker()

onTaskStart

public void onTaskStart(int id)

Description copied from interface: FileDownloadDatabase

Invoked when task is started.

Specified by:

onTaskStart in interface FileDownloadDatabase

Parameters:

id - the download id.

find

public FileDownloadModel find(int id)

Description copied from interface: FileDownloadDatabase

Find the model which identify is id.

Specified by:

find in interface FileDownloadDatabase

Parameters:

id - the download id.

findConnectionModel

public List<ConnectionModel> findConnectionModel(int id)

Description copied from interface: FileDownloadDatabase

Find the connection model which download identify is id

Specified by:

findConnectionModel in interface FileDownloadDatabase

Parameters:

id - the download id.

removeConnections

public void removeConnections(int id)

Description copied from interface: FileDownloadDatabase

Delete all connection model store on database through the download id.

Specified by:

removeConnections in interface FileDownloadDatabase

Parameters:

id - the download id.

insertConnectionModel

public void insertConnectionModel(ConnectionModel model)

Description copied from interface: FileDownloadDatabase

Insert the model to connection table.

Specified by:

insertConnectionModel in interface FileDownloadDatabase

Parameters:

model - the connection model.

updateConnectionModel

public void updateConnectionModel(int id,
                                  int index,
                                  long currentOffset)

Description copied from interface: FileDownloadDatabase

Update the currentOffset with currentOffset which id is id, index is index

Specified by:

updateConnectionModel in interface FileDownloadDatabase

Parameters:

id - the download id.

index - the connection index.

currentOffset - the current offset.

updateConnectionCount

public void updateConnectionCount(int id,
                                  int count)

Description copied from interface: FileDownloadDatabase

Update the count of connection.

Specified by:

updateConnectionCount in interface FileDownloadDatabase

count - the connection count.

insert

public void insert(FileDownloadModel downloadModel)

Description copied from interface: FileDownloadDatabase

Insert the model to the database.

Specified by:

insert in interface FileDownloadDatabase

Parameters:

downloadModel - the download model.

update

public void update(FileDownloadModel downloadModel)

Description copied from interface: FileDownloadDatabase

Update the data compare to the downloadModel

Specified by:

update in interface FileDownloadDatabase

Parameters:

downloadModel - the download model.

remove

public boolean remove(int id)

Description copied from interface: FileDownloadDatabase

Remove the model which identify is id.

Specified by:

remove in interface FileDownloadDatabase

Parameters:

id - the download id.

Returns:

true if succeed to remove model from the database.

clear

public void clear()

Description copied from interface: FileDownloadDatabase

Clear all models in this database.

Specified by:

clear in interface FileDownloadDatabase

updateOldEtagOverdue

public void updateOldEtagOverdue(int id,
                                 String newEtag,
                                 long sofar,
                                 long total,
                                 int connectionCount)

Description copied from interface: FileDownloadDatabase

Update when the old one is overdue.

Specified by:

updateOldEtagOverdue in interface FileDownloadDatabase

updateConnected

public void updateConnected(int id,
                            long total,
                            String etag,
                            String filename)

Description copied from interface: FileDownloadDatabase

Update the data because of the download status alternative to FileDownloadStatus.connected.

Specified by:

updateConnected in interface FileDownloadDatabase

Parameters:

id - the download id.

total - the new total bytes.

etag - the new etag. this value will be null when we can't find it on response header.

filename - the new file name. this value will be null when its no need to store.

updateProgress

public void updateProgress(int id,
                           long sofarBytes)

Description copied from interface: FileDownloadDatabase

Update the sofar bytes with the status progress, so don't forget to store the FileDownloadStatus.progress too.

Specified by:

updateProgress in interface FileDownloadDatabase

sofarBytes - the current sofar bytes.

updateError

public void updateError(int id,
                        Throwable throwable,
                        long sofar)

Description copied from interface: FileDownloadDatabase

Update the data because of the download status alternative to FileDownloadStatus.error.

Specified by:

updateError in interface FileDownloadDatabase

Parameters:

id - the download id.

throwable - the new exception.

sofar - the new so far bytes.

updateRetry

public void updateRetry(int id,
                        Throwable throwable)

Description copied from interface: FileDownloadDatabase

Update the data because of the download status alternative to FileDownloadStatus.retry.

Specified by:

updateRetry in interface FileDownloadDatabase

Parameters:

id - the download id.

throwable - the new exception.

updateCompleted

public void updateCompleted(int id,
                            long total)

Description copied from interface: FileDownloadDatabase

Update the data because of the download status alternative to FileDownloadStatus.completed. The latest version will remove model from DB.

Specified by:

updateCompleted in interface FileDownloadDatabase

Parameters:

id - the download id.

total - the new total bytes.

updatePause

public void updatePause(int id,
                        long sofar)

Description copied from interface: FileDownloadDatabase

Update the data because of the download status alternative to FileDownloadStatus.paused.

Specified by:

updatePause in interface FileDownloadDatabase

Parameters:

id - the download id.

sofar - the new so far bytes.

updatePending

public void updatePending(int id)

Description copied from interface: FileDownloadDatabase

Update the data because of the download status alternative to FileDownloadStatus.pending.

Specified by:

updatePending in interface FileDownloadDatabase

Parameters:

id - the download id.

maintainer

public FileDownloadDatabase.Maintainer maintainer()

Description copied from interface: FileDownloadDatabase

Get the maintainer for the database, this maintainer will be used when the database is initializing.

The maintainer will return all data on the database.

Demo: SqliteDatabaseImpl.Maintainer

Specified by:

maintainer in interface FileDownloadDatabase

Returns:

the maintainer for maintain the database.

maintainer

public FileDownloadDatabase.Maintainer maintainer(SparseArray<FileDownloadModel> downloaderModelMap,
                                                  SparseArray<List<ConnectionModel>> connectionModelListMap)