Migrationsleitfaden IsyFact 4.0.0
Die auf dieser Seite aufgeführten Hinweise sollen der Entwicklung bei der Umstellung einer auf IsyFact 3.x basierenden Anwendung auf IsyFact 4.0.0 helfen.
1. Bausteine
Folgende Bibliotheken entfallen ab IsyFact 4.0:
-
isy-aufrufkontext: wird mit dem Wegfall der HttpInvoker nicht länger benötigt -
isy-konfiguration: ersetzt durch Bordmittel von Spring, beschrieben in der Referenzarchitektur von Backends -
isy-sicherheit: ersetzt durch Spring Security OAuth2 undisy-security -
isy-serviceapi-core: HttpInvoker-Schnittstellen müssen durch entsprechende REST-Schnittstellen ersetzt werden (siehe auch Konzept REST/Nutzungsvorgaben REST).
1.1. Security
Method Security ist in der IsyFact 4 version von isy-security standardmäßig nicht mehr aktiviert und muss durch Setzen der @EnableMethodSecurity- Annotation an einer @Configuration-Klasse aktiviert werden.
Detaillierte Konfigurationsmöglichkeiten sind den Nutzungsvorgaben Security und der Spring Security Dokumentation zu entnehmen.
1.2. Überwachung
In IsyFact 3 muss die Absicherung der Endpoints aus den Nutzungsvorgaben abgeleitet und pro Anwendung implementiert werden.
In IsyFact 4 stellt der Baustein isy-ueberwachung über die AutoConfiguration eine
Standardabsicherung für Endpoints und entsprechende Konfigurationsparameter bereit.
Eine detaillierte Beschreibung zur Konfiguration und Anpassungsmöglichkeiten sind in den Nutzungsvorgaben Überwachung zu finden.
1.3. Utilities
In IsyFact 3 wurden die Klassen MessageSourceHolder sowie MessageSourceFehlertextProvider auf deprecated gesetzt.
In der IsyFact 4 muss jede Bibliothek/Anwendung eine eigene MessageSource-Bean für die Verwaltung von Nachrichten implementieren.
Wenn Bedarf zur Anpassung der Nachrichten besteht, muss die jeweilige MessageSource-Bean mittels Spring-Bordmitteln überschrieben werden.
Für Fehlermeldungen wird empfohlen, das Interface de.bund.bva.isyfact.exception.FehlertextProvider aus isy-exception-core zu implementieren.
Weiterführende Informationen unter: