Java-Anwendungen modernisieren

Online bearbeiten

Sie können Ihre Java-Unternehmensanwendungen, einschließlich WebSphere® Application Server herkömmlicher Anwendungen, auf Liberty modernisieren. Um eine Anwendung zu modernisieren, laden Sie zunächst einen Migrationsplan hoch oder erstellen und analysieren Ihre Anwendung und beheben dann Ihre Anwendungsprobleme.

Beginnend mit der Version 1.1 können Sie Application Modernization Accelerator Developer Tools mit Anwendungen verwenden, die mit Nicht-Maven-Tools erstellt wurden, allerdings mit Einschränkungen. Weitere Informationen finden Sie unter Anwendungen, die mit Nicht-Maven-Build-Tools erstellt wurden.

Vorbereitende Schritte

  1. Richten Sie Ihre Java-Unternehmensumgebung ein.
  2. Installieren Sie das Visual Studio Code Erweiterung, das Eclipse IDE Plug-in oder das IntelliJ IDEA IDE Plug-in.
Eclipse IDEW ichtig: Um bei einer Anwendung mit mehreren Modulen ( Java ) optimale Ergebnisse zu erzielen, stellen Sie sicher, dass Sie das Aggregatormodul und jedes Submodul als separate Projekte in den Arbeitsbereich Eclipse importieren. Wenn Sie das Top-Level-Verzeichnis als einzelnes Projekt importieren, kann es sein, dass IBM Application Modernization Accelerator Developer Tools Ihr Projekt nicht erfolgreich untersuchen kann.

Führen Sie entweder die Schritte zum Hochladen Ihres Anwendungsmigrationsplans oder die Schritte zum Analysieren Ihrer Anwendung aus. Nachdem Sie einen Satz von Schritten abgeschlossen haben, können Sie Probleme mit der Migration beheben. Die Schritte zur Behebung der Probleme sind bei den Schritten des Migrationsplans und der Anwendungsanalyse gleich. Nachdem Sie die Probleme behoben haben, haben Sie eine modernisierte Anwendung.

Wenn Sie auf ein Problem stoßen, das verwendet Application Modernization Accelerator Developer Tools, lesen Sie die Seite zur Fehlerbehebung.

Zeitbedarf für die Analyse Ihres Codes

Die Zeit, die für die Analyse Ihrer Bewerbung benötigt wird, ist unterschiedlich lang. Die folgenden Zeiten sind typisch.

Tabelle 1. Zeitaufwand für die Analyse
Zeit Anwendungsdetails
Sekunden bis ein paar Minuten Weniger als 100 Klassen
2 bis 10 Minuten 20.000 bis 50.000 Zeilen Code
10 oder mehr Minuten 300.000 Zeilen Code
Wichtig:

Wenn Application Modernization Accelerator Developer Tools Ihre Anwendung analysiert, werden einige Pakete von Drittanbietern standardmäßig von der Codeanalyse ausgeschlossen. Weitere Informationen finden Sie unter Drittanbieterpakete, die von der Anwendungsanalyse ausgeschlossen sind.

Verwendung eines Migrationsplans zur Modernisierung Ihrer Anwendung

Die folgenden Schritte setzen voraus, dass Sie zur Erstellung eines IBM Application Modernization Accelerator Migrationsplans verwenden. Der Migrationsplan enthält eine Liste von Modernisierungsfragen, die angegangen werden müssen. Sie enthält auch automatisch generierte Konfigurationsinformationen, damit die Anwendung unter Liberty ordnungsgemäß funktioniert.

Wichtig:
  • Wenn Sie bereits einen Migrationsplan für Ihr Projekt hochgeladen und analysiert haben, wird durch das Hochladen eines neuen Migrationsplans die vorhandene Analyse überschrieben.
  • Bevor Sie Ihre Anwendung modernisieren, sollten Sie einen vollständigen Build Ihrer Anwendung durchführen, um sicherzustellen, dass Sie von einem bekannt guten Anwendungs-Build ausgehen. Mit diesem Build wird auch sichergestellt, dass die Klassendateien auf dem neuesten Stand des Quellcodes sind. Sie müssen auf dem neuesten Stand sein, bevor Sie Automatisierungen ausführen, die Änderungen für Java Versions-Upgrades hinzufügen.

