Java modernisieren

watsonx Code Assistant Standardplan

Sie können Ihre Anwendung auf Liberty modernisieren. Um Ihre Anwendung zu modernisieren, laden Sie zunächst ein Migrationspaket hoch oder erstellen und analysieren Ihre Anwendung und beheben dann Ihre Anwendungsprobleme.

Bevor Sie beginnen, richten Sie Ihre Java ein.

Folgende Anwendungsserver-Quellen stehen zur Auswahl:

  • Apache Tomcat Anwendungsserver
  • JBoss Application Server
  • WebLogic Anwendungsserver
  • WebSphere Application Server traditionell V6.1
  • WebSphere Application Server traditionell V7.0
  • WebSphere Application Server traditionell V8.0
  • WebSphere Application Server traditionell V8.5.5
  • WebSphere Application Server traditionell V9.0
  • Andere Anwendungsserver von Drittanbietern

Nur Eclipse IDE: Um mit Java mit mehreren Modulen optimale Ergebnisse zu erzielen, stellen Sie sicher, dass Sie das Aggregatormodul und jedes Untermodul als separate Projekte in Eclipse importieren. Watsonx Code Assistant kann Ihr Projekt wahrscheinlich nicht erfolgreich untersuchen, wenn Sie das Verzeichnis der obersten Ebene als einzelnes Projekt importieren.

Führen Sie entweder die Schritte zum Hochladen Ihres Anwendungsmigrationspakets 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 sowohl für die Schritte des Migrationspakets als auch für die Anwendungsanalyse dieselben. Nachdem Sie die Probleme behoben haben, haben Sie eine modernisierte Anwendung.

Benötigte Zeit für die Analyse Ihres Codes

Die Bearbeitungszeit für Ihren Antrag variiert. Die folgenden Zeiten sind typisch.

Benötigte Zeit für die Analyse
Zeit Anwendungsdetails
Sekunden bis wenige Minuten Weniger als 100 Klassen
2 bis 10 Minuten 20.000 bis 50.000 Codezeilen
10 oder mehr Minuten 300.000 Codezeilen

Wenn watsonx Code Assistant Ihre Anwendung analysiert, werden einige Pakete von Drittanbietern standardmäßig von der Codeanalyse ausgeschlossen. Weitere Informationen finden Sie unter Pakete von Drittanbietern, die von der Anwendungsanalyse ausgeschlossen sind.

Verwendung eines Migrationspakets zur Modernisierung Ihrer Anwendung

Die folgenden Schritte gehen davon aus, dass Sie IBM Cloud® Transformation Advisor Version 3.10 oder höher verwenden, um ein Migrationsbündel zu erstellen. Das Migrationspaket enthält eine Liste von Modernisierungsproblemen, die gelöst werden müssen. Sie enthält auch automatisch generierte Konfigurationsinformationen, damit die Anwendung in Liberty ordnungsgemäß funktioniert.

Wenn Sie bereits ein Migrationspaket für Ihr Projekt hochgeladen und analysiert haben, wird die vorhandene Analyse durch das Hochladen eines neuen Migrationspakets überschrieben.

Bevor Sie Ihre Anwendung modernisieren, erstellen Sie einen vollständigen Build Ihrer Anwendung, um sicherzustellen, dass Sie von einem bekannten guten Anwendungs-Build ausgehen. Durch diesen Build wird außerdem sichergestellt, dass die Klassendateien mit dem neuesten Quellcode übereinstimmen. Dies ist eine Voraussetzung, bevor Sie Automatisierungen ausführen, die Änderungen für Java-Versionsaktualisierungen 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 wollen.

  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.

  2. Verwenden Sie einen der beiden Wege, um den Modernisierungsprozess zu starten. Beide sind identisch:

    • Klicken Sie auf watsonx Code Assistant und klicken Sie dann auf Modernize to Liberty.
    • Klicken Sie auf Java Anwendungen modernisieren und dann auf Nach Liberty modernisieren.

  3. Laden Sie auf der Seite Modernize <Ihr*Anwendungsname>*das Migrations-Bundle hoch.

    Die IDE analysiert Ihren Projektordner, sammelt Informationen über Ihre Anwendung und lädt dann das Migrationspaket hoch, das Transformation Advisor erzeugt.

    1. Klicken Sie auf Migrationsbündel hochladen.

    2. Wählen Sie die Datei des Anwendungspakets " .zip aus der Liste und klicken Sie auf Öffnen.

      Wenn der Prozess zum Hochladen des Migrationspakets abgeschlossen ist, werden auf der Seite Modernize <Ihr*Anwendungsname>*die folgenden Konfigurationsdateien angezeigt, die im Paket 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 dann auf " Proceed.

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

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

  4. Behebung von Problemen mit der Anwendung.

    Je nach den zu behebenden Problemen kann die Behebung automatisiert, unterstützt 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

