/// <summary>
/// Initializes the backup.
/// </summary>
/// <param name="sqlbase">The base SQLite object.</param>
/// <param name="backup">The backup handle.</param>
/// <param name="destDb">The destination database for the backup.</param>
/// <param name="zDestName">The destination database name for the backup.</param>
/// <param name="sourceDb">The source database for the backup.</param>
/// <param name="zSourceName">The source database name for the backup.</param>
internal SQLiteBackup(
SQLiteBase sqlbase,
SQLiteBackupHandle backup,
IntPtr destDb,
byte[] zDestName,
IntPtr sourceDb,
byte[] zSourceName
)
{
_sql = sqlbase;
_sqlite_backup = backup;
_destDb = destDb;
_zDestName = zDestName;
_sourceDb = sourceDb;
_zSourceName = zSourceName;
}
///////////////////////////////////////////////////////////////////////////////////////////////
private void Dispose(bool disposing)
{
if (!disposed)
{
if (disposing)
{
////////////////////////////////////
// dispose managed resources here...
////////////////////////////////////
if (_sqlite_backup != null)
{
_sqlite_backup.Dispose();
_sqlite_backup = null;
}
_zSourceName = null;
_sourceDb = IntPtr.Zero;
_zDestName = null;
_destDb = IntPtr.Zero;
_sql = null;
}
//////////////////////////////////////
// release unmanaged resources here...
//////////////////////////////////////
disposed = true;
}
}
internal static void FinishBackup(SQLiteBackupHandle backup)
{
lock (_lock)
{
int n = UnsafeNativeMethods.sqlite3_backup_finish(backup);
backup.SetHandleAsInvalid();
if (n > 0) throw new SQLiteException(n, null);
}
}
///////////////////////////////////////////////////////////////////////////////////////////////
/// <summary>
/// Creates a new SQLite backup object based on the provided destination
/// database connection. The source database connection is the one
/// associated with this object. The source and destination database
/// connections cannot be the same.
/// </summary>
/// <param name="destCnn">The destination database connection.</param>
/// <param name="destName">The destination database name.</param>
/// <param name="sourceName">The source database name.</param>
/// <returns>The newly created backup object.</returns>
internal override SQLiteBackup InitializeBackup(
SQLiteConnection destCnn,
string destName,
string sourceName
)
{
if (destCnn == null)
throw new ArgumentNullException("destCnn");
if (destName == null)
throw new ArgumentNullException("destName");
if (sourceName == null)
throw new ArgumentNullException("sourceName");
SQLite3 destSqlite3 = destCnn._sql as SQLite3;
if (destSqlite3 == null)
throw new ArgumentException(
"Destination connection has no wrapper.",
"destCnn");
SQLiteConnectionHandle destHandle = destSqlite3._sql;
if (destHandle == null)
throw new ArgumentException(
"Destination connection has an invalid handle.",
"destCnn");
SQLiteConnectionHandle sourceHandle = _sql;
if (sourceHandle == null)
throw new InvalidOperationException(
"Source connection has an invalid handle.");
byte[] zDestName = ToUTF8(destName);
byte[] zSourceName = ToUTF8(sourceName);
SQLiteBackupHandle backupHandle = null;
try
{
// do nothing.
}
finally /* NOTE: Thread.Abort() protection. */
{
IntPtr backup = UnsafeNativeMethods.sqlite3_backup_init(
destHandle, zDestName, sourceHandle, zSourceName);
if (backup == IntPtr.Zero)
throw new SQLiteException(ResultCode(), GetLastError());
backupHandle = new SQLiteBackupHandle(destHandle, backup);
}
return new SQLiteBackup(
this, backupHandle, destHandle, zDestName, sourceHandle,
zSourceName);
}
///////////////////////////////////////////////////////////////////////////////////////////////
/// <summary>
/// Creates a new SQLite backup object based on the provided destination
/// database connection. The source database connection is the one
/// associated with this object. The source and destination database
/// connections cannot be the same.
/// </summary>
/// <param name="destCnn">The destination database connection.</param>
/// <param name="destName">The destination database name.</param>
/// <param name="sourceName">The source database name.</param>
/// <returns>The newly created backup object.</returns>
internal override SQLiteBackup InitializeBackup(
SQLiteConnection destCnn,
string destName,
string sourceName
)
{
if (destCnn == null)
throw new ArgumentNullException("destCnn");
if (destName == null)
throw new ArgumentNullException("destName");
if (sourceName == null)
throw new ArgumentNullException("sourceName");
SQLite3 destSqlite3 = destCnn._sql as SQLite3;
if (destSqlite3 == null)
throw new ArgumentException(
"Destination connection has no wrapper.",
"destCnn");
SQLiteConnectionHandle destHandle = destSqlite3._sql;
if (destHandle == null)
throw new ArgumentException(
"Destination connection has an invalid handle.",
"destCnn");
SQLiteConnectionHandle sourceHandle = _sql;
if (sourceHandle == null)
throw new InvalidOperationException(
"Source connection has an invalid handle.");
byte[] zDestName = ToUTF8(destName);
byte[] zSourceName = ToUTF8(sourceName);
SQLiteBackupHandle backupHandle = null;
try
{
// do nothing.
}
finally /* NOTE: Thread.Abort() protection. */
{
IntPtr backup = UnsafeNativeMethods.sqlite3_backup_init(
destHandle, zDestName, sourceHandle, zSourceName);
if (backup == IntPtr.Zero)
{
SQLiteErrorCode resultCode = ResultCode();
if (resultCode != SQLiteErrorCode.Ok)
throw new SQLiteException(resultCode, GetLastError());
else
throw new SQLiteException("failed to initialize backup");
}
backupHandle = new SQLiteBackupHandle(destHandle, backup);
}
SQLiteConnection.OnChanged(null, new ConnectionEventArgs(
SQLiteConnectionEventType.NewCriticalHandle, null,
null, null, null, backupHandle, null, new object[] {
typeof(SQLite3), destCnn, destName, sourceName }));
return new SQLiteBackup(
this, backupHandle, destHandle, zDestName, sourceHandle,
zSourceName);
}