CfapiSync zeigt, wie sich mit der Cloud Files API von Windows eine bidirektionale Synchronisation in C# realisieren lässt. Das Projekt arbeitet wie ein lokaler Cloud-Client, gleicht Dateien in Echtzeit ab und dient als technische Grundlage für eigene Sync-Lösungen oder hybride Speichersysteme.
CfapiSync verweist auf die Implementierung einer bidirektionalen Synchronisation von Dateien zwischen einem lokalen Speicherort und der Cloud unter Verwendung der Cloud Files API (CFAPI) von Windows.
(Bild: Midjourney / KI-generiert)
CfapiSync demonstriert die Implementierung einer bidirektionalen Cloud-Synchronisation unter Windows 10 und 11 unter Nutzung der Cloud Files API. Das Projekt entstand als frühe Alpha-Version in C# und bildet die Funktionsweise eines OneDrive-ähnlichen Clients nach. Der aktuelle Prototyp nutzt den lokalen Ordner „D:\temp“ als Serverquelle und erzeugt für den Benutzer ein synchronisiertes Arbeitsverzeichnis, das alle Änderungen zwischen Client und Server automatisch abgleicht.
Cloud-Agent selbst bauen
Die technische Basis von CfapiSync besteht aus zwei Hauptkomponenten, dem SyncProvider und dem ServerProvider. Der SyncProvider übernimmt die Überwachung und Synchronisation lokaler Dateien, erkennt Änderungen in Echtzeit und steuert die Datenflüsse. Der ServerProvider kommuniziert über das definierte Interface IServerProvider mit der Cloud oder einem lokalen Verzeichnis. Dieses Konzept erlaubt den einfachen Austausch der zugrundeliegenden Datenquelle. Neben lokalen und UNC-Pfaden sind Erweiterungen für WebDAV und Amazon S3 vorgesehen.
Die aktuelle Version unterstützt lokale Verzeichnisse und Netzwerkpfade, die über FileSystemWatcher überwacht werden. Das ermöglicht Echtzeit-Synchronisation, sofern der Server Änderungsereignisse korrekt an den Client meldet. Bei DFS-Pfaden ist diese Überwachung eingeschränkt, weshalb direkte Serverpfade verwendet werden sollten. Im Code ist vorgesehen, den DFS-Root automatisch in den zugehörigen Serverpfad aufzulösen, was jedoch noch nicht implementiert ist.
Das Synchronisationsverfahren nutzt eine vollständige Registrierung als Cloud-Provider und konvertiert lokale Dateien zunächst in sogenannte Hydrated Placeholders. Anschließend erfolgt ein beidseitiger Abgleich zwischen Client und Server. Neue lokale Dateien werden hochgeladen, sofern sie auf dem Server nicht vorhanden sind. Existiert dort bereits eine Datei mit selbem Namen, überschreibt die neuere Version die ältere. Nach Abschluss des Transfers wird der Status „IN SYNC“ gesetzt.
Lokale Dateien und Cloud synchronisieren
Änderungen an lokalen Dateien führen zu einer Anpassung des Synchronisationszustands. Wird eine Datei angepinnt, lädt CfapiSync den vollständigen Inhalt aus der Serverquelle nach. Beim Übergang in den unpinnten Zustand wird die Datei synchronisiert, dehydriert und in den Status „UNSPECIFIED“ gesetzt. Inhalte, die sich ändern, werden erneut übertragen und anschließend als synchron markiert. Auf Serverseite veränderte Dateien aktualisieren die Metadaten der lokalen Placeholders. Je nach Pin-Status erfolgt eine Rehydration oder das Dehydrieren zur Platzersparnis.
Erscheint auf dem Server eine neue Datei, erzeugt CfapiSync automatisch einen Platzhalter mit Metadaten. Liegt dieser in einem angepinnten Verzeichnis, wird der Inhalt sofort geladen. Befindet er sich in einem nicht befüllten Ordner, bleibt er zunächst unberührt, bis das Verzeichnis geöffnet oder manuell synchronisiert wird. Ganze Verzeichnisse ohne angepinnte Inhalte erhalten den Status „PARTIALLY ON DISK“ und werden erst bei Bedarf einbezogen.
Aktuelles eBook
Open-Source-Storage – Speicher-Software zum Nulltarif
eBook „Open-Source-Storage“
(Bild: Storage-Insider)
Der Bedarf an Speicherkapazität steigt von Tag zu Tag – nicht nur, um die Daten von Produkten, Kunden und Transaktionen zu sichern, sondern auch, um Compliance-Anforderungen zu erfüllen und Auditierungen gut zu überstehen. Eine leistungsfähige Storage-Lösung ist also gefragt. Eine kostenlose Option bietet Open-Source-Software für Storage, insbesondere dann, wenn man sie selbst den eigenen Anforderungen anpassen darf.
Es ist für uns eine Selbstverständlichkeit, dass wir verantwortungsvoll mit Ihren personenbezogenen Daten umgehen. Sofern wir personenbezogene Daten von Ihnen erheben, verarbeiten wir diese unter Beachtung der geltenden Datenschutzvorschriften. Detaillierte Informationen finden Sie in unserer Datenschutzerklärung.
Einwilligung in die Verwendung von Daten zu Werbezwecken
Ich bin damit einverstanden, dass die Vogel IT-Medien GmbH, Max-Josef-Metzger-Straße 21, 86157 Augsburg, einschließlich aller mit ihr im Sinne der §§ 15 ff. AktG verbundenen Unternehmen (im weiteren: Vogel Communications Group) meine E-Mail-Adresse für die Zusendung von Newslettern und Werbung nutzt. Auflistungen der jeweils zugehörigen Unternehmen können hier abgerufen werden.
Der Newsletterinhalt erstreckt sich dabei auf Produkte und Dienstleistungen aller zuvor genannten Unternehmen, darunter beispielsweise Fachzeitschriften und Fachbücher, Veranstaltungen und Messen sowie veranstaltungsbezogene Produkte und Dienstleistungen, Print- und Digital-Mediaangebote und Services wie weitere (redaktionelle) Newsletter, Gewinnspiele, Lead-Kampagnen, Marktforschung im Online- und Offline-Bereich, fachspezifische Webportale und E-Learning-Angebote. Wenn auch meine persönliche Telefonnummer erhoben wurde, darf diese für die Unterbreitung von Angeboten der vorgenannten Produkte und Dienstleistungen der vorgenannten Unternehmen und Marktforschung genutzt werden.
Meine Einwilligung umfasst zudem die Verarbeitung meiner E-Mail-Adresse und Telefonnummer für den Datenabgleich zu Marketingzwecken mit ausgewählten Werbepartnern wie z.B. LinkedIN, Google und Meta. Hierfür darf die Vogel Communications Group die genannten Daten gehasht an Werbepartner übermitteln, die diese Daten dann nutzen, um feststellen zu können, ob ich ebenfalls Mitglied auf den besagten Werbepartnerportalen bin. Die Vogel Communications Group nutzt diese Funktion zu Zwecken des Retargeting (Upselling, Crossselling und Kundenbindung), der Generierung von sog. Lookalike Audiences zur Neukundengewinnung und als Ausschlussgrundlage für laufende Werbekampagnen. Weitere Informationen kann ich dem Abschnitt „Datenabgleich zu Marketingzwecken“ in der Datenschutzerklärung entnehmen.
Falls ich im Internet auf Portalen der Vogel Communications Group einschließlich deren mit ihr im Sinne der §§ 15 ff. AktG verbundenen Unternehmen geschützte Inhalte abrufe, muss ich mich mit weiteren Daten für den Zugang zu diesen Inhalten registrieren. Im Gegenzug für diesen gebührenlosen Zugang zu redaktionellen Inhalten dürfen meine Daten im Sinne dieser Einwilligung für die hier genannten Zwecke verwendet werden. Dies gilt nicht für den Datenabgleich zu Marketingzwecken.
Recht auf Widerruf
Mir ist bewusst, dass ich diese Einwilligung jederzeit für die Zukunft widerrufen kann. Durch meinen Widerruf wird die Rechtmäßigkeit der aufgrund meiner Einwilligung bis zum Widerruf erfolgten Verarbeitung nicht berührt. Um meinen Widerruf zu erklären, kann ich als eine Möglichkeit das unter https://contact.vogel.de abrufbare Kontaktformular nutzen. Sofern ich einzelne von mir abonnierte Newsletter nicht mehr erhalten möchte, kann ich darüber hinaus auch den am Ende eines Newsletters eingebundenen Abmeldelink anklicken. Weitere Informationen zu meinem Widerrufsrecht und dessen Ausübung sowie zu den Folgen meines Widerrufs finde ich in der Datenschutzerklärung.