609 lines
24 KiB
Dart
609 lines
24 KiB
Dart
// lib/services/local_storage_service.dart
|
|
|
|
import 'dart:io';
|
|
import 'dart:convert';
|
|
import 'package:flutter/foundation.dart';
|
|
import 'package:path_provider/path_provider.dart';
|
|
import 'package:permission_handler/permission_handler.dart';
|
|
import 'package:path/path.dart' as p;
|
|
// --- ADDED: Import dio for downloading ---
|
|
import 'package:dio/dio.dart';
|
|
|
|
import '../models/air_installation_data.dart';
|
|
import '../models/air_collection_data.dart';
|
|
import '../models/tarball_data.dart';
|
|
import '../models/in_situ_sampling_data.dart';
|
|
import '../models/river_in_situ_sampling_data.dart';
|
|
|
|
/// A comprehensive service for handling all local data storage for offline submissions.
|
|
class LocalStorageService {
|
|
|
|
// =======================================================================
|
|
// Part 1: Public Storage Setup
|
|
// =======================================================================
|
|
|
|
Future<bool> _requestPermissions() async {
|
|
var status = await Permission.manageExternalStorage.request();
|
|
return status.isGranted;
|
|
}
|
|
|
|
// --- MODIFIED: This method now accepts a serverName to create a server-specific root directory. ---
|
|
Future<Directory?> _getPublicMMSV4Directory({required String serverName}) async {
|
|
if (await _requestPermissions()) {
|
|
final Directory? externalDir = await getExternalStorageDirectory();
|
|
if (externalDir != null) {
|
|
final publicRootPath = externalDir.path.split('/Android/')[0];
|
|
// Create a subdirectory for the specific server configuration.
|
|
// If serverName is empty, it returns the root MMSV4 folder.
|
|
final mmsv4Dir = Directory(p.join(publicRootPath, 'MMSV4', serverName));
|
|
if (!await mmsv4Dir.exists()) {
|
|
await mmsv4Dir.create(recursive: true);
|
|
}
|
|
return mmsv4Dir;
|
|
}
|
|
}
|
|
debugPrint("LocalStorageService: Manage External Storage permission was not granted.");
|
|
return null;
|
|
}
|
|
|
|
// --- ADDED: A public method to retrieve the root log directory. ---
|
|
Future<Directory?> getLogDirectory({required String serverName, required String module, required String subModule}) async {
|
|
final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName);
|
|
if (mmsv4Dir == null) return null;
|
|
final logDir = Directory(p.join(mmsv4Dir.path, module, subModule));
|
|
if (!await logDir.exists()) {
|
|
await logDir.create(recursive: true);
|
|
}
|
|
return logDir;
|
|
}
|
|
|
|
// =======================================================================
|
|
// Part 2: Air Manual Sampling Methods (LOGGING RESTORED)
|
|
// =======================================================================
|
|
|
|
// --- MODIFIED: Method now requires serverName to get the correct base directory. ---
|
|
Future<Directory?> _getAirManualBaseDir({required String serverName}) async {
|
|
final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName);
|
|
if (mmsv4Dir == null) return null;
|
|
|
|
final airDir = Directory(p.join(mmsv4Dir.path, 'air', 'air_manual_sampling'));
|
|
if (!await airDir.exists()) {
|
|
await airDir.create(recursive: true);
|
|
}
|
|
return airDir;
|
|
}
|
|
|
|
/// Saves or updates an air sampling record, including copying all associated images to permanent local storage.
|
|
// --- MODIFIED: Method now requires serverName. ---
|
|
Future<String?> saveAirSamplingRecord(Map<String, dynamic> data, String refID, {required String serverName}) async {
|
|
final baseDir = await _getAirManualBaseDir(serverName: serverName);
|
|
if (baseDir == null) {
|
|
debugPrint("Could not get public storage directory for Air Manual. Check permissions.");
|
|
return null;
|
|
}
|
|
|
|
try {
|
|
final eventDir = Directory(p.join(baseDir.path, refID));
|
|
if (!await eventDir.exists()) {
|
|
await eventDir.create(recursive: true);
|
|
}
|
|
|
|
// Helper function to copy a file and return its new, permanent path
|
|
Future<String?> copyImageToLocal(dynamic imageFile) async {
|
|
if (imageFile is! File) return null; // Gracefully handle non-File types
|
|
try {
|
|
// Check if the file is already in the permanent directory to avoid re-copying
|
|
if (p.dirname(imageFile.path) == eventDir.path) {
|
|
return imageFile.path;
|
|
}
|
|
final String fileName = p.basename(imageFile.path);
|
|
final File newFile = await imageFile.copy(p.join(eventDir.path, fileName));
|
|
return newFile.path;
|
|
} catch (e) {
|
|
debugPrint("Error copying file ${imageFile.path}: $e");
|
|
return null;
|
|
}
|
|
}
|
|
|
|
// Create a mutable copy of the data map to avoid modifying the original
|
|
final Map<String, dynamic> serializableData = Map.from(data);
|
|
// --- MODIFIED: Inject the server name into the data being saved. ---
|
|
serializableData['serverConfigName'] = serverName;
|
|
|
|
|
|
// Define the keys for installation images to look for in the map
|
|
final installationImageKeys = ['imageFront', 'imageBack', 'imageLeft', 'imageRight', 'optionalImage1', 'optionalImage2', 'optionalImage3', 'optionalImage4'];
|
|
|
|
// Process top-level (installation) images
|
|
for (final key in installationImageKeys) {
|
|
// Check if the key exists and the value is a File object
|
|
if (serializableData.containsKey(key) && serializableData[key] is File) {
|
|
final newPath = await copyImageToLocal(serializableData[key]);
|
|
serializableData['${key}Path'] = newPath; // Creates 'imageFrontPath', etc.
|
|
// Note: DO NOT remove the original key here if it holds a File object.
|
|
// The copy is needed for local storage/DB logging, but the File object must stay
|
|
// on the key if other process calls `toMap()` again.
|
|
// However, based on the previous logic, we rely on the caller passing a map
|
|
// that separates File objects from paths for DB logging.
|
|
}
|
|
}
|
|
|
|
// Process nested collection images, if they exist
|
|
if (serializableData['collectionData'] is Map) {
|
|
final collectionMap = Map<String, dynamic>.from(serializableData['collectionData']);
|
|
final collectionImageKeys = ['imageFront', 'imageBack', 'imageLeft', 'imageRight', 'imageChart', 'imageFilterPaper', 'optionalImage1', 'optionalImage2', 'optionalImage3', 'optionalImage4'];
|
|
|
|
for (final key in collectionImageKeys) {
|
|
if (collectionMap.containsKey(key) && collectionMap[key] is File) {
|
|
final newPath = await copyImageToLocal(collectionMap[key]);
|
|
collectionMap['${key}Path'] = newPath;
|
|
}
|
|
}
|
|
serializableData['collectionData'] = collectionMap;
|
|
}
|
|
|
|
// CRITICAL FIX: Ensure the JSON data only contains serializable (non-File) objects
|
|
// We must strip the File objects before encoding, as they have now been copied.
|
|
final Map<String, dynamic> finalData = Map.from(serializableData);
|
|
|
|
// Recursive helper to remove File objects before JSON encoding
|
|
void cleanMap(Map<String, dynamic> map) {
|
|
map.removeWhere((key, value) => value is File);
|
|
map.forEach((key, value) {
|
|
if (value is Map) cleanMap(value as Map<String, dynamic>);
|
|
});
|
|
}
|
|
|
|
// Since the caller (_toMapForLocalSave) only passes a map with File objects on the image keys,
|
|
// and paths on the *Path keys*, simply removing the File keys and encoding is sufficient.
|
|
finalData.removeWhere((key, value) => value is File);
|
|
if (finalData.containsKey('collectionData') && finalData['collectionData'] is Map) {
|
|
cleanMap(finalData['collectionData'] as Map<String, dynamic>);
|
|
}
|
|
|
|
|
|
final jsonFile = File(p.join(eventDir.path, 'data.json'));
|
|
await jsonFile.writeAsString(jsonEncode(finalData));
|
|
debugPrint("Air sampling log and images saved to: ${eventDir.path}");
|
|
|
|
return eventDir.path;
|
|
|
|
} catch (e, s) {
|
|
debugPrint("Error saving air sampling log to local storage: $e");
|
|
debugPrint("Stack trace: $s");
|
|
return null;
|
|
}
|
|
}
|
|
|
|
// --- MODIFIED: This method now scans all server subdirectories to find all logs. ---
|
|
Future<List<Map<String, dynamic>>> getAllAirSamplingLogs() async {
|
|
final mmsv4Root = await _getPublicMMSV4Directory(serverName: ''); // Get root MMSV4 without a server subfolder
|
|
if (mmsv4Root == null || !await mmsv4Root.exists()) return [];
|
|
|
|
final List<Map<String, dynamic>> allLogs = [];
|
|
final serverDirs = mmsv4Root.listSync().whereType<Directory>();
|
|
|
|
for (var serverDir in serverDirs) {
|
|
final baseDir = Directory(p.join(serverDir.path, 'air', 'air_manual_sampling'));
|
|
if (!await baseDir.exists()) continue;
|
|
|
|
try {
|
|
final entities = baseDir.listSync();
|
|
for (var entity in entities) {
|
|
if (entity is Directory) {
|
|
final jsonFile = File(p.join(entity.path, 'data.json'));
|
|
if (await jsonFile.exists()) {
|
|
final content = await jsonFile.readAsString();
|
|
final data = jsonDecode(content) as Map<String, dynamic>;
|
|
data['logDirectory'] = entity.path;
|
|
allLogs.add(data);
|
|
}
|
|
}
|
|
}
|
|
} catch (e) {
|
|
debugPrint("Error reading air logs from ${baseDir.path}: $e");
|
|
}
|
|
}
|
|
return allLogs;
|
|
}
|
|
|
|
// =======================================================================
|
|
// Part 3: Tarball Specific Methods (LOGGING RESTORED)
|
|
// =======================================================================
|
|
|
|
Future<Directory?> _getTarballBaseDir({required String serverName}) async {
|
|
final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName);
|
|
if (mmsv4Dir == null) return null;
|
|
|
|
final tarballDir = Directory(p.join(mmsv4Dir.path, 'marine', 'marine_tarball_sampling'));
|
|
if (!await tarballDir.exists()) {
|
|
await tarballDir.create(recursive: true);
|
|
}
|
|
return tarballDir;
|
|
}
|
|
|
|
Future<String?> saveTarballSamplingData(TarballSamplingData data, {required String serverName}) async {
|
|
final baseDir = await _getTarballBaseDir(serverName: serverName);
|
|
if (baseDir == null) {
|
|
debugPrint("Could not get public storage directory. Check permissions.");
|
|
return null;
|
|
}
|
|
|
|
try {
|
|
final stationCode = data.selectedStation?['tbl_station_code'] ?? 'UNKNOWN_STATION';
|
|
final timestamp = "${data.samplingDate}_${data.samplingTime?.replaceAll(':', '-')}";
|
|
final eventFolderName = "${stationCode}_$timestamp";
|
|
final eventDir = Directory(p.join(baseDir.path, eventFolderName));
|
|
|
|
if (!await eventDir.exists()) {
|
|
await eventDir.create(recursive: true);
|
|
}
|
|
|
|
final Map<String, dynamic> jsonData = { ...data.toFormData(), 'submissionStatus': data.submissionStatus, 'submissionMessage': data.submissionMessage, 'reportId': data.reportId };
|
|
jsonData['serverConfigName'] = serverName;
|
|
jsonData['selectedStation'] = data.selectedStation;
|
|
|
|
final imageFiles = data.toImageFiles();
|
|
for (var entry in imageFiles.entries) {
|
|
final File? imageFile = entry.value;
|
|
if (imageFile != null) {
|
|
final String originalFileName = p.basename(imageFile.path);
|
|
final File newFile = await imageFile.copy(p.join(eventDir.path, originalFileName));
|
|
jsonData[entry.key] = newFile.path;
|
|
}
|
|
}
|
|
|
|
final jsonFile = File(p.join(eventDir.path, 'data.json'));
|
|
await jsonFile.writeAsString(jsonEncode(jsonData));
|
|
debugPrint("Tarball log saved to: ${jsonFile.path}");
|
|
|
|
return eventDir.path;
|
|
|
|
} catch (e) {
|
|
debugPrint("Error saving tarball log to local storage: $e");
|
|
return null;
|
|
}
|
|
}
|
|
|
|
Future<List<Map<String, dynamic>>> getAllTarballLogs() async {
|
|
final mmsv4Root = await _getPublicMMSV4Directory(serverName: '');
|
|
if (mmsv4Root == null || !await mmsv4Root.exists()) return [];
|
|
|
|
final List<Map<String, dynamic>> allLogs = [];
|
|
final serverDirs = mmsv4Root.listSync().whereType<Directory>();
|
|
|
|
for (var serverDir in serverDirs) {
|
|
final baseDir = Directory(p.join(serverDir.path, 'marine', 'marine_tarball_sampling'));
|
|
if (!await baseDir.exists()) continue;
|
|
try {
|
|
final entities = baseDir.listSync();
|
|
for (var entity in entities) {
|
|
if (entity is Directory) {
|
|
final jsonFile = File(p.join(entity.path, 'data.json'));
|
|
if (await jsonFile.exists()) {
|
|
final content = await jsonFile.readAsString();
|
|
final data = jsonDecode(content) as Map<String, dynamic>;
|
|
data['logDirectory'] = entity.path;
|
|
allLogs.add(data);
|
|
}
|
|
}
|
|
}
|
|
} catch (e) {
|
|
debugPrint("Error reading tarball logs from ${baseDir.path}: $e");
|
|
}
|
|
}
|
|
return allLogs;
|
|
}
|
|
|
|
Future<void> updateTarballLog(Map<String, dynamic> updatedLogData) async {
|
|
final logDir = updatedLogData['logDirectory'];
|
|
if (logDir == null) {
|
|
debugPrint("Cannot update log: logDirectory key is missing.");
|
|
return;
|
|
}
|
|
|
|
try {
|
|
final jsonFile = File(p.join(logDir, 'data.json'));
|
|
if (await jsonFile.exists()) {
|
|
updatedLogData.remove('isResubmitting');
|
|
await jsonFile.writeAsString(jsonEncode(updatedLogData));
|
|
debugPrint("Log updated successfully at: ${jsonFile.path}");
|
|
}
|
|
} catch (e) {
|
|
debugPrint("Error updating tarball log: $e");
|
|
}
|
|
}
|
|
|
|
|
|
// =======================================================================
|
|
// Part 4: Marine In-Situ Specific Methods (LOGGING RESTORED)
|
|
// =======================================================================
|
|
|
|
// --- MODIFIED: Removed leading underscore to make the method public ---
|
|
Future<Directory?> getInSituBaseDir({required String serverName}) async {
|
|
final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName);
|
|
if (mmsv4Dir == null) return null;
|
|
|
|
final inSituDir = Directory(p.join(mmsv4Dir.path, 'marine', 'marine_in_situ_sampling'));
|
|
if (!await inSituDir.exists()) {
|
|
await inSituDir.create(recursive: true);
|
|
}
|
|
return inSituDir;
|
|
}
|
|
|
|
Future<String?> saveInSituSamplingData(InSituSamplingData data, {required String serverName}) async {
|
|
final baseDir = await getInSituBaseDir(serverName: serverName);
|
|
if (baseDir == null) {
|
|
debugPrint("Could not get public storage directory for In-Situ. Check permissions.");
|
|
return null;
|
|
}
|
|
|
|
try {
|
|
final stationCode = data.selectedStation?['man_station_code'] ?? 'UNKNOWN_STATION';
|
|
final timestamp = "${data.samplingDate}_${data.samplingTime?.replaceAll(':', '-')}";
|
|
final eventFolderName = "${stationCode}_$timestamp";
|
|
final eventDir = Directory(p.join(baseDir.path, eventFolderName));
|
|
|
|
if (!await eventDir.exists()) {
|
|
await eventDir.create(recursive: true);
|
|
}
|
|
|
|
final Map<String, dynamic> jsonData = { ...data.toApiFormData(), 'submissionStatus': data.submissionStatus, 'submissionMessage': data.submissionMessage, 'reportId': data.reportId };
|
|
jsonData['serverConfigName'] = serverName;
|
|
jsonData['selectedStation'] = data.selectedStation;
|
|
|
|
final imageFiles = data.toApiImageFiles();
|
|
for (var entry in imageFiles.entries) {
|
|
final File? imageFile = entry.value;
|
|
if (imageFile != null) {
|
|
final String originalFileName = p.basename(imageFile.path);
|
|
final File newFile = await imageFile.copy(p.join(eventDir.path, originalFileName));
|
|
jsonData[entry.key] = newFile.path;
|
|
}
|
|
}
|
|
|
|
final jsonFile = File(p.join(eventDir.path, 'data.json'));
|
|
await jsonFile.writeAsString(jsonEncode(jsonData));
|
|
debugPrint("In-Situ log saved to: ${jsonFile.path}");
|
|
|
|
return eventDir.path;
|
|
|
|
} catch (e) {
|
|
debugPrint("Error saving In-Situ log to local storage: $e");
|
|
return null;
|
|
}
|
|
}
|
|
|
|
Future<List<Map<String, dynamic>>> getAllInSituLogs() async {
|
|
final mmsv4Root = await _getPublicMMSV4Directory(serverName: '');
|
|
if (mmsv4Root == null || !await mmsv4Root.exists()) return [];
|
|
|
|
final List<Map<String, dynamic>> allLogs = [];
|
|
final serverDirs = mmsv4Root.listSync().whereType<Directory>();
|
|
|
|
for (var serverDir in serverDirs) {
|
|
final baseDir = Directory(p.join(serverDir.path, 'marine', 'marine_in_situ_sampling'));
|
|
if (!await baseDir.exists()) continue;
|
|
try {
|
|
final entities = baseDir.listSync();
|
|
for (var entity in entities) {
|
|
if (entity is Directory) {
|
|
final jsonFile = File(p.join(entity.path, 'data.json'));
|
|
if (await jsonFile.exists()) {
|
|
final content = await jsonFile.readAsString();
|
|
final data = jsonDecode(content) as Map<String, dynamic>;
|
|
data['logDirectory'] = entity.path;
|
|
allLogs.add(data);
|
|
}
|
|
}
|
|
}
|
|
} catch (e) {
|
|
debugPrint("Error reading in-situ logs from ${baseDir.path}: $e");
|
|
}
|
|
}
|
|
return allLogs;
|
|
}
|
|
|
|
Future<void> updateInSituLog(Map<String, dynamic> updatedLogData) async {
|
|
final logDir = updatedLogData['logDirectory'];
|
|
if (logDir == null) {
|
|
debugPrint("Cannot update log: logDirectory key is missing.");
|
|
return;
|
|
}
|
|
|
|
try {
|
|
final jsonFile = File(p.join(logDir, 'data.json'));
|
|
if (await jsonFile.exists()) {
|
|
updatedLogData.remove('isResubmitting');
|
|
await jsonFile.writeAsString(jsonEncode(updatedLogData));
|
|
debugPrint("Log updated successfully at: ${jsonFile.path}");
|
|
}
|
|
} catch (e) {
|
|
debugPrint("Error updating in-situ log: $e");
|
|
}
|
|
}
|
|
|
|
// =======================================================================
|
|
// Part 5: River In-Situ Specific Methods (LOGGING RESTORED)
|
|
// =======================================================================
|
|
|
|
Future<Directory?> getRiverInSituBaseDir(String? samplingType, {required String serverName}) async {
|
|
final mmsv4Dir = await _getPublicMMSV4Directory(serverName: serverName);
|
|
if (mmsv4Dir == null) return null;
|
|
|
|
String subfolderName;
|
|
if (samplingType == 'Schedule' || samplingType == 'Triennial') {
|
|
subfolderName = samplingType!;
|
|
} else {
|
|
subfolderName = 'Others';
|
|
}
|
|
|
|
final inSituDir = Directory(p.join(mmsv4Dir.path, 'river', 'river_in_situ_sampling', subfolderName));
|
|
if (!await inSituDir.exists()) {
|
|
await inSituDir.create(recursive: true);
|
|
}
|
|
return inSituDir;
|
|
}
|
|
|
|
Future<String?> saveRiverInSituSamplingData(RiverInSituSamplingData data, {required String serverName}) async {
|
|
final baseDir = await getRiverInSituBaseDir(data.samplingType, serverName: serverName);
|
|
if (baseDir == null) {
|
|
debugPrint("Could not get public storage directory for River In-Situ. Check permissions.");
|
|
return null;
|
|
}
|
|
|
|
try {
|
|
final stationCode = data.selectedStation?['sampling_station_code'] ?? 'UNKNOWN_STATION';
|
|
final timestamp = "${data.samplingDate}_${data.samplingTime?.replaceAll(':', '-')}";
|
|
final eventFolderName = "${stationCode}_$timestamp";
|
|
final eventDir = Directory(p.join(baseDir.path, eventFolderName));
|
|
|
|
if (!await eventDir.exists()) {
|
|
await eventDir.create(recursive: true);
|
|
}
|
|
|
|
final Map<String, dynamic> jsonData = { ...data.toApiFormData(), 'submissionStatus': data.submissionStatus, 'submissionMessage': data.submissionMessage, 'reportId': data.reportId };
|
|
jsonData['serverConfigName'] = serverName;
|
|
jsonData['selectedStation'] = data.selectedStation;
|
|
|
|
final imageFiles = data.toApiImageFiles();
|
|
for (var entry in imageFiles.entries) {
|
|
final File? imageFile = entry.value;
|
|
if (imageFile != null) {
|
|
final String originalFileName = p.basename(imageFile.path);
|
|
final File newFile = await imageFile.copy(p.join(eventDir.path, originalFileName));
|
|
jsonData[entry.key] = newFile.path;
|
|
}
|
|
}
|
|
|
|
final jsonFile = File(p.join(eventDir.path, 'data.json'));
|
|
await jsonFile.writeAsString(jsonEncode(jsonData));
|
|
debugPrint("River In-Situ log saved to: ${jsonFile.path}");
|
|
|
|
return eventDir.path;
|
|
|
|
} catch (e) {
|
|
debugPrint("Error saving River In-Situ log to local storage: $e");
|
|
return null;
|
|
}
|
|
}
|
|
|
|
Future<List<Map<String, dynamic>>> getAllRiverInSituLogs() async {
|
|
final mmsv4Root = await _getPublicMMSV4Directory(serverName: '');
|
|
if (mmsv4Root == null || !await mmsv4Root.exists()) return [];
|
|
|
|
final List<Map<String, dynamic>> allLogs = [];
|
|
final serverDirs = mmsv4Root.listSync().whereType<Directory>();
|
|
|
|
for (var serverDir in serverDirs) {
|
|
final topLevelDir = Directory(p.join(serverDir.path, 'river', 'river_in_situ_sampling'));
|
|
if (!await topLevelDir.exists()) continue;
|
|
try {
|
|
final typeSubfolders = topLevelDir.listSync();
|
|
for (var typeSubfolder in typeSubfolders) {
|
|
if (typeSubfolder is Directory) {
|
|
final eventFolders = typeSubfolder.listSync();
|
|
for (var eventFolder in eventFolders) {
|
|
if (eventFolder is Directory) {
|
|
final jsonFile = File(p.join(eventFolder.path, 'data.json'));
|
|
if (await jsonFile.exists()) {
|
|
final content = await jsonFile.readAsString();
|
|
final data = jsonDecode(content) as Map<String, dynamic>;
|
|
data['logDirectory'] = eventFolder.path;
|
|
allLogs.add(data);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
} catch (e) {
|
|
debugPrint("Error getting all river in-situ logs from ${topLevelDir.path}: $e");
|
|
}
|
|
}
|
|
return allLogs;
|
|
}
|
|
|
|
Future<void> updateRiverInSituLog(Map<String, dynamic> updatedLogData) async {
|
|
final logDir = updatedLogData['logDirectory'];
|
|
if (logDir == null) {
|
|
debugPrint("Cannot update log: logDirectory key is missing.");
|
|
return;
|
|
}
|
|
|
|
try {
|
|
final jsonFile = File(p.join(logDir, 'data.json'));
|
|
if (await jsonFile.exists()) {
|
|
updatedLogData.remove('isResubmitting');
|
|
await jsonFile.writeAsString(jsonEncode(updatedLogData));
|
|
debugPrint("Log updated successfully at: ${jsonFile.path}");
|
|
}
|
|
} catch (e) {
|
|
debugPrint("Error updating river in-situ log: $e");
|
|
}
|
|
}
|
|
|
|
// =======================================================================
|
|
// --- ADDED: Part 6: Info Centre Document Management ---
|
|
// =======================================================================
|
|
|
|
final Dio _dio = Dio();
|
|
|
|
/// Gets the directory for storing Info Centre documents, creating it if it doesn't exist.
|
|
Future<Directory?> _getInfoCentreDocumentsDirectory() async {
|
|
// We use serverName: '' to ensure documents are stored in a common root MMSV4 folder, not server-specific ones.
|
|
final mmsv4Dir = await _getPublicMMSV4Directory(serverName: '');
|
|
if (mmsv4Dir == null) return null;
|
|
|
|
final docDir = Directory(p.join(mmsv4Dir.path, 'info_centre_documents'));
|
|
if (!await docDir.exists()) {
|
|
await docDir.create(recursive: true);
|
|
}
|
|
return docDir;
|
|
}
|
|
|
|
/// Constructs the full local file path for a given document URL.
|
|
Future<String?> getLocalDocumentPath(String docUrl) async {
|
|
final docDir = await _getInfoCentreDocumentsDirectory();
|
|
if (docDir == null) return null;
|
|
|
|
final fileName = p.basename(docUrl);
|
|
return p.join(docDir.path, fileName);
|
|
}
|
|
|
|
/// Checks if a document has already been downloaded.
|
|
Future<bool> isDocumentDownloaded(String docUrl) async {
|
|
final filePath = await getLocalDocumentPath(docUrl);
|
|
if (filePath == null) return false;
|
|
return await File(filePath).exists();
|
|
}
|
|
|
|
/// Downloads a document from a URL and saves it to the local `MMSV4/info_centre_documents` folder.
|
|
Future<void> downloadDocument({
|
|
required String docUrl,
|
|
required Function(double) onReceiveProgress,
|
|
}) async {
|
|
final filePath = await getLocalDocumentPath(docUrl);
|
|
if (filePath == null) {
|
|
throw Exception("Could not get local storage path. Check permissions.");
|
|
}
|
|
|
|
try {
|
|
await _dio.download(
|
|
docUrl,
|
|
filePath,
|
|
onReceiveProgress: (received, total) {
|
|
if (total != -1) {
|
|
onReceiveProgress(received / total);
|
|
}
|
|
},
|
|
);
|
|
} catch (e) {
|
|
// If the download fails, delete the partially downloaded file to prevent corruption.
|
|
final file = File(filePath);
|
|
if (await file.exists()) {
|
|
await file.delete();
|
|
}
|
|
throw Exception("Download failed: $e");
|
|
}
|
|
}
|
|
} |