Die folgenden Schritte gehen davon aus, dass Sie Ihre Anwendung analysieren und nicht ein Transformation Advisor Migrationspaket 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 keine weiteren 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 wollen.

  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.

  2. Verwenden Sie einen der beiden Wege, um den Modernisierungsprozess zu starten. Beide sind identisch:

    • Klicken Sie auf watsonx Code Assistant und klicken Sie dann auf Modernize to Liberty.
    • Klicken Sie auf Java Anwendungen modernisieren und dann auf Nach Liberty modernisieren.

  3. Erweitern Sie auf Ihrer Modernize <name Ihrer Bewerbung> Seite ' Analysieren Sie die Anwendung und klicken Sie auf ' Analyse starten.

  4. 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 Java SE-Quelle ändern, die automatisch mit einem empfohlenen Wert angezeigt wird.

      Der empfohlene Wert basiert auf der Java SE-Version, die watsonx Code Assistant 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 Java SE-Quellcode auf die Version, die Ihr Anwendungsserver verwendet.

      Zum Beispiel empfiehlt watsonx Code Assistant Java SE 8 für WebSphere Application Server V8.5.5, auch wenn Ihr Anwendungsserver möglicherweise eine frühere Version von Java SE verwendet.

      Die minimal unterstützte Java ist Java 5.

    3. Wählen Sie das Java SE-Ziel aus.

    4. Klicken Sie entweder auf Analysieren oder auf Erstellen und Analysieren.

      Die Analyse der Anwendung erfolgt auf dem Anwendungsbinary. Die Anwendung muss vor Beginn der Analyse erstellt werden. Sie können die Anwendung entweder automatisch oder manuell erstellen.

      • Um die Anwendung automatisch zu erstellen und zu analysieren, klicken Sie auf Erstellen und Analysieren.
      • Wenn Sie die Anwendung manuell erstellen, erstellen Sie sie zunächst und klicken dann auf Analysieren.

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

      Java Wenn Sie auf "Erstellen und analysieren" klicken, wird die Anwendung in ihrer aktuellen Quellversion erstellt, sodass sie auf Probleme bei der Aktualisierung von Java analysiert werden kann. Stellen Sie sicher, dass die IDE über das Java-Entwicklerkit der Java-Quellversion verfügt, das so konfiguriert ist, dass die IDE die Anwendung erfolgreich erstellen kann.

  5. Behebung von Problemen mit der Anwendung.

    Je nach den zu behebenden Problemen kann die Behebung automatisiert, unterstützt 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.

Warum wird eine.class-Datei in einen Analysebericht aufgenommen und nicht die.java-Datei?

Wenn Sie eine Analyse einer Binärdatei (JAR/WAR/EAR) durchführen, werden die Probleme immer in den Klassendateien entdeckt. Wenn der Binärscanner außerhalb von watsonx Code Assistant ausgeführt wird, hat er keinen Zugriff auf den Quellcode, so dass die.class-Datei in den Analysebericht aufgenommen wird. Wenn Sie einen Migrationsplan importieren oder eine Analyse in watsonx Code Assistant ausführen, zeigen die Berichte Verweise auf Klassendateien an, aber watsonx Code Assistant verknüpft die.class-Datei mit der.java-Datei, und die.java-Dateien werden in der Benutzeroberfläche von watsonx Code Assistant angezeigt.

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

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

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

Das Java ist erforderlich, wenn Sie automatische Korrekturen durchführen und wenn Sie die Anwendung erstellen, nachdem die Java geändert worden ist. Vergewissern Sie sich, dass das Java für Ihre IDE konfiguriert ist.

  • Die Eclipse IDE versucht automatisch, aus der Menge aller konfigurierten Java in der IDE das richtige Java zu finden, das der Java entspricht.
  • In der Visual Studio Code IDE müssen Sie die Konfiguration des Java Developer Kits manuell ändern.

Abschluss der automatischen Korrekturen

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

Da watsonx Code Assistant die Korrekturen für Sie erledigt, müssen Sie keine Codeänderungen vornehmen. Das große Sprachmodell (LLM) wird nicht für automatische Korrekturen verwendet.

  1. Erweitern Sie die Anleitung 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.

Wenn die automatischen Korrekturen nicht ausgeführt werden können und in der Konsolenausgabe Kompilierungsfehler auftreten, stellen Sie sicher, dass Sie die Version des maven-compiler-Plug-ins auf 3.13.0 oder eine neuere Version aktualisieren.

Abschluss der unterstützten Korrekturen

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

Auch wenn Sie Ihren Code korrigieren, hilft Ihnen watsonx Code Assistant, indem er Ihnen im Chat Vorschläge macht, wie Sie Ihren Code ändern können.

Der Grad der Unterstützung, der für die einzelnen Themen zur Verfügung steht, variiert je nach Thema. Die unterstützten Korrekturen helfen Ihnen, das Problem zu beheben, und manchmal führt ein Code-Vorschlag zum Ziel oder zumindest fast. In anderen Fällen kann der Code-Vorschlag so einfach sein wie das Entfernen einer alten API, um einen Kompilierungsfehler zu vermeiden, und es sind keine weiteren Maßnahmen von Ihnen erforderlich. Es ist wichtig, die Schritte für jede unterstützte Korrektur zu befolgen, um den Wert und die Grenzen jeder unterstützten Korrektur zu verstehen. In Fällen, in denen kein vollständiger Code-Vorschlag bereitgestellt wird, können Sie die unterstützte Fehlerbehebung als Gesprächseinstieg im Chat verwenden. Verfolgen Sie den Chat weiter, um Ihr Verständnis für das Problem und seine Lösung zu vertiefen.

