com.weebly.opus1269.clipman.backup

Class BackupHelper

java.lang.Object

com.weebly.opus1269.clipman.backup.BackupHelper

public class BackupHelper
extends java.lang.Object

Singleton to manage Google Drive data backups

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	BACKUP_FILNAME Name of file in the zipfile
private android.content.Context	mContext Global Application Context
private static BackupHelper	sInstance
private java.lang.String	TAG Class Indentifier

Constructor Summary

Constructors

Modifier	Constructor and Description
private	BackupHelper(android.content.Context context)

Method Summary

Modifier and Type	Method and Description
void	createBackupAsync() Create a backup on Drive
private byte[]	createZipContents(byte[] data) Create the contents of a Zip file as a byte array
private byte[]	createZipContentsFromDB() Create the contents of a Zip file from the database
void	deleteBackupAsync(Backup backup) Delete a backup
private void	deleteLastBackup() Try to delete the last backup
(package private) void	extractFromZipFile(java.io.BufferedInputStream bis, BackupContents contents) Extract the data from a ZipFile into a BackupContents
void	getBackupsAsync() Get the list of backups from Drive
private java.lang.String	getZipFilename() Get name of backup file
static BackupHelper	INST(android.content.Context context) Lazily create our instance
private void	replaceDB(BackupContents contents) Replace the contents of the database
void	restoreBackupAsync(Backup backup) Restore the contents of a backup to the database
private void	saveContentsToDB(BackupContents contents) Replace the database with the restored data
private BackupContents	saveMergedContentsToDB(BackupContents contents) Replace the database with a merge of the given data
private void	showMessage(java.lang.String msg, java.lang.Exception ex) Log exception and show message
void	syncContentsAsync(Backup backup) Synchronize the contents of a backup and the database

Methods inherited from class java.lang.Object

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

Field Detail

sInstance

private static BackupHelper sInstance

mContext

private final android.content.Context mContext

Global Application Context

TAG

private final java.lang.String TAG

Class Indentifier

BACKUP_FILNAME

private final java.lang.String BACKUP_FILNAME

Name of file in the zipfile

See Also:

Constant Field Values

Constructor Detail

BackupHelper

private BackupHelper(@NonNull
                     android.content.Context context)

Method Detail

INST

public static BackupHelper INST(@NonNull
                                android.content.Context context)

Lazily create our instance

Parameters:

context - any old context

getBackupsAsync

public void getBackupsAsync()

Get the list of backups from Drive

createBackupAsync

public void createBackupAsync()

Create a backup on Drive

restoreBackupAsync

public void restoreBackupAsync(Backup backup)

Restore the contents of a backup to the database

Parameters:

backup - File to restore

syncContentsAsync

public void syncContentsAsync(Backup backup)

Synchronize the contents of a backup and the database

Parameters:

backup - File to sync with

deleteBackupAsync

public void deleteBackupAsync(@NonNull
                              Backup backup)

Delete a backup

Parameters:

backup - File to delete

saveContentsToDB

private void saveContentsToDB(@Nullable
                              BackupContents contents)
                       throws java.io.IOException,
                              android.database.SQLException

Replace the database with the restored data

Parameters:

contents - database data to restore

Throws:

java.io.IOException - if no contents

android.database.SQLException - if database update failed

saveMergedContentsToDB

private BackupContents saveMergedContentsToDB(@Nullable
                                              BackupContents contents)
                                       throws java.io.IOException,
                                              android.database.SQLException

Replace the database with a merge of the given data

Parameters:

contents - data to merge with db

Returns:

merged contents

Throws:

java.io.IOException - if no contents

android.database.SQLException - if database update failed

createZipContentsFromDB

private byte[] createZipContentsFromDB()
                                throws java.io.IOException

Create the contents of a Zip file from the database

Returns:

zip file contents

Throws:

java.io.IOException - on processing data

createZipContents

private byte[] createZipContents(@NonNull
                                 byte[] data)
                          throws java.io.IOException

Create the contents of a Zip file as a byte array

Parameters:

data - contents of zip file

Returns:

zip file contents

Throws:

java.io.IOException - if no contents

extractFromZipFile

void extractFromZipFile(@NonNull
                        java.io.BufferedInputStream bis,
                        @NonNull
                        BackupContents contents)

Extract the data from a ZipFile into a BackupContents

Parameters:

bis - stream of data

contents - will contain the contents

deleteLastBackup

private void deleteLastBackup()

Try to delete the last backup

replaceDB

private void replaceDB(@NonNull
                       BackupContents contents)
                throws android.database.SQLException

Replace the contents of the database

Parameters:

contents - new contents

Throws:

android.database.SQLException - - if database update failed

getZipFilename

@NonNull
private java.lang.String getZipFilename()

Get name of backup file

Returns:

.zip filename

showMessage

private void showMessage(@NonNull
                         java.lang.String msg,
                         @NonNull
                         java.lang.Exception ex)

Log exception and show message

Parameters:

msg - message

ex - exception