#1865: CarddavTestClient.kt

Dies ist ein Entwicklungs-Debugging-Werkzeug, kein Komponententest. Es hat einen main()-Einstiegspunkt und fungiert als eigenständiger CardDAV-Client zum Testen der Serverimplementierung. Die Datei enthält umfangreichen auskommentierten Code, der die Entwicklung der CardDAV-Protokolltests zeigt.

Importe und Abhängigkeiten

Klassenstruktur: CardDavTestClient

Konstruktorparameter

• baseUrl: String — Basis-URL des Servers (Standard: http://localhost:8080/carddav)
• username: String — CardDAV-Benutzername für die Basisauthentifizierung
• password: String — CardDAV-Passwort (DAV-Token)
• lastSyncToken: String? — Optionales Sync-Token für inkrementelle Synctests

Innere Klasse: ResponseData

Einfache Datenklasse, die content: String, status: Int und headers: String aus HTTP-Antworten enthält.

Authentifizierung

Verwendet die HTTP-Basisauthentifizierung mit dem Header Authorization: Basic {base64(benutzername:passwort)}, der einmalig bei der Initialisierung erstellt wird.

Antwort-Handler

Ein funktionaler HttpClientResponseHandler, der die Antwort-Entität als UTF-8-Text liest und den Statuscode sowie die Header extrahiert.

Wichtige Methoden

run() — Standard-Testsequenz

Führt einen CardDAV-Protokollablauf aus: OPTIONS → GET (VCard) → GET (Foto). Der Großteil des ursprünglichen Testcodes (PROPFIND, REPORT, Sync-Collection) ist auskommentiert, wobei XML-Anfragekörperbeispiele als Referenz erhalten bleiben.

fetchAllVCards() — Batch-VCard-Export

Ruft alle VCards vom Server mithilfe einer CardDAV addressbook-query REPORT-Anfrage ab, speichert jede VCard unter /tmp/carddav-vcards/ und analysiert PHOTO-Einträge. Meldet Statistiken zu:

• JPEG/PNG/GIF-URL-Referenzen vs. eingebettete Base64-Bilder
• Kontakte ohne Foto
• Fehleranzahlen

Diese Methode war maßgeblich am Debuggen der CardDAV-Fotobehandlung (URL- vs. eingebetteter Modus) beteiligt.

sendRequest() — Generische HTTP-Anfrage

Erstellt und führt HTTP-Anfragen mit konfigurierbarer Methode, Pfad, Körper, Authentifizierung und Protokollierung aus. Verwendet ClassicRequestBuilder von Apache HttpClient 5.

analyzePhoto(vcard) — PHOTO-Eigenschafts-Parser

Analysiert VCard-Daten, um den Fotokodierungsmodus zu bestimmen:

• URL-Modus: PHOTO;VALUE=URI:https://... — Foto wird über URL bereitgestellt
• Eingebetteter Modus: PHOTO;ENCODING=b;TYPE=JPEG:base64daten... oder data:image/jpeg;base64,...

Main-Funktion — CLI-Schnittstelle

Verwendung: CardDavTestClient <benutzername> <dav-token> [--fetch-all]
  --fetch-all: Alle VCards vom Server abrufen und unter /tmp/carddav-vcards/ speichern

Positionsargumente: Benutzername, DAV-Token, optionale Basis-URL, optionales Sync-Token.

Anfrage mit Methode=OPTIONS für Milton (uri=/users/benutzername/, session-id=null)
Basisauthentifizierung fehlgeschlagen, Header 'authorization' nicht gefunden.
PROPFIND-Aufruf erkannt: /users/benutzername/
PROPFIND für Milton (uri=/users/benutzername/addressBooks/default/
REPORT für Milton (uri=/users/benutzername/addressBooks/default/