Aggiornamento della versione di Java per l'applicazione

watsonx Code Assistant Piano standard

Per aggiornare il codice Java, occorre innanzitutto costruire e analizzare l'applicazione, quindi correggere i problemi individuati. A seconda dei problemi, la capacità di risolverli può essere automatizzata, assistita o autonoma.

Prima di iniziare, configurate l'ambiente Java aziendale.

Solo per l' Eclipse IDE: Per ottenere risultati ottimali con un'applicazione Java multimodulo, assicurarsi di importare il modulo aggregatore e ogni sottomodulo come progetti separati nell'area di lavoro di Eclipse. è improbabile che Watsonx Code Assistant riesca a eseguire l'introspezione del progetto se si importa la directory di primo livello come un unico progetto.

Tempo necessario per analizzare il codice

Il tempo necessario per analizzare la tua applicazione varia. I tempi seguenti sono tipici.

Tempo necessario per l'analisi
Ora	Dettagli applicazione
Da pochi secondi a qualche minuto	Meno di 100 classi
da 2 a 10 minuti	da 20.000 a 50.000 righe di codice
10 o più minuti	300.000 righe di codice

Quando watsonx Code Assistant analizza l'applicazione, esclude per impostazione predefinita alcuni pacchetti di terze parti dall'analisi del codice. Per ulteriori informazioni, vedere Pacchetti di terze parti esclusi dall'analisi delle applicazioni.

Analizzare l'applicazione per aggiornare la versione di Java

L'analisi fornisce un elenco di questioni da affrontare. Dopo aver risolto i problemi, la versione di Java per l'applicazione viene aggiornata.

Se si ripristinano le modifiche al codice, è necessario fare clic su Return per analizzare ed eseguire un'analisi completa se si desidera eseguire nuovamente l'aggiornamento dell' Java.

Nell'IDE, fate clic con il pulsante destro del mouse su qualsiasi elemento della gerarchia nella directory dell'applicazione che volete aggiornare.
Utilizzare uno dei due percorsi per avviare il processo di aggiornamento. Entrambi sono uguali:
- Fare clic su watsonx Code Assistant, quindi fare clic su Aggiorna versione Java.
- Fare clic su Modernize Java Applications, quindi su Upgrade Java Version.
Nella pagina Upgrade* *, selezionare i parametri di analisi, che definiscono le regole in base alle quali l'applicazione viene analizzata.
1. È possibile modificare l'origine Java, che viene visualizzata automaticamente con un valore consigliato.
  
  La versione sorgente Java è la versione di Java da cui si sta effettuando l'aggiornamento. In base alla versione di Java rilevata nella configurazione di compilazione, watsonx Code Assistant consiglia una versione Java da usare come sorgente. È possibile scegliere una versione di Java diversa dall'elenco delle versioni supportate, se questa è appropriata per la propria applicazione. La configurazione della compilazione si trova nel file 'pom.xml di Maven.
  
  La versione di Java consigliata è la versione di Java rilevata nella configurazione di compilazione, oppure è la migliore versione di Java disponibile in base alla versione di Java rilevata. Ad esempio, se nella configurazione di compilazione viene specificato Java 9, che non è supportato, Java 8 è la versione di Java consigliata. Si consiglia Java 8, poiché è la versione di Java più vicina a quella supportata per l'analisi e poiché è precedente alla versione di Java rilevata.
  
  La versione di Java minimamente supportata è Java 6.
2. Selezionare il target Java.
  
  La versione di destinazione Java è la versione di Java a cui si sta aggiornando l'applicazione Java. Le versioni di destinazione che si possono selezionare sono le release a lungo termine (LTS) Java.
