GSD-Utilities #

Dieses Paket bietet umfassende Utility-Funktionen für Flutter-Anwendungen mit plattformübergreifender Konfigurationsverwaltung, LocalStorage mit Cross-Tab-Events, fortschrittlicher Datei-Upload-Funktionalität und DOCUframe-Integration. Es ermöglicht die strukturierte Verwaltung von Anwendungsdaten sowohl für Web- als auch für Mobile/Desktop-Plattformen.

Features #

• Plattformübergreifende Konfigurationsverwaltung: Automatische Plattformauswahl zwischen Web und Mobile/Desktop
• Sichere Datenpersistierung: Web mit verschlüsseltem LocalStorage, Mobile/Desktop mit FlutterSecureStorage
• LocalStorage mit Events: Cross-Tab-Kommunikation über JavaScript Interop
• File Upload System: Real-time Fortschrittsverfolgung mit Byte-Level-Genauigkeit
• Bildverarbeitung: Automatische Bilderkennung und Größenanpassung
• Batch-Upload: Mehrere Dateien gleichzeitig hochladen
• DOCUframe Integration: Enterprise-Funktionen für DOCUframe-Systeme
• Event-basierte Architektur: Benachrichtigungen bei Datenänderungen
• TypeScript-kompatibel: JavaScript Interop für Web-Plattformen
• Memory-effizient: Automatisches Cleanup und Ressourcenverwaltung

Installation #

Fügen Sie das Paket in Ihrer pubspec.yaml hinzu:

dependencies:
  gsd_utilities: ^0.0.1

Führen Sie anschließend flutter pub get aus, um das Paket zu installieren.

Nutzung #

Konfigurationsmanagement #

Erstellen Sie eine Konfigurationsklasse und verwalten Sie sie automatisch:

import 'package:gsd_utilities/gsd_utilities.dart';

// Eigene Konfigurationsklasse erstellen
class AppConfig extends GSDBaseConfig {
  String? serverUrl;
  int? timeout;
  bool? debugMode;

  AppConfig({this.serverUrl, this.timeout, this.debugMode});

  @override
  String toJson() {
    return '{"serverUrl": ${serverUrl != null ? '"$serverUrl"' : 'null'}, '
           '"timeout": $timeout, "debugMode": $debugMode}';
  }

  @override
  void loadFromJson(String jsonString) {
    final data = jsonDecode(jsonString);
    serverUrl = data['serverUrl'];
    timeout = data['timeout'];
    debugMode = data['debugMode'];
  }

  @override
  GSDBaseConfig createInstance() => AppConfig();
}

// Konfiguration laden und verwalten
final configManager = GSDConfigManager(key: "app_config");
final configResult = await configManager.loadConfig(AppConfig());

if (configResult.isSuccess && configResult.config != null) {
  print('Konfiguration geladen: ${configResult.config!.serverUrl}');
} else {
  print('Konfiguration konnte nicht geladen werden: ${configResult.log}');
}

LocalStorage mit Cross-Tab-Events #

Überwachen Sie LocalStorage-Änderungen zwischen Browser-Tabs:

// LocalStorage Manager erstellen
final localStorageManager = GSDLocalStorageManager();

// Storage-Events überwachen (nur Web)
localStorageManager.storageChanged.subscribe((GSDWebLocalStorageEventArgs args) async {
  print('Storage geändert von anderem Tab:');
  print('Key: ${args.key}, Neuer Wert: ${args.value}');
});

// Daten schreiben und lesen
localStorageManager.writeData('user_settings', '{"theme": "dark"}');
String settings = localStorageManager.readData('user_settings');
print('Geladene Einstellungen: $settings');

File Upload mit Fortschrittsverfolgung #

Laden Sie Dateien mit Real-time-Fortschrittsanzeige hoch:

import 'package:gsd_restapi/gsd_restapi.dart';

// Upload Manager erstellen
final RestApiDOCUframeManager apiManager = RestApiDOCUframeManager(
  'GSD-DFApp', 'username', ['app1'], 'https://server.com', 'db'
);
final uploadManager = DOCUframeUploadManager(apiManager);

// Dateien für Upload vorbereiten
List<GSDUploadFile> files = [
  GSDUploadFile.fromPath('/path/to/document.pdf'),
  GSDUploadFile.fromPath('/path/to/image.jpg'),
];

// Upload mit Fortschrittsverfolgung starten
await for (GSDUploadProgress progress in uploadManager.uploadFiles(files)) {
  print('Gesamt-Fortschritt: ${progress.percentage}%');
  print('Abgeschlossene Dateien: ${progress.completedFiles.length}/${progress.totalFiles}');
  
  for (int i = 0; i < progress.uploadFileProgresses.length; i++) {
    final fileProgress = progress.uploadFileProgresses[i];
    print('Datei ${i + 1}: ${fileProgress.percentage}% - Status: ${fileProgress.status}');
  }
  
  if (progress.isFinished) {
    print('Alle Uploads abgeschlossen!');
    break;
  }
}