Wenn Sie die Änderungen an Ihrem Code rückgängig machen, müssen Sie auf „Zurück zum Hochladen/Analysieren“ klicken und eine vollständige Analyse durchführen, wenn Sie Ihre Anwendung erneut modernisieren möchten.

  1. Klicken Sie in Ihrer IDE mit der rechten Maustaste auf ein beliebiges Element in der Hierarchie im Verzeichnis der Anwendung, die Sie modernisieren möchten, klicken Sie auf Modernize Java Applicationsund klicken Sie dann auf Modernisieren auf Liberty.
  2. Laden Sie auf der Seite <Name Ihrer Anwendung> modernisieren den Migrationsplan hoch.

    Die IDE analysiert Ihren Projektordner, sammelt Informationen über Ihre Anwendung und lädt dann den Migrationsplan hoch, den Application Modernization Accelerator erstellt.

    1. Klicken Sie auf Migrationsplan hochladen.
    2. Wählen Sie den Anwendungsplan für die Archivdatei aus der Liste aus und klicken Sie auf Öffnen.

      Wenn der Prozess zum Hochladen des Migrationsplans abgeschlossen ist, werden auf der Seite Modernize <Ihr Anwendungsname> die folgenden Konfigurationsdateien angezeigt, die im Plan enthalten sind:

      • server.xml ist die Konfigurationsdatei für Liberty und wird benötigt, um Ihre Anwendung zu starten.
      • Containerfile ist nur erforderlich, um ein Container-Image für Ihre Liberty Anwendung zu erstellen.

    3. Wählen Sie die Dateien aus, die Sie zu Ihrem Projekt hinzufügen möchten, und klicken Sie auf " Weiter".

      • (Erforderlich) Wählen Sie die Datei server.xml .
      • (Optional) Wählen Sie die Datei Containerfile nur, wenn Sie ein Container-Image für Ihre Anwendung Liberty erstellen.

    Wenn der Upload des Migrationsplans abgeschlossen ist, werden die zu behebenden oder zu überprüfenden Probleme angezeigt.

  3. Wenn die Analyse JAX-RPC Dienste in Ihrer Anwendung entdeckt, folgen Sie den Anweisungen auf dem Bildschirm, um JAX-RPC Dienste in JAX-WS Dienste zu migrieren.

  4. Behebung von Problemen mit der Anwendung.

    Je nach den zu behebenden Problemen kann die Behebung automatisiert oder selbstgesteuert erfolgen. Die Probleme auf der Registerkarte Zusätzliche Informationen erfordern keine Codeänderung, aber Sie müssen sie möglicherweise überprüfen oder testen und gegebenenfalls eine Codeänderung vornehmen.

Analyse Ihrer Anwendung, um sie zu modernisieren

Bei den folgenden Schritten wird davon ausgegangen, dass Sie Ihre Anwendung analysieren und nicht einen Application Modernization Accelerator Migrationsplan zur Modernisierung Ihrer Anwendung verwenden. Die Analyse liefert Ihnen eine Liste der zu behebenden Probleme und eine begrenzte Serverkonfiguration in der Datei server.xml . Die Datei server.xml enthält eine Liste der Funktionen, die Ihre Anwendung verwendet, aber sie enthält keine anderen Konfigurationsinformationen wie Datenbankverbindungen oder JMS-Konfigurationen.

