#2742 Database backups with scheduled backups, retention and restore

- Engine-independent backup files (zip with calls, events and metadata as JSON) written from a single read
  transaction on a background thread; restorable into any supported database type.
- Automatic backup interval and number of backups to keep in the database preferences; the oldest backups
  are deleted after each backup.
- Backup list with Back Up Now, Restore and Delete.  A restore runs in one transaction on the database thread
  after making a pre-restore backup; missing recordings are marked deleted and in-progress calls interrupted.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
denny
2026-11-22 03:16:23 -05:00
parent d6234600c0
commit bb19547af0
14 changed files with 2119 additions and 2 deletions

View File

@@ -0,0 +1,61 @@
/*
* *****************************************************************************
* Copyright (C) 2014-2026 Dennis Sheirer
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>
* ****************************************************************************
*/
package io.github.dsheirer.database.backup;
import java.nio.file.Path;
/**
* A backup file in the backup directory
*
* @param path of the backup file
* @param created time of the backup, milliseconds since epoch (from the file name)
* @param size of the file in bytes
* @param tag optional tag from the file name (e.g. pre-restore), or null
* @param metadata from the file, or null if the file can't be read
*/
public record BackupInfo(Path path, long created, long size, String tag, Metadata metadata)
{
/**
* Backup file contents summary
*
* @param format version of the backup file format
* @param schemaVersion of the database tables the backup was made from
* @param created time of the backup, milliseconds since epoch
* @param source description of the database that was backed up
* @param calls count of calls in the backup
* @param events count of events in the backup
*/
public record Metadata(int format, int schemaVersion, long created, String source, long calls, long events) {}
/**
* Indicates if the file is a readable backup
*/
public boolean isValid()
{
return metadata != null;
}
/**
* Indicates if this backup was made automatically before restoring another backup
*/
public boolean isPreRestore()
{
return BackupManager.TAG_PRE_RESTORE.equals(tag);
}
}