3. Fare clic su Analizza o su Costruisci e analizza.
  
  L'analisi dell'applicazione viene eseguita sul binario dell'applicazione. L'applicazione deve essere costruita prima di iniziare l'analisi. È possibile creare l'applicazione automaticamente o manualmente.
  - Fare clic su Costruisci e analizza per creare e analizzare automaticamente l'applicazione.
  - Fare clic su Analizza dopo aver creato manualmente l'applicazione.
  Dopo che l'applicazione è stata costruita e analizzata, vengono visualizzati i problemi da correggere o rivedere. A seconda dei problemi da risolvere, la capacità di risolverli può essere automatizzata, assistita o autogestita. Questi problemi da rivedere non richiedono una modifica del codice per migrare il codice. Tuttavia, potrebbe essere necessario verificarli o testarli.
  
  Quando si fa clic su Build and analyze (Crea e analizza ), l'applicazione viene creata nella sua versione sorgente corrente dell' Java, in modo che possa essere analizzata per eventuali problemi di aggiornamento dell' Java. Assicurati di configurare l'IDE con il kit di sviluppo IDE ( Java ) della versione sorgente dell' Java, in modo che l'IDE possa creare correttamente l'applicazione.
  
  Durante la costruzione e l'analisi, se si riscontrano problemi con un progetto multimodulo che include un sottomodulo con un pacchett liberty-assembly, eseguire mvn install a livello di radice del progetto e riprovare.

Perché in un report di analisi viene incluso un file.class invece del file.java?

Quando si esegue un'analisi di un binario (JAR/WAR/EAR), i problemi vengono sempre rilevati nei file di classe. Quando lo scanner binario viene eseguito al di fuori di watsonx Code Assistant, non ha accesso al codice sorgente, quindi il file.class viene incluso nel rapporto di analisi. Quando si importa un piano di migrazione o si esegue un'analisi all'interno di watsonx Code Assistant, i rapporti mostrano i riferimenti ai file di classe, ma watsonx Code Assistant collega il file.class al file.java e i file.java vengono mostrati nell'interfaccia utente di watsonx Code Assistant.

Correzione di problemi e revisione di informazioni aggiuntive per la vostra applicazione

La pagina Aggiornamento* *elenca le seguenti informazioni:

La versione Java di partenza e la versione Java di arrivo
Collegamenti a un rapporto sulla tecnologia, a un rapporto sull'inventario e a un rapporto di analisi
Schede per i problemi da risolvere, che possono essere automatici, assistiti o autogestiti, e per le informazioni aggiuntive

Il kit di sviluppo Java di destinazione è necessario quando si eseguono le correzioni automatiche e quando si costruisce l'applicazione dopo le modifiche apportate alla versione Java di destinazione. Assicuratevi che il kit di sviluppo Java di destinazione sia configurato per il vostro IDE.

L'estensione dell' Eclipse IDE cerca automaticamente di trovare il kit di sviluppo Java corretto che corrisponde alla versione Java target dall'insieme di tutti i kit di sviluppo Java configurati nell'IDE.
Nell'IDE Visual Studio Code, è necessario modificare manualmente la configurazione del Java developer kit.

Completamento delle correzioni automatiche

Se esiste una scheda Correzioni automatiche con una o più correzioni, selezionare la scheda.

Poiché watsonx Code Assistant completa le correzioni per l'utente, non è necessario apportare alcuna modifica al codice. Il modello linguistico di grandi dimensioni (LLM) non viene utilizzato per le correzioni automatiche.

Espandere le istruzioni e leggerle.
Aprire facoltativamente il problema per rivederne la descrizione.
Fare clic su Esegui correzioni automatiche.
- Le correzioni automatiche sono state risolte.
- I problemi esterni rimangono nell'elenco finché non si aggiorna la dipendenza associata.
Al termine dell'esecuzione delle correzioni automatiche, fare clic su Ricostruisci e aggiorna per aggiornare l'elenco dei problemi.

Se le correzioni automatiche non vengono eseguite e producono errori di compilazione nell'output della console, assicurarsi di aggiornare la versione del plug-in di maven-compiler a 3.13.0 o più recente.

Quando si eseguono automazioni, se si riscontrano problemi con un progetto multimodulo che include un sottomodulo con un pacchett liberty-assembly, eseguire mvn install a livello di radice del progetto e riprovare.

Completamento delle correzioni assistite

Se esiste una scheda Correzioni assistite con una o più correzioni, selezionare la scheda.

Sebbene l'utente corregga il codice, watsonx Code Assistant lo assiste fornendo suggerimenti nella chat su come modificare il codice.

Il livello di assistenza disponibile varia a seconda della questione. Le correzioni assistite ti aiutano a risolvere il problema e a volte un suggerimento sul codice ti porta fino in fondo o quasi. Altre volte, il suggerimento di codice può essere semplice come la rimozione di una vecchia API per evitare un errore di compilazione e non è richiesta alcuna ulteriore azione da parte dell'utente. È importante seguire i passaggi per ogni riparazione assistita per comprenderne il valore e i limiti. Nei casi in cui non viene fornito un suggerimento completo per il codice, puoi pensare alla correzione assistita come a un inizio di conversazione nella chat. Continuate a partecipare alla chat per comprendere il problema e la sua risoluzione.