Wenn Sie die Änderungen an Ihrem Code rückgängig machen, müssen Sie auf „Zurück zum Hochladen/Analysieren“ klicken und eine vollständige Analyse durchführen, wenn Sie Ihre Anwendung erneut modernisieren möchten.

  1. Klicken Sie in Ihrer IDE mit der rechten Maustaste auf das Verzeichnis, das Sie modernisieren möchten, klicken Sie auf Modernize Java Applications und dann auf Modernisieren nach Liberty.

  2. Erweitern Sie auf der Seite <Name der Anwendung> modernisieren die Option Anwendung analysieren, und klicken Sie auf Analyse starten.

  3. Wählen Sie die Analyseparameter, die die Regeln definieren, nach denen der Anwendungsserver analysiert wird.

    1. Wählen Sie die Anwendungsserverquelle und das Anwendungsserverziel aus.

    2. Optional können Sie die Quelle Java SE ändern, die automatisch mit einem empfohlenen Wert angezeigt wird.

      Der empfohlene Wert basiert auf der Java SE-Version, die Application Modernization Accelerator Developer Tools für die Anwendungsserverquelle empfiehlt. Ihr Anwendungsserver verwendet möglicherweise eine andere Java SE-Version als die empfohlene. Wenn dies der Fall ist, ändern Sie den Quellcode von Java SE auf die Version, die Ihr Anwendungsserver verwendet.

      Beispielsweise empfiehlt Java SE 8 für Application Modernization Accelerator Developer ToolsWebSphere Application Server V8.5.5, auch wenn Ihr Anwendungsserver möglicherweise eine frühere Version von Java SE verwendet.

      Wichtig: Die von Java unterstützte Mindestversion ist Java 5.

    3. Wählen Sie das Ziel Java SE.

    4. Erstellen Sie die Anwendung und analysieren Sie sie anschließend.

      Die Analyse der Anwendung erfolgt in der Binärdatei der Anwendung. Die Anwendung muss vor Beginn der Analyse erstellt werden.

      • Bei Maven-Builds können Sie die Anwendung entweder manuell oder automatisch erstellen.

        Klicken Sie entweder auf Analysieren, nachdem Sie die Anwendung manuell erstellt haben, oder auf Erstellen und Analysieren, um die Anwendung automatisch zu erstellen und zu analysieren.

        Nachdem Ihre Anwendung erstellt und analysiert wurde, werden die zu behebenden oder zu überprüfenden Probleme angezeigt.

        Wenn Sie auf Erstellen und analysieren klicken, wird die Anwendung mit der aktuellen Java Quellversion erstellt, so dass sie auf Java Upgrade-Probleme analysiert werden kann. Stellen Sie sicher, dass Sie die IDE mit dem Java developer kit der Java Quellversion konfigurieren, damit die IDE die Anwendung erfolgreich erstellen kann.

      • Für Builds, die nicht Maven verwenden, erstellen Sie die Anwendung manuell, wählen Sie die Anwendungsbinärdatei aus und klicken Sie dann auf Analysieren.

        Nachdem Ihre Anwendung erstellt und analysiert wurde, werden die zu behebenden oder zu überprüfenden Probleme angezeigt.

  4. Wenn die Analyse JAX-RPC Dienste in Ihrer Anwendung entdeckt, folgen Sie den Anweisungen auf dem Bildschirm, um JAX-RPC Dienste in JAX-WS Dienste zu migrieren.

  5. Behebung von Problemen mit der Anwendung.

    Bei Maven-Builds kann je nach den zu behebenden Problemen die Fähigkeit zur Behebung automatisiert oder selbstgesteuert sein.

    Da IBM Application Modernization Accelerator Developer Tools keine Automatisierungen für Builds ausführen kann, die nicht Maven verwenden, sind die zu behebenden Probleme selbst zu lösen.

    Die Probleme auf der Registerkarte Zusätzliche Informationen erfordern keine Codeänderung, aber Sie müssen sie möglicherweise überprüfen oder testen und gegebenenfalls eine Codeänderung vornehmen.

Migration der Dienste von JAX-RPC auf die Dienste von JAX-WS

Ab der Version IBM Application Modernization Accelerator Developer Tools 1.1 können Sie erkannte JAX-RPC -Dienste auf JAX-WS -Dienste modernisieren, bevor Sie andere Modernisierungsprobleme angehen.
Wichtig:
  • Wenn Sie auf Jakarta EE 9 oder eine spätere Jakarta EE-Version migrieren, migrieren Sie zuerst Ihre JAX-RPC -Dienste auf JAX-WS -Dienste. Andernfalls kann Ihnen der JAX-RPC source migration helper nicht helfen, da die JAX-RPC Dienste ab Jakarta EE 9 nicht mehr verfügbar sind.
  • Sie müssen auch die Dienste von JAX-RPC auf JAX-WS migrieren, bevor Sie andere Modernisierungsmaßnahmen durchführen. Wenn Sie zuerst andere Modernisierungskorrekturen durchführen, wird Java EE möglicherweise auf eine Version aktualisiert, die die Dienste von JAX-RPC nicht unterstützt.

