Migrationsleitfaden IsyFact 4.0.x

IFS-Logo Diese Seite ist ein Teil der IsyFact-Standards. Alle Inhalte der Seite, insbesondere Texte und Grafiken, sind urheberrechtlich geschützt. Alle urheberrechtlichen Nutzungs- und Verwertungsrechte liegen beim Bundesverwaltungsamt.

Creative Commons Namensnennung Die Nutzung ist unter den Lizenzbedingungen der Creative Commons Namensnennung 4.0 International gestattet.

Die auf dieser Seite aufgeführten Hinweise sollen der Entwicklung bei der Umstellung einer auf IsyFact 3.x basierenden Anwendung auf IsyFact 4.0.x helfen.

1. Geschäftsanwendung

…​

2. Bausteine

Folgende Bausteine entfallen in IsyFact 4:

  • 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 und isy-security

  • isy-serviceapi-core: HttpInvoker-Schnittstellen müssen durch entsprechende REST-Schnittstellen ersetzt werden (siehe auch Konzept REST/Nutzungsvorgaben REST).

Folgende Bausteine wurden in eigenständige Repositories umgezogen:

  • isy-datetime von ./isyfact-standards/isy-datetime nach https://github.com/IsyFact/isy-datetime/

  • isy-sonderzeichen ./isyfact-standards/isy-sonderzeichen nach https://github.com/IsyFact/isy-sonderzeichen/

  • Beide Bausteine lassen sich weiterhin über die isyfact-standards-bom einbinden und auch die Group- und ArtifactIDs 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.

2.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.

2.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.

2.3. Utilities

In IsyFact 3 wurden die Klassen MessageSourceHolder sowie MessageSourceFehlertextProvider auf deprecated gesetzt.

In der IsyFact 4 muss jede Bibliothek/Anwendung eine eigene org.springframework.context.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:

3. Dokumentation

…​