Zum Hauptinhalt springen

Changelog – Java- & .NET-SDK

Wählen Sie unten Ihr SDK. Die Changelogs folgen dem Format Keep a Changelog und halten sich an Semantic Versioning.

Änderungen am SDK selbst werden hier dokumentiert. Änderungen an der FIT-Connect-Plattform und an den APIs entnehmen Sie den entsprechenden API-Beschreibungen.

Die vollständige Java-SDK-Versionsliste pflegen wir im java-sdk-Repository (alle Module folgen einer gemeinsamen Versionierung über das sdk-bom).

Aktuelle Version: 4.0.0-rc.1 — Highlights:

  • Modulare Neufassung des Java-SDKs unter dev.fitko.fitconnect:
    • sdk-client ersetzt das alte dev.fitko.fitconnect.sdk:client
    • core, rest-clients, virus-scanner, zbp-client, cli als eigene Module
    • sdk-bom für versionssynchrone Einbindung mehrerer Module
  • Neuer Entry-Point FitConnectSdk.fromConfigBuilder() / fromConfigYaml(path)
  • Flaches Rollenmodell statt Sender/Subscriber: sdk.organisation(destinationId, keys) (Verwaltungssystem, Typ A/B) und sdk.onlineService(destinationId, replyKeys) (Onlinedienst, Typ C) ersetzen die frühere Zwischengeneration mit sdk.sender() / sdk.subscriber(). Suche und Verwaltung laufen über sdk.directory() (Routing, Schlüssel-Lookup — unauthentifiziert) und sdk.manage() (Destinations, Anhänge). Jede Partei ist selbst eine Destination — auch ein reiner Sender braucht seit dieser Umstellung eine eigene Destination-ID.
  • OutgoingSubmission.to(participant) / OutgoingReply.answering(...) ersetzen SubmissionRequest.Builder() / ReplyRequest.forCase(...); Participant + Addressing kapseln Empfänger und Verwaltungsleistung bzw. Prozessnachricht.
  • Eine Credential-Paarung für Senden und Empfangen — senderConfig/subscriberConfig in der YAML-Konfiguration entfällt; private Schlüssel werden nicht mehr über die Konfiguration, sondern als Argument beim Erzeugen von Organisation/OnlineService übergeben.
  • Java 21 als Mindestversion
  • Attachment-API vereinheitlicht: fromBytes, fromFile, fromStreamSupplier, Attachment.builder().shouldBeChunked(true).build()
  • Alte v3.x-Klassen (SendableSubmission, ClientFactory.createSenderClient, ApplicationConfigLoader) sind durch OutgoingSubmission/OutgoingReply, FitConnectSdk und YAML-Loader ersetzt
  • Kein Auto-Reject mehr (seit 4.0.0-rc.1, vorher noch enableAutoReject): receive(...) liefert immer einen ReceiveReport; Annahme/Ablehnung ist immer der explizite Aufruf von accept(...)/reject(...) durch das Fachverfahren — siehe Konzept: Der Prüfbericht

Vollständige Methodenreferenz des aktuellen Stands: Spickzettel (Java). Eine ausführliche Versionshistorie der älteren v3-Linie finden Sie unter Java-SDK Changelog (Archiv).

Migration von älteren SDK-Versionen

Wenn Sie noch das Java-SDK 3.x (dev.fitko.fitconnect.sdk:client) oder die alte FitConnect-NuGet-Bibliothek verwenden, sind die meisten Konzepte gleich geblieben, die Klassennamen jedoch durchgängig anders. Den Umstiegspfad für Java beschreibt die MIGRATION.md im Repository (Gegenüberstellung 3.x → 4.x, Checkliste); für .NET dienen die Beispielprojekte (Fitko.FitConnect.Examples) als Vorlage.

Die bisherige Dokumentation der älteren Generationen bleibt als Archiv erreichbar: Java-SDK 3.x · .NET-SDK (FitConnect-NuGet) — in der Seitenleiste unter „Archiv: ältere SDK-Versionen“.