Migrieren Sie entweder manuell die Dienste von JAX-RPC zu JAX-WS oder klicken Sie auf Fortfahren. Wenn Sie auf " Fortfahren" klicken, unterstützt Sie die Quellmigrationshilfe JAX-RPC zu JAX-WS bei der Migration.

Bei den folgenden Schritten wird davon ausgegangen, dass Sie auf Fortfahren geklickt haben.

  1. Vervollständigen Sie alle Korrekturen für die Dateien .wsdl .

    Die Migration von JAX-RPC erfordert, dass Sie alle Korrekturen für eine Datei .wsdl abschließen, bevor Sie an einer anderen Datei .wsdl in der Liste arbeiten.

    Die folgenden Informationen werden auf der Hauptseite der Migration JAX-RPC angezeigt. Verwenden Sie es, um die Migration abzuschließen.
    Erneut starten
    Wenn Sie die Migration neu starten möchten, klicken Sie auf Neu starten.
    Wichtig:
    • Wenn Sie auf Neustart klicken, wird eine Meldung angezeigt, die besagt, dass Sie, wenn Sie die Migration neu starten möchten, alle Codeänderungen rückgängig machen müssen, die mit automatischen Korrekturen und manuellen Korrekturen vorgenommen wurden. Wenn Sie nicht alle Änderungen rückgängig machen und die Migration neu starten, werden .wsdl Dateien, für die Sie zuvor Automatisierungen ausgeführt haben, im Abschnitt Nicht unterstützt (manuelle Migration erforderlich) angezeigt.
    • Wenn Sie die Migration von JAX-RPC neu gestartet haben, ohne Ihre Codeänderungen rückgängig zu machen, klicken Sie erneut auf Neustart. Kehren Sie zu einer Version des Anwendungscodes zurück, die existierte, bevor Sie den JAX-RPC Fluss durch automatische oder manuelle Aktualisierungen oder beides geändert haben.
    Anstehend
    Wenn Sie einen Abschnitt "Ausstehend" haben, in dem eine oder mehrere .wsdl Dateien aufgelistet sind, wählen Sie diesen Abschnitt aus.
    Wählen Sie jede der .wsdl Dateien aus und erledigen Sie die folgenden Aufgaben, die mit ihr verbunden sind.
    1. Automatisierungen ausführen.
      Bei der Ausführung von Automatisierungen werden die folgenden Aktionen durchgeführt.
      • Die Anwendung wird geändert, um die Dienste von JAX-RPC auf JAX-WS zu migrieren.
      • Der Abschnitt " Manuelle Updates" enthält Anweisungen und Links, mit denen Sie bestimmte Java Dateien manuell aktualisieren können.
      • Der Abschnitt Überprüfung neu erstellter Dateien wird mit den neuen Java Teilen gefüllt, die die Rezepte erstellt haben.
    2. Vollständige manuelle Updates für die angegebenen Java Dateien.
    3. Überprüfen Sie neu erstellte Dateien.
    4. Kompilieren Sie die Anwendung manuell.
    Abgeschlossen
    Wählen Sie den Abschnitt aus.

    Es wird eine Liste der abgeschlossenen .wsdl Dateien angezeigt und die Liste wird automatisch aktualisiert.

    Wird nicht unterstützt (manuelle Migration erforderlich)
    Wählen Sie den Abschnitt aus.
    Wenn die .wsdl Dateien Funktionen aufweisen, die von der JAX-RPC source migration helper nicht unterstützt werden, werden die Dateien als nicht unterstützt markiert. Sie können auch .wsdl Dateien als nicht unterstützt markieren, wenn Sie die Automatisierungen für sie ausführen und diese fehlschlagen.
    • Wenn die Quellmigrationshilfe eine .wsdl Datei zu nicht unterstützt hinzugefügt hat, migrieren Sie die JAX-RPC Dienste manuell in die .wsdl Datei.

      Die Quellmigrationshilfe fügt eine .wsdl Datei in den nicht unterstützten Bereich ein, wenn die .wsdl Datei Features enthält, die nicht unterstützt werden

    • Wenn Sie eine .wsdl Datei als nicht unterstützt markiert haben, können Sie die JAX-RPC Dienste manuell in die .wsdl Datei migrieren. Sie können alternativ die Migration der JAX-RPC Dienste neu starten, um die Automatisierungen für die Datei .wsdl auszuführen.
    Unbenutzt (Sicher zu löschen)
    Wählen Sie den Bereich aus, in dem Sie Ihre nicht verwendeten .wsdl Dateien sehen möchten.

    Sie können die Dateien löschen, da sie in der Anwendung nicht verwendet werden.

    Nachdem Sie alle Korrekturen für die Dateien .wsdl abgeschlossen haben, d. h. der Indikator Total WSDLs need to be fixed lautet 0, ist die Migration von JAX-RPC für die Teile abgeschlossen, bei denen Ihnen die Quellmigrationshilfe JAX-RPC helfen kann.

    Denken Sie daran: Bevor Sie auf die angezeigte Schaltfläche " Build and analyze " klicken, migrieren Sie die .wsdl Dateien im nicht unterstützten Bereich manuell, damit Sie die Migration zu JAX-WS services abschließen.
  2. Klicken Sie auf Erstellen und Analysieren.

    Ihre Anwendung, die Sie auf JAX-WS Services migriert haben, wird erneut auf verbleibende Modernisierungsprobleme überprüft.

  3. Behebung von Problemen mit der Anwendung.

    Bei Maven-Builds kann je nach den zu behebenden Problemen die Fähigkeit zur Behebung automatisiert oder selbstgesteuert sein.

    Für Builds, die Maven nicht verwenden, sind die zu behebenden Probleme selbst zu lösen.

    Die Probleme auf der Registerkarte Zusätzliche Informationen erfordern keine Codeänderung, aber Sie müssen sie möglicherweise überprüfen oder testen und gegebenenfalls eine Codeänderung vornehmen.

