So transformiert Amazon Q Developer Code für Java-Sprach-Upgrades - Amazon Q Developer

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

So transformiert Amazon Q Developer Code für Java-Sprach-Upgrades

Um Ihren Code zu transformieren, generiert Amazon Q Developer einen Transformationsplan, anhand dessen die Codesprachenversion Ihres Projekts aktualisiert wird. Nach der Transformation Ihres Codes erhalten Sie eine Zusammenfassung der Transformation und eine Dateiübersicht, mit der Sie die Änderungen überprüfen können, bevor Sie sie akzeptieren. Da Amazon Q Developer die minimalen Änderungen vornimmt, die erforderlich sind, um Ihren aktualisierten Code mit dem Ziel-JDK kompatibel zu machen, ist eine zusätzliche Transformation erforderlich, um die Bibliotheken und Abhängigkeiten Ihres Projekts zu aktualisieren. In den folgenden Abschnitten finden Sie weitere Informationen darüber, wie Amazon Q die Transformation durchführt.

Erstellen Sie Ihren Code und erstellen Sie einen Transformationsplan

Um mit der Transformation Ihres Codes zu beginnen, erstellt Amazon Q Ihr Projekt lokal und generiert ein Build-Artefakt, das Ihren Quellcode, Ihre Projektabhängigkeiten und Build-Logs enthält.

Nach der Generierung des Build-Artefakts erstellt Amazon Q Ihren Code in einer sicheren Build-Umgebung und erstellt einen Transformationsplan, der auf das Projekt oder Modul zugeschnitten ist, das Sie aktualisieren. Der Transformationsplan beschreibt die spezifischen Änderungen, die Amazon Q vornehmen wird, einschließlich neuer abhängiger Versionen, wichtiger Codeänderungen und Ersatzvorschläge für veralteten Code. Diese Änderungen basieren auf der vorläufigen Version Ihres Codes und können sich während der Transformation ändern.

Transformieren Sie Ihren Code

Um Ihren Code zu transformieren, versucht Amazon Q, Ihren Code auf der Grundlage der vorgeschlagenen Änderungen im Transformationsplan auf die Ziel-Java-Version zu aktualisieren. Während der Änderungen werden bestehende Komponententests in Ihrem Quellcode neu erstellt und ausgeführt, um alle aufgetretenen Fehler iterativ zu beheben. Das JDK-Upgrade kann von der folgenden Quellcodeversion auf die Zielversion durchgeführt werden:

  • Java 8 bis 17

  • Java 8 bis 21

  • Java 11 bis 17

  • Java 11 bis 21

  • Java 17 bis 21

Amazon Q Developer nimmt die minimalen Änderungen vor, die erforderlich sind, um Ihren Code mit der Java-Zielversion kompatibel zu machen. Nach dem erfolgreichen Upgrade auf Java 17 oder 21 ist eine zusätzliche Transformation erforderlich, um die Bibliotheken und Abhängigkeiten Ihres Projekts zu aktualisieren. Wählen Sie dieselbe Quellcodeversion und Zielcodeversion (z. B. 17 bis 17).

Amazon Q versucht, beim Upgrade Ihres Codes die folgenden Änderungen vorzunehmen:

  • Aktualisieren Sie veraltete Codekomponenten gemäß den Empfehlungen für die Java-Zielversion

  • Aktualisieren Sie beliebte Bibliotheken und Frameworks auf eine Version, die mit der Java-Zielversion kompatibel ist. Dies beinhaltet die Aktualisierung der folgenden Bibliotheken und Frameworks auf ihre neuesten verfügbaren Hauptversionen:

    • Apache Commons I/O

    • Apache HttpClient

    • bc-fips

    • Gurke-JVM

    • Ruhezustand

    • jackson-annotations

    • Jakarta

    • Javax

    • Javax.Servlet

    • jaxb-api

    • jaxb-impl

    • Jaxen

    • jcl-over-slf4j

    • json-einfach

    • jsr305

    • Einheit

    • junit-jupiter-api

    • Log4j

    • Mikronaut

    • Mockito

    • Mockito-Core

    • Okio

    • PowerMockito

    • Quarkus

    • slf4j

    • slf4j-api

    • Frühlingsstiefel

    • Frühjahrs-Framework

    • Sicherheit im Frühling

    • Prahlerei

    • testen

Überprüfung der Transformationszusammenfassung und Annahme der Änderungen

Nach Abschluss der Transformation stellt Amazon Q eine Zusammenfassung der Transformation mit Einzelheiten zu den vorgenommenen Änderungen bereit, einschließlich des Status des endgültigen Builds, der angibt, ob Ihr gesamtes Projekt aktualisiert wurde. Sie können sich auch eine Zusammenfassung des Build-Protokolls ansehen, um alle Probleme zu verstehen, die Amazon Q daran gehindert haben, Ihren Code in der aktualisierten Version zu erstellen.

Die Zusammenfassung der Transformation enthält zusätzlich die Unterschiede zwischen den im Transformationsplan vorgeschlagenen Änderungen und den Änderungen, die Amazon Q letztendlich vorgenommen hat, um Ihren Code zu aktualisieren, sowie alle zusätzlichen Änderungen, die nicht im ursprünglichen Plan enthalten waren.

Nachdem Sie die Zusammenfassung der Transformation gelesen haben, können Sie sich die Änderungen, die Amazon Q vorschlägt, in einer Dateivergleichsansicht ansehen. Alle Codeänderungen, die Amazon Q vorschlägt, wirken sich erst auf Ihre aktuellen Projektdateien aus, wenn Sie die Änderungen akzeptieren. Der transformierte Code ist bis zu 30 Tage nach Abschluss der Transformation verfügbar.

Abschluss teilweise erfolgreicher Transformationen

Abhängig von der Komplexität und den Besonderheiten Ihrer Codebasis kann es Fälle geben, in denen die Transformation teilweise erfolgreich ist. Das bedeutet, dass Amazon Q nur bestimmte Dateien oder Codebereiche in Ihrem Projekt transformieren konnte. In diesem Fall müssen Sie den verbleibenden Code manuell aktualisieren, damit Ihr Projekt in der aktualisierten Sprachversion erstellt werden kann.

Um den Rest Ihres Codes zu transformieren, können Sie Amazon Q Chat in der IDE verwenden. Sie können Amazon Q bitten, die teilweise aktualisierten Dateien zu überprüfen und neuen Code bereitzustellen, um Probleme wie Kompilierungsfehler zu beheben. Sie können auch Funktionen wie /devund verwenden @workspace, um mehr von Ihrem Projekt als Kontext einzubeziehen und Vorschläge für mehrere Dateien gleichzeitig zu erhalten.