Zum Hauptinhalt springen

Änderungshistorie DVDV-Bibliothek für Java™

Änderungen V 2.16.1 - 2.18.0 (18.02.2026)​

  • DVDVAG-249/DVDV2-2456: Das Interface de.dvdv2.object.Certificate bietet zwei neue Methoden getRevocationDate() und getRevocationReason(), an denen Ihr Code etwaige Zertifikatswiderrufsinformationen abfragen kann. Falls das Zertifikat ein solches revocationDate hat, werfen die Funktionen getContent(), getEncoded() und readCertificate() eine entsprechende Exception der neuen Klasse CertificateRevokedDVDVException.
  • Bibliotheken-Updates: commons-lang3 3.20.0, commons-codec 1.21.0, kotlin-stdlib-jdk8 2.2.21, gson 2.13.2, bcprov-jdk18on 1.83, keycloak-core 26.5.0, retrofit 3.0.0, log4j2 2.25.3, jakarta.mail 2.0.2, java-jwt 4.5.1
  • Ab jetzt wird Java™ ab Version 17 vorausgesetzt.

Änderungen V 2.16.0 - 2.16.1 (31.07.2025)​

  • Verschiedene Library-Updates, darunter: retrofit 2.11.0, bcprov-jdk18on 1.81
  • DVDVSP-195/DVDV2-2323: Seit Version 2.16.0 gab es versehentlich eine compile-dependency zu bcprov-jdk15on. Diese ist entfernt zugunsten von bcprov-jdk18on. Letzere war bisher runtime-dependency.

Änderungen V 2.13.0 - 2.16.0 (08.07.2025)​

  • DVDV2-2032: Sie können zur standalone-Authentifizierung jetzt auch Zertifikate nutzen, die einen Signaturalgorithmen mit Elliptischen Kurven nutzen, genauer: SHA256withECDSA, SHA384withECDSA oder SHA512withECDSA. Die bisher unterstützten Signaturalgorithmen funktionieren unverändert weiter, das sind: SHA1withRSA, SHA384withRSA, SHA512withRSA, RSASSA-PSS.
  • DVDV2-2286: Die Klasse de.dvdv2.object.OrganizationCategory enthält jetzt die Property prefix mit dem sogenannten Kategorienpräfix, also z.B. 'ubb' für 'Untere Bauaufsichtsbehörde'.
  • Die beiden Maven-Artefakte dvdv-api und dvdv-impl haben jetzt eine neue maven dependency zu dvdv-devkit-java-parent.

Änderungen DVDV-Server 2.15.0 (unabhängig von DVDV-Bibliotheksversionen)​

Die folgende Änderung betrifft den DVDV-Server und ist daher unabhängig von der eingesetzten Version des DVDV-Bibliothek.

  • DVDV2-2270: Die Rückgabe der in 2.8.0 / DVDV2-1898 eingebauten Methode DVDVManager.getCategories zur Abfrage des Kategorienbaums ist jetzt auf allen Baumebenen alphabetisch sortiert. Bisher war die Reihenfolge undefiniert bzw. von Implementierungsdetails abhängig.

Änderungen V 2.11.0 - 2.13.0 (20.09.2024)​

  • DVDV2-2221/DVDVAG-335: Die Methode de.dvdv2.message.FindOrganizationDescriptionsRequest.getOrganizationKey() hatte bisher fehlerhafterweise stets null zurück geliefert. Ab jetzt liefert diese Methode korrekt den Organisationsschlüssel, den Sie vorher mit dem entsprechenden setter gesetzt haben.
  • DVDV2-2224/DVDVSP-162: Wenn Ihr DVDV-Server (etwa aufgrund betrieblicher Probleme) eine HTTP-Response mit Code 500 ("Internal Server Error") liefert, so hat die DVDV-Bibliothek bisher fälschlicherweise standardmäßig kein Failover zum Vertretungssserver versucht. Ab jetzt findet in dieser Situation korrekt ein Failoverversuch statt. Workround: Für ältere Bibliotheksversionen können Sie mit der System-Property dvdv2.force.failover.code.500=true das korrekte Verhalten erreichen.

Änderungen V 2.10.0 - 2.11.0 (06.05.2024)​

  • DVDV2-2120: Neue Utility-Methode de.dvdv2.object.Certificate.readCertificate(), liefert das Zertifikat als Instanz der Klasse java.security.cert.X509Certificate.
  • CR48/DVDV2-2069: Die DVDV-Bibliothek nutzt jetzt die in DVDV-Server 2.11.0 eingeführte Schnittstelle in der Version "v2". Diese Änderung ist für die Anwendung transparent, sollte also nicht zu Verhaltensänderungen führen. Die Änderung betrifft nur die von der Bibliothek gekapselten HTTP-Requests: Bei einem Aufruf der Methode DVDVManager.findOrganizationDescription oder DVDVManager.findServiceDescription wird dann, wenn es keine Treffer gibt, der Server nicht mehr mit dem Response-Code 404 (NOT_FOUND) sondern mit dem Response-Code 204 (NO_CONTENT) antworten.

Änderungen V 2.5.0 - 2.10.0 (14.12.2023)​

  • Bibliotheken-Updates: keycloak-core 22.0.4, bouncycastle 1.76, commons-codec 1.16.0, java-jwt 3.19.4, okhttp 4.12.0
  • DVDV2-1958: Neue Methode DVDVManager.findOrganizationDescriptions. Diese ist vergleichbar mit der bisherigen DVDVManager.findOrganizationDescription, funktioniert aber ohne Angabe eines Kategoriennamens und kann deshalb im Prinzip mehr als eine Organisation zurückliefern.
  • DVDV2-1898: Neue Methode DVDVManager.getCategories zur Abfrage des Kategorienbaums
  • DVDV2-1898: Neue Methode DVDVManager.findServiceSpecificationUrisByCategory zur Abfrage aller Dienstbeschreibungs-URIs, die der angegebenen Organisationskategorie zugeordnet sind.
  • DVDV2-1945: Neue Methode DVDV2ServerConnectionParamsBuilderStandalone.withCertificateAndPrivateKeyAfterChange. Mit dieser können Sie ein alternatives Zertifikat zusammen mit einem ungefähren Wechseltermin angeben. Die DVDV-Bibliothek wird dann zur Authentifizierung am DVDV-Server nötigenfalls beide Zertifikate ausprobieren. Der ungefähre Wechseltermin legt fest, welches der beiden Zertifikate bevorzugt wird: Vor dem ungefähren Wechseltermin ist es das mit DVDV2ServerConnectionParamsBuilderStandalone.withCertificateAndPrivateKey angegebene und nach dem ungefähren Wechseltermin das alternative. Falls Sie das controlfile-Beispiel nutzen, so ist dort im Zuge dieser Änderung eine Modifikation der Konfigurationsdateien nötig.
  • DVDV2-2024: Neue Methode LightweightOrganization.getLocationStateId gibt den Länderschlüssel des Bundeslandes an, in dem die Organisation ihren Sitz hat.