Per un elenco dei problemi associati alle correzioni assistite, vedere il riferimento alle correzioni assistite.

Per utilizzare le correzioni assistite:

Espandere le Istruzioni e seguire le istruzioni.
Per ogni questione, ampliatela.
Fare clic su Leggi tutto per espandere il numero.
Fare clic sul file elencato nel problema. Il file si apre nell'editor.
Espandere il problema per visualizzarne i dettagli.
Se nei dettagli viene richiesto di selezionare uno snippet di codice, selezionarlo.
Fare clic su Aiutami per ricevere assistenza nella risoluzione del problema.

Se si utilizza Visual Studio Code, si applicano le seguenti restrizioni:
- Assicurarsi di selezionare il codice Java in un solo editor attivo.
- Assicuratevi che l'editor attivo in cui avete selezionato il codice Java sia in un gruppo di editor diverso da quello della vista Modernize to Liberty o Java Upgrade.
Segui i suggerimenti sul codice nella chat per modificarlo e risolvere il problema.

A volte, la chat fornisce una risposta informativa invece di un suggerimento di codice.
Mentre risolvi i problemi, fai clic su Ricostruisci e aggiorna finché tutte le correzioni assistite non sono state risolte.

Completare le correzioni autogestite

Se è presente una scheda Correzioni autogestite con una o più correzioni, selezionare la scheda.

Si modifica il codice e si stabilisce come correggerlo, ma si può ottenere aiuto dalla chat.

Espandere le Istruzioni e seguire le istruzioni.
Espandere ogni numero.
Fare clic su Leggi tutto per espandere il numero.
Fare clic sul file elencato nel problema. Il file si apre nell'editor.
Fare clic su Avvia chat, che viene visualizzato per ogni occorrenza del problema. Si apre la finestra della chat per ricevere aiuto in merito all'evento. Ad esempio, si può chiedere all'assistente al codice cosa fa il codice corrente. Oppure si può chiedere se esiste un'implementazione alternativa per il codice problematico.
Mentre risolvi i problemi, fai clic su Ricostruisci e aggiorna finché tutte le correzioni autoguidate non sono state risolte.

Indirizzare le informazioni aggiuntive

Se è presente una scheda Informazioni aggiuntive con un numero pari o superiore a uno, selezionare la scheda.

I problemi elencati nella scheda vengono determinati allo stesso modo dei problemi in altre schede. Sebbene le questioni relative alle informazioni aggiuntive non richiedano una modifica al codice, è opportuno esaminarle per assicurarsi che l'applicazione funzioni quando il codice viene migrato.

Le informazioni aggiuntive potrebbero indicare problemi, come piccoli cambiamenti comportamentali in un API e cosa fare al riguardo.

Espandere le istruzioni e seguirle.
Fare clic su ogni numero.
- Fare clic su Leggi tutto per espandere il numero.
- Fate clic sul link del file elencato nel problema per esaminare il codice.

Lavorare su questioni esterne all'applicazione corrente

Mentre si lavora sulle correzioni, alcune potrebbero essere classificate come problemi esterni all'applicazione corrente. Il codice sorgente di questi problemi si trova in archivi specifici che non fanno parte dell'applicazione sorgente corrente.

Se l'archivio è una biblioteca di proprietà dell'organizzazione:

È possibile aprire il codice sorgente associato come applicazione separata e utilizzare watsonx Code Assistant per correggere i problemi.
Quindi, è possibile aggiornare l'applicazione corrente per utilizzare la nuova versione corretta.

Se l'archivio è una biblioteca non di proprietà della vostra organizzazione:

È necessario aggiornare a una versione che non contenga questo problema. Se non esiste una versione simile, potrebbe essere necessario utilizzare una tecnologia alternativa.
È possibile avviare una conversazione con watsonx Code Assistant per ottenere assistenza nella scelta di un sostituto. Per iniziare, provate a chiedere a What is the library X used for? o Is it easy to replace?. Continuate la conversazione per ottenere maggiori informazioni sull'uso specifico della biblioteca.