#1865: CarddavTestClient.kt

Это инструмент отладки разработчика, а не модульный тест. Он имеет точку входа main() и работает как автономный CardDAV-клиент для тестирования реализации сервера. Файл содержит обширный закомментированный код, показывающий эволюцию тестирования протокола CardDAV.

Импорты и зависимости

Структура класса: CardDavTestClient

Параметры конструктора

• baseUrl: String — Базовый URL сервера (по умолчанию: http://localhost:8080/carddav)
• username: String — Имя пользователя CardDAV для Basic-аутентификации
• password: String — Пароль CardDAV (DAV-токен)
• lastSyncToken: String? — Опциональный токен синхронизации для тестирования инкрементальной синхронизации

Внутренний класс: ResponseData

Простой класс данных, содержащий content: String, status: Int и headers: String из HTTP-ответов.

Аутентификация

Использует HTTP Basic Authentication с заголовком Authorization: Basic {base64(username:password)}, формируемым один раз при инициализации.

Обработчик ответов

Функциональный HttpClientResponseHandler, который читает сущность ответа как текст в кодировке UTF-8 и извлекает код статуса и заголовки.

Ключевые методы

run() — Стандартная тестовая последовательность

Выполняет поток протокола CardDAV: OPTIONS → GET (VCard) → GET (фото). Большая часть исходного тестового кода (PROPFIND, REPORT, sync-collection) закомментирована, но примеры XML-тел запросов сохранены для справки.

fetchAllVCards() — Пакетный экспорт VCard

Загружает все VCard с сервера с помощью запроса REPORT addressbook-query CardDAV, сохраняет каждую VCard в /tmp/carddav-vcards/ и анализирует записи PHOTO. Выводит статистику по:

• Ссылки на URL JPEG/PNG/GIF против встроенных изображений base64
• Контакты без фото
• Количество ошибок

Этот метод сыграл ключевую роль в отладке обработки фото в CardDAV (режимы URL и встроенных изображений).

sendRequest() — Универсальный HTTP-запрос

Формирует и выполняет HTTP-запросы с настраиваемым методом, путём, телом, аутентификацией и логированием. Использует ClassicRequestBuilder из Apache HttpClient 5.

analyzePhoto(vcard) — Парсер свойства PHOTO

Анализирует данные VCard для определения режима кодирования фото:

• Режим URL: PHOTO;VALUE=URI:https://... — фото предоставляется по URL
• Встроенный режим: PHOTO;ENCODING=b;TYPE=JPEG:base64data... или data:image/jpeg;base64,...

Главная функция — CLI-интерфейс

Использование: CardDavTestClient <имя_пользователя> <dav-токен> [--fetch-all]
  --fetch-all: Загрузить все VCard с сервера и сохранить в /tmp/carddav-vcards/

Позиционные аргументы: имя пользователя, DAV-токен, опциональный базовый URL, опциональный токен синхронизации.

Запрос с методом=OPTIONS для Milton (uri=/users/username/, session-id=null)
Ошибка базовой аутентификации, заголовок 'authorization' не найден.
Обнаружен вызов PROPFIND: /users/username/
PROPFIND для Milton (uri=/users/username/addressBooks/default/
REPORT для Milton (uri=/users/username/addressBooks/default/