Behebung von Problemen und Überprüfung zusätzlicher Informationen für Ihre Bewerbung

Je nach den zu behebenden Problemen kann die Behebung automatisiert oder selbstgesteuert erfolgen. Die Probleme auf der Registerkarte Zusätzliche Informationen erfordern keine Codeänderung, aber Sie müssen sie möglicherweise überprüfen oder testen und gegebenenfalls eine Codeänderung vornehmen.

Die Seite Modernize <Ihr Anwendungsname> enthält die folgenden Informationen:

  • Die Quelle des Anwendungsservers und das Ziel des Anwendungsservers
  • Die Java SE Version als Quelle und die Java SE Version als Ziel
  • Links zu einem Technologiebericht, einem Inventarbericht und einem Analysebericht
  • Registerkarten für zu behebende Probleme, bei denen es sich um automatische oder selbstgesteuerte Korrekturen handeln kann, sowie zusätzliche Informationen.

Das Ziel Java developer kit ist erforderlich, wenn Sie automatische Korrekturen durchführen und wenn Sie die Anwendung erstellen, nachdem die Java Version Zieländerungen vorgenommen wurden. Stellen Sie sicher, dass das Ziel Java developer kit für Ihre IDE konfiguriert ist.

  • Die Plug-ins für die Eclipse IDE und die IntelliJ IDE versuchen automatisch, das richtige Java developer kit zu finden. Das Java Entwickler-Kit muss mit dem Java Versionsziel aus der Menge aller konfigurierten Java Entwickler-Kits in den IDEs übereinstimmen.
  • In der Visual Studio Code IDE müssen Sie die Konfiguration des Java developer kit manuell ändern.
Fertigstellung automatischer Korrekturen für Maven-Builds

Wenn Sie eine Registerkarte " Automatisierte Korrekturen " mit einer oder mehreren Korrekturen haben, wählen Sie die Registerkarte aus.

Da Application Modernization Accelerator Developer Tools die Korrekturen für Sie erledigt, müssen Sie keine Änderungen am Code vornehmen.

  1. Erweitern Sie die Anweisungen und lesen Sie sie.
  2. Optional können Sie das Problem öffnen, um die Beschreibung des Problems zu überprüfen.
  3. Klicken Sie auf Automatische Korrekturen ausführen.
    • Die automatisierten Korrekturen sind behoben.
    • Externe Ausgaben bleiben in der Liste, bis Sie die zugehörige Abhängigkeit aktualisieren.
  4. Wenn die automatischen Korrekturen abgeschlossen sind, klicken Sie auf Neu erstellen und aktualisieren, um die Liste der Probleme zu aktualisieren.