Event-Handling #

// Konfigurationsänderungen überwachen
config.configChangedEvent.subscribe((args) async {
  print('Konfiguration wurde automatisch gespeichert');
});

// Account-Änderungen überwachen
account.accountChanged.subscribe((args) async {
  print('Account-Daten wurden geändert');
});

Konfigurationsarchitektur #

Das Paket verwendet eine plattformspezifische Konfigurationsarchitektur:

Web-Plattform #

• LocalStorage: Browser-basierte Datenpersistierung
• AES-Verschlüsselung: Sichere Speicherung sensibler Daten
• Storage-Events: Cross-Tab-Kommunikation über JavaScript Interop

Mobile/Desktop-Plattform #

• FlutterSecureStorage: Systemspezifische sichere Speicherung
• Platform-native: Verwendet OS-eigene Sicherheitsmechanismen

File Upload Features #

Unterstützte Dateitypen #

• Dokumente: PDF, DOC, DOCX, TXT, etc.
• Bilder: PNG, JPEG, GIF, WebP (mit automatischer Komprimierung)
• Archive: ZIP, RAR, etc.
• Web-Dateien: Direkte Browser-Upload-Unterstützung

Upload-Funktionen #

// Bildkomprimierung konfigurieren
final uploadFile = GSDUploadFile.fromPath('/path/to/large_image.jpg');
uploadFile.setResolution(GSDUploadImageResolution(percentage: 75)); // 75% der Originalgröße

// Upload-Status überwachen
if (fileProgress.status == GSDUploadFileStatus.completed) {
  print('Upload erfolgreich! Server-ID: ${fileProgress.result?.oid}');
} else if (fileProgress.status == GSDUploadFileStatus.failed) {
  print('Upload fehlgeschlagen: ${fileProgress.result?.error}');
}

DOCUframe Integration #

Spezielle Enterprise-Funktionen für DOCUframe-Systeme:

// Account-Konfiguration
final account = DOCUframeAccount(
  'Mein Account',
  'https://docuframe.server.com',
  'account_alias',
  'username'
);

account.setDatabaseName('production_db');

// Account-Serialisierung
Map<String, dynamic> accountData = account.toJson();
DOCUframeAccount restoredAccount = DOCUframeAccount.fromJson(accountData);

Error-Handling #

Das Paket bietet umfassende Fehlerbehandlung:

try {
  final result = await configManager.loadConfig(AppConfig());
  if (!result.isSuccess) {
    print('Fehler beim Laden: ${result.error}');
    print('Debug-Log: ${result.log}');
  }
} catch (e) {
  print('Unerwarteter Fehler: $e');
}

Performance und Memory Management #

• Automatisches Cleanup: Event-Listener werden automatisch entfernt
• Memory-effizient: Große Dateien werden in Chunks verarbeitet
• Background-Processing: Uploads laufen im Hintergrund
• Platform-optimiert: Plattformspezifische Optimierungen

API-Design #

Das Paket folgt dem Prinzip der sauberen Architektur:

• ✅ GSDConfigManager - Hauptklasse für Konfigurationsverwaltung
• ✅ GSDLocalStorageManager - Plattformübergreifender Storage-Manager
• ✅ DOCUframeUploadManager - Upload-Funktionalität mit Fortschrittsverfolgung
• ✅ GSDBaseConfig - Abstrakte Basis für eigene Konfigurationsklassen
• ✅ GSDUploadFile - Datei-Repräsentation mit Metadaten
• ❌ _GSDWebConfigManager - Interne Web-Implementierung (nicht zugänglich)
• ❌ _GSDAppConfigManager - Interne Mobile-Implementierung (nicht zugänglich)

Plattform-Kompatibilität #

Hinweise #

• Automatische Plattformauswahl: Das richtige Storage-System wird automatisch gewählt
• Event-basiert: Alle Änderungen werden über Events kommuniziert
• Type-safe: Vollständige TypeScript-Integration für Web-Plattformen
• Memory-safe: Automatisches Cleanup verhindert Memory-Leaks
• Production-ready: Umfassende Fehlerbehandlung und Logging
• Dokumentiert: Alle Klassen und Methoden vollständig dokumentiert

Dieses Paket ermöglicht die professionelle Utility-Verwaltung in Ihrer Flutter-Anwendung und bietet umfassende Funktionen für Konfiguration, Storage, File-Upload und Enterprise-Integration bei gleichzeitig sauberer und plattformübergreifender API.