Release Notes Version 5.x

Ergänzend zu den Release Notes erläutert der Migrationsleitfaden die notwendigen Schritte zur Migration älterer Anwendungen auf das aktuelle Release.

1. Allgemeine Änderungen

keine

2. Referenzarchitektur

2.1. Fachliche Referenzarchitektur

Der Begriff Nachbarsystem wurde definiert und seine Verwendung wurde in der gesamten IsyFact, wo nötig, korrigiert.

2.2. Software-technische Referenzarchitektur

Der Begriff "externes System" wurde definiert und seine Verwendung in der gesamten IsyFact, wo nötig, korrigiert. Die Begrifflichkeiten "internes System" bzw. "interne Anwendung" wurden aus der IsyFact entfernt.

2.2.1. Backend

Die Seiten zur Persistenzschicht enthalten nun die Inhalte des aufgelösten Bausteins JPA/Hibernate:

Die Inhalte wurden gestrafft und Abschnitte, die Dokumentation der verwendeten Produkte wiedergaben, wurden durch Verweise auf die entsprechenden Dokumentationen ersetzt. Grundlegende Erklärungen zu den verwendeten Produkten wurden gänzlich entfernt.

Das bisherige Verbot von "aufrufübergreifendem Caching" wurde durch Empfehlungen für den Einsatz eines Second-Level-Caches ersetzt.

2.2.1.1. Schema-Versionierung

Die bisher angebotene Schema-Versionierung in Form einer Eigenentwicklung wird nicht mehr durch die IsyFact bereitgestellt. Die Schema-Versionierung mit Liquibase wurde konzeptionell erweitert und um Nutzungsvorgaben ergänzt.

2.2.2. Services

Die Nutzung des Begriffs "Webservice" wurde vereinheitlicht und entspricht jetzt der Definition des W3C.

3. Bausteine

3.1. Aufgelöste Bausteine

3.1.1. JPA/Hibernate

Die konzeptionellen Inhalte des Bausteins JPA/Hibernate wurden in die Referenzarchitektur überführt, da die zugehörige Bibliothek isy-persistence zugunsten der direkten Nutzung von Spring Data und Liquibase aufgelöst wurde.

3.2. Verschobene Bausteine

Folgende Bausteine wurden in eigenständige Repositories umgezogen:

Altes Repository Neues Repository

isyfact-standards (Package de.bund.bva.isyfact.persistence.datetime)

isy-datetime-persistence

isyfact-standards (Modul isy-polling)

isy-polling

isyfact-standards (Modul isy-security)

isy-security

isyfact-standards (Modul isy-task)

isy-task

isyfact-standards (Modul isy-util)

isy-util

  • Alle Bausteine lassen sich weiterhin über die isyfact-standards-bom einbinden und auch die Group- und Artifact-IDs bleiben dieselben.

  • Die Version wird allerdings in zukünftigen Releases nicht mehr mit der Version der isyfact-standards synchron gehalten und entwickelt sich entkoppelt davon fort.

3.3. Gelöschte Bausteine

Die folgenden Bausteine wurden aus der IsyFact entfernt. Die folgende Tabelle zeigt, auf welche Bausteine bzw. Konzepte die Anwendungen migrieren müssen.

Entfernter Baustein Migrieren auf

JPA/Hibernate

konzeptionell:

technisch:

  • Standardfunktionen von Spring Data, Spring Boot und Spring

  • Hilfsfunktionen im Baustein Util

4. Deprecations

keine

5. Dokumentation

keine