Wichtig: Wenn die automatischen Korrekturen nicht ausgeführt werden können und Kompilierungsfehler in der Konsolenausgabe auftreten, stellen Sie sicher, dass Sie die Version des Plug-ins maven-compiler auf 3.13.0 oder eine neuere Version aktualisieren.
Abschluss der selbstgesteuerten Reparaturen

Wenn Sie eine Registerkarte für selbstgesteuerte Korrekturen mit einer oder mehreren Korrekturen haben, wählen Sie die Registerkarte aus.

Sie ändern den Code und legen fest, wie der Code zu beheben ist.

  1. Erweitern Sie die Anleitung und folgen Sie den Anweisungen.
  2. Erweitern Sie jede Ausgabe.
  3. Klicken Sie auf Mehr lesen, um das Thema zu erweitern.
  4. Klicken Sie auf die Datei, die in der Ausgabe aufgeführt ist. Die Datei wird im Editor geöffnet.
  5. Wenn Sie Probleme beheben, klicken Sie auf Wiederherstellen und aktualisieren Sie, bis alle selbstgesteuerten Korrekturen behoben sind.
Tipp: Für bestimmte selbstständige Korrekturen können Sie möglicherweise die generativen KI-Funktionen in verwenden watsonx Code Assistant™ for Enterprise Java Applications.
Adressierung zusätzlicher Informationen

Wenn Sie eine Registerkarte " Zusätzliche Informationen" mit einer Nummer von eins oder mehr haben, wählen Sie die Registerkarte aus.

Die auf der Registerkarte aufgeführten Ausgaben werden auf dieselbe Weise ermittelt wie die Ausgaben auf anderen Registerkarten. Obwohl die zusätzlichen Informationen keine Änderung Ihres Codes erfordern, sollten Sie die Probleme überprüfen, damit Sie sicherstellen können, dass Ihre Anwendung funktioniert, wenn Ihr Code migriert wird.

Die zusätzlichen Informationen können auf Probleme hinweisen, wie z. B. kleinere Verhaltensänderungen in einer API oder Probleme mit der Konnektivität von Datenbanken oder Benutzerregistern, und zeigen auf, was dagegen zu tun ist.

Sie haben zum Beispiel eine Datenbank, mit der sich Ihre Anwendung verbindet. Sie haben die Ausgabe für diese Situation gelesen. Dann stellen Sie sicher, dass der Host und der Port, die für die Anwendung konfiguriert sind, gültig und zugänglich sind, wenn die Anwendung migriert wird.

  • Erweitern Sie die Anweisungen und befolgen Sie sie.

  • Klicken Sie auf jede Ausgabe.

    • Klicken Sie auf Mehr lesen, um das Thema zu erweitern.
    • Klicken Sie auf den Link in der Datei, die in der Ausgabe aufgeführt ist, um den Code zu überprüfen.
Arbeit an externen Themen außerhalb der aktuellen Anwendung

Während Sie an den Korrekturen arbeiten, können einige als externe Probleme außerhalb der aktuellen Anwendung eingestuft werden. Der Quellcode für diese Probleme befindet sich in bestimmten Archiven, die nicht Teil der aktuellen Quellanwendung sind.

Wenn es sich bei dem Archiv um eine Bibliothek handelt, die Ihrer Organisation gehört, führen Sie die folgenden Schritte aus.

  1. Öffnen Sie den zugehörigen Quellcode als separate Anwendung und verwenden Sie Application Modernization Accelerator Developer Tools , um die Probleme dort zu beheben.
  2. Aktualisieren Sie Ihre aktuelle Anwendung, um die neue korrigierte Version zu verwenden.

Wenn es sich bei dem Archiv um eine Bibliothek handelt, die nicht im Besitz Ihrer Organisation ist, führen Sie den folgenden Schritt aus.

  • Aktualisieren Sie auf eine Version, die dieses Problem nicht enthält.

    Wenn es keine solche Version gibt, müssen Sie möglicherweise eine andere Technologie verwenden.