Migrationsleitfaden IsyFact 2

Die Konfiguration von Spring wird von XML auf Java-Config umgestellt.

Für die betriebliche Konfiguration wird die Datei application.properties anlegt.

Die Bereitstellung von Konfigurationsparametern innerhalb der Geschäftsanwendung erfolgt über @ConfigurationProperties-Klassen. Soll die Bibliothek isy-konfiguration weiterhin verwendet werden, muss die Bean aus der Spring-Konfiguration entfernt werden. Die Liste mit den Property-Dateien wird nach application.properties übertragen.

Für eine auf IsyFact 2.x basierende Anwendung wird eine Applikationsklasse im Root-Package der Anwendung erstellt.

@SpringBootApplication
public class IsyFact2Application extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(IsyFact2Application.class);
    }
}

Verwendung der Annotation SpringBootTest bei den Unit-Tests

@RunWith(SpringRunner.class)
@SpringBootTest(classes = RaumplanungApplication.class)
@TestExecutionListeners({DependencyInjectionTestExecutionListener.class, TransactionDbUnitTestExecutionListener.class})
@DatabaseSetup("testdatensatz.xml")
public class EintragControllerTest {

}

Die Spring-Konfiguration für die Persistenz muss geändert werden (EntityManager, DataSource). Ebenso wird die betriebliche Konfiguration aus jpa.properties nach application.properties übertragen.

Sollen die alten DAOs aus isy-persistence weitergenutzt werden, dann sind diese als Beans in Java-Config zu übernehmen.

Die Konfiguration des Logging-Frameworks erfolgt über logback.xml und zusätzliche Properties in application.properties.

Der LogbackConfigListener entfällt komplett, d.h. die Abhängigkeit in pom.xml und die Konfiguration in web.xml sind nicht notwendig.

Interceptoren für System- und Komponentengrenzen und der LogApplicationListener werden per Autokonfiguration erstellt und müssen aus der Spring-Konfiguration entfernt werden. Die System- und Komponentengrenzen werden nicht über manuell konfigurierte Pointcuts, sondern über die Annotation @Systemgrenze und @Komponentengrenze festgelegt.

Die Konfiguration der Interceptoren für das Logging an System- und Komponentengrenzen über Properties in application.properties erfolgt, falls abweichend von der Default-Konfiguration, nach dem Schema:

Die Konfiguration des LogApplicationListener erfolgt über Properties in application.properties:

isy.logging.anwendung.name=Anwendung
isy.logging.anwendung.version=2.0.0
isy.logging.anwendung.typ=GA

Über einen Eintrag in applicaton.properties ist das Performance Logging zu aktivieren.

isy-ueberwachung setzt Spring Boot Actuator und micrometer ein.

Die Überwachungsinformationen für Services werden über micrometer bereitgestellt. Die eigentliche Überwachung erfolgt über einen AOP-Advice. Dieser wird per Java-Config konfiguriert:

Die Implementierung von Ping- und Prüfmethoden wird über HealthIndicator realisiert.

Die Verbindung zur Datenbank wird von einem HealthIndicator aus isy-persistence überwacht. Eine eventuell vorhandene manuelle Prüfung kann entfernt werden.

Das Loadbalancer-Servlet wird automatisch konfiguriert und der Eintrag in web.xml kann entfernt werden.

Die Konfiguration (Polling-Cluster und JMX-Verbindungen) müssen nach application.properties überführt werden.

Die Beans für den Polling-Verwalter und die Interceptoren für @PollingAktion müssen entfernt werden.

Die Spring-Konfiguration muss in Java-Config überführt werden. Eine gesonderte Konfiguration des Anwendungskontextes für den Batchrahmen ist nicht zwingend notwendig. Um Beans aus der Spring-Konfiguration der Anwendung für die Ausführung eines Batches auszuschließen, kann die Annotation (@ExcludeFromBatchContext) verwendet werden.

In den Property-Dateien zur Konfiguration der Batches werden statt XML-Konfigurationsdateien, die vollqualifizierten Namen der Java-Konfigurationsklassen eingetragen.

In allen Bausteinen (isy-util, isy-sonderzeichen, isy-exception, …​) der IsyFact Bibliothek ìsyfact-standards haben sich die bisherigen Packages von

de.bund.bva.pliscommon.{baustein}

de.bund.bva.isyfact.{baustein}

Die Bibliothek isy-standards benutzt nicht mehr isyfact-masterpom-lib, sondern nunmehr isyfact-standards als <parent> in der pom.xml.

Bei der Überführung in Java-Config können bestimmte Beans entfernt werden. Automatisch konfiguriert werden die @Gesichert-Annotation, die AufrufKontextFactory und die Thread-Scopes thread und request für Spring.

In der Anwendung müssen die Beans für AufrufKontextVerwalter, Sicherheit und AccessManager konfiguriert werden.

Die Konfiguration des Caches für Authentifizierungen erfolgt in application.properties.

Die Konfiguration der HttpInvoker muss nach Java-Config überführt werden.

Beans vom Typ HttpInvokerServiceExporter werden automatisch von Spring Boot konfiguriert. Der Pfad für das Mapping wird vom Namen der Bean abgeleitet.

@Configuration
public class ServiceConfiguration {

    @Bean(name = "/AuskunftBean_v1_0")
    public HttpInvokerServiceExporter meldung() {
        // ...
    }

}

Detailkonzept Web-GUI (nur noch technologieübergreifende Themen),

Konzept,

Nutzungsvorgaben,

Konzept Angular,

Nutzungsvorgaben Angular.

IT-Grundschutz

OWASP Top 10 Project