Eine Liste der Probleme, die mit unterstützten Korrekturen verbunden sind, finden Sie in der Referenz für unterstützte Korrekturen.

Um unterstützte Korrekturen zu verwenden:

  1. Erweitern Sie die Anleitung und folgen Sie den Anweisungen.

  2. Erweitern Sie für jedes Thema den Text.

  3. Klicken Sie auf "Mehr lesen ", um das Problem zu erweitern.

  4. Klicken Sie auf die Datei, die in der Ausgabe aufgeführt ist.

    Die Datei wird im Editor geöffnet.

  5. Erweitern Sie das Problem, um die Problemdetails anzuzeigen.

  6. Wenn Sie in den Details aufgefordert werden, ein Code-Snippet auszuwählen, wählen Sie es aus.

  7. Klicken Sie auf Hilfe, um Unterstützung bei der Behebung des Problems zu erhalten.

    Wenn Sie Visual Studio Code verwenden, gelten die folgenden Einschränkungen:

    • Achten Sie darauf, dass Sie Java nur in einem aktiven Editor auswählen.
    • Vergewissern Sie sich, dass sich der aktive Editor, in dem Sie Java ausgewählt haben, in einer anderen Editor-Gruppe befindet als die Ansicht Modernize to Liberty oder Java Upgrade.

  8. Folgen Sie den Code-Vorschlägen im Chat, damit Sie den Code ändern können, um die Probleme zu beheben.

    Manchmal liefert der Chat eine informative Antwort anstelle eines Code-Vorschlags.

  9. Während Sie Probleme beheben, klicken Sie auf "Neu erstellen" und aktualisieren Sie, bis alle unterstützten Fehler behoben sind.

Abschluss der selbstgesteuerten Reparaturen

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

Du änderst den Code und legst fest, wie du den Code reparieren kannst, aber du kannst Hilfe im Chat bekommen.

  1. Erweitern Sie die Anleitung und folgen Sie den Anweisungen.

  2. Erweitern Sie jede Ausgabe.

  3. Klicken Sie auf "Mehr lesen ", um das Problem zu erweitern.

  4. Klicken Sie auf die Datei, die in der Ausgabe aufgeführt ist.

    Die Datei wird im Editor geöffnet.

  5. Klicken Sie auf Chat starten, der für jedes Auftreten des Problems angezeigt wird.

    Das Chat-Fenster öffnet sich, sodass Sie Hilfe für das Vorkommnis erhalten können. Sie können den Code-Assistenten zum Beispiel fragen, was der aktuelle Code bewirkt. Oder Sie können fragen, ob es eine alternative Implementierung für den problematischen Code gibt.

  6. Während Sie Probleme beheben, klicken Sie auf "Neu erstellen" und aktualisieren Sie, bis alle selbstgesteuerten Fehler behoben sind.

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 Probleme werden auf dieselbe Weise ermittelt wie die Probleme auf anderen Registerkarten. Obwohl die zusätzlichen Informationsprobleme keine Änderung Ihres Codes erfordern, sollten Sie die Probleme überprüfen, um sicherzustellen, dass Ihre Anwendung funktioniert, wenn Ihr Code migriert wird.

Die zusätzlichen Informationen können auf Probleme hinweisen, wie z. B. geringfügige Verhaltensänderungen in einer API oder Verbindungsprobleme in Datenbanken oder Benutzerregistern, und was dagegen zu tun ist.

Nehmen wir zum Beispiel an, Sie haben eine Datenbank, mit der Ihre Anwendung verbunden ist. Wenn Sie das Problem in dieser Situation lesen, 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 Problem 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 Ausgaben befindet sich in bestimmten Archiven, die nicht Teil der aktuellen Quellanwendung sind.

Wenn das Archiv eine Bibliothek ist, die Ihrer Organisation gehört:

  1. Sie können den zugehörigen Quellcode als separate Anwendung öffnen und watsonx Code Assistant verwenden, um die Probleme dort zu beheben.

  2. Anschließend können Sie Ihre aktuelle Anwendung aktualisieren, um die neue korrigierte Version zu verwenden.

Wenn das Archiv eine Bibliothek ist, die nicht im Besitz Ihrer Organisation ist:

  1. Sie müssen auf eine Version aktualisieren, die dieses Problem nicht enthält. Wenn es keine solche Version gibt, müssen Sie möglicherweise eine alternative Technologie verwenden.

  2. Sie können sich mit watsonx Code Assistant in Verbindung setzen, um Hilfe bei der Suche nach einem Ersatz zu erhalten. Versuchen Sie zunächst, What is the library X used for? oder Is it easy to replace? zu fragen. Setzen Sie das Gespräch fort, um weitere Informationen für Ihre spezielle Nutzung der Bibliothek zu erhalten.