Esercizio 1.2: Esecuzione di una revisione codice e applicazione di una correzione rapida
Requisito preliminare di questo esercizio è il completamento di Esercizio 1.1: Importazione delle risorse necessarie. Nell'esercizio è riportato lo scenario utente. Si assume quindi il ruolo di sviluppatore software così come descritto nello scenario utente.
Scenario utente
Un grosso gruppo di sviluppatori dispersi geograficamente codifica una nuova applicazione software. È importante che gli sviluppatori periodicamente eseguano le revisioni codice per verificare i problemi nel proprio codice.
Uno degli sviluppatori vuole eseguire una revisione codice per vedere in che modo procedere in generale. Per revisionare il nuovo codice scritto per valutare l'aderenza alle best practice in diverse aree, lo sviluppatore esegue una revisione codice rapida automatizzata. Questa revisione si applica a diverse categorie di regole fornite nel codice. Ogni categoria di regole verifica la qualità del codice in un'area specifica, come prestazioni.
Quando la revisione codice finisce, si ottiene un elenco di risultati. Ogni risultato rappresenta una stringa di codice che non aderisce perfettamente a una regola applicata. Uno dei risultati presenta una correzione rapida disponibile, in modo che lo sviluppatore possa applicare la soluzione automatizzata e correggere il problema immediatamente.
Nella prima parte dell'esercizio, si eseguono le seguenti attività per eseguire una revisione codice:
- Selezionare una revisione codice da eseguire.
- Visualizzare le regole applicate nella revisione codice.
- Scegliere su quale codice eseguire la revisione.
- Eseguire la revisione codice.
- Visualizzare i risultati della revisione codice.
- Selezionare un risultato per vedere le seguenti informazioni:
- Codice sorgente.
- Descrizione, esempi e soluzioni.
In seguito, per applicare una correzione rapida a un risultato nella revisione codice si eseguono le seguenti attività:
- Riconoscere quando una correzione rapida è disponibile per un risultato.
- Vedere un elenco di modifiche che la correzione rapida esegue al codice.
- Fare un'anteprima dell'originale e del codice riorganizzato prima di applicare una correzione rapida.
- Applicare la correzione rapida per riorganizzare il codice.
- Ottenere una conferma dopo che la correzione rapida è stata applicata.
Esercizio
Selezione di una revisione codice
Per selezionare una revisione codice rapida:
- Sulla barra degli strumenti nella vista Revisione codice fare clic sull'icona Gestisci regole,
.

- Nell'elenco Seleziona revisione codice, fare clic su Revisione codice rapida. Le cartelle delle regole per la revisione codice selezionata vengono visualizzate, come mostrato nella seguente immagine:

- Per vedere una delle regole che vengono applicate nella revisione codice, espandere la directory J2SE Best Practices e quindi la cartella secondaria Null. La cartella Null mostra una regola con un livello di severità del problema, come mostrato nella seguente immagine:

A scopo di revisione, nella seguente illustrazione vengono mostrate le icone del livello di severità:

- Fare clic su OK per scegliere una Revisione codice rapida.
Selezione di una base di codice da revisionare
Per selezionare il progetto come base del codice da revisionare:
- Sulla barra degli strumenti nella vista Revisione codice fare clic sull'icona Revisione (
) > Progetti > Revisione CodeReview_Examples.
Esecuzione della revisione codice
Una volta selezionata la base codice da revisionare, si esegue la revisione codice. È possibile tracciare lo stato verificando la barra progressiva nell'angolo in basso a destra della vista.
Visualizzazione dei risultati della revisione codice
Quando la revisione codice è finita, i risultati vengono mostrati nella vista Revisione codice, come mostrato nella seguente immagine:

La vista Revisione codice fornisce le seguenti informazioni:
- Le statistiche di revisione codice: la linea oltre le informazioni di visualizzazione relative alla revisione codice più recente: tipo, ambito, numero di regole e file inclusi e numero e severità dei risultati.
- Risultati revisione codice: i risultati dalla revisione codice vengono elencati raggruppati in cartelle sotto la vista Revisione codice. Ogni nome di cartella indica la categoria di regole applicate e il numero di elementi trovati.
Ottenere altre informazioni su un risultato della revisione codice
Per ottenere altre informazioni su un risultato nella revisione codice:
- Nella vista Revisione codice, spostarsi nella cartella J2SE Best Practices: confronto. Quindi espandere la cartella per mostrare i risultati, come illustrato nella seguente immagine:

- Il primo risultato inizia con EqualsHashCode_Example.java. La regola che viene applicata dopo questa:
Ignorare sempre java.lang.Object.equals() e java.lang.Object.hashCode()
- Fare doppio clic sul primo risultato. I dettagli del risultato vengono visualizzati in due posizioni, come indicato nei punti e nell'immagine seguenti:
- Codice sorgente: visualizza il codice in cui si trova il risultato ed evidenzia la posizione esatta di questo.
- Vista Dettagli revisione codice: descrive il risultato in dettaglio e fornisce gli esempi e le soluzioni per correggerlo.

Selezione di un risultato che ha una correzione rapida
È possibile indicare entrambi i risultati in Best Practices: la cartella confronto ha una correzione rapida dalle icone. A scopo di revisione, nella seguente illustrazione vengono mostrate le icone di correzione rapida:

- Fare clic con il pulsante destro sul primo risultato nell'elenco, come mostrato nella immagine successiva.
- La scelta del menu a comparsa Correzione rapida varia in base alla soluzione. Per il risultato selezionato, la correzione deve implementare hashCode e equals.

- Fare clic su Correzione rapida: implementare hashCode e equals.
Applicazione della correzione rapida
La correzione rapida per il risultato selezionato è quella di implementare hashCode e equals.
Per revisionare e applicare la correzione rapida al risultato:
- Si nota una vista progressiva del codice, come mostrato nella seguente immagine. Il codice sorgente originale è sulla sinistra e il codice sorgente riorganizzato che sarebbe creato dalla correzione rapida è sulla destra. Se si decide di applicare la correzione rapida, si aggiungono le linee mancanti del codice che sono evidenziate.

- Nella sezione Modifiche da effettuare espandere l'elenco per vedere esattamente quale correzione rapida modificare e come, come mostrato nella seguente immagine:

- Revisionare le modifiche nell'elenco. Quindi fare clic su OK per applicare la correzione rapida a tutte le modifiche selezionate nell'elenco.
- Dopo aver applicato la correzione rapida, si nota un segno di spunta accanto al risultato risolto.

Accanto al segno di spunta si vedono le seguenti informazioni:
- La correzione rapida applicata
- La riga del codice sorgente in cui è situato il risultato
- La regola nella revisione codice che non aderisce a
È stato completato l'Esercizio: Esecuzione di una revisione codice e applicazione di una correzione rapida.
Riepilogo esercizio
Sono state eseguite tutte le attività nell'esercizio: esecuzione di una revisione codice e applicazione di una correzione rapida.
Attività per l'esecuzione di una revisione codice
Quando si esegue questa revisione codice, si eseguono le seguenti attività:
- Selezionare una revisione codice da eseguire.
- Visualizzare le regole da applicare alla revisione codice.
- Scegliere un elemento di codice sul quale eseguire la revisione.
- Eseguire una revisione codice.
- Visualizzare i risultati della revisione codice.
- Selezionare un elemento risultato per vederne le seguenti relative informazioni:
- Codice sorgente.
- Descrizione, esempi e soluzioni.
Attività per l'applicazione di una correzione rapida
Quando viene applicata la correzione rapida, viene eseguito il seguente gruppo di attività:
- Riconosciuto quando la correzione rapida è disponibile per un risultato.
- Visto un elenco di modifiche che la correzione rapida esegue al codice.
- Visualizzato in anteprima l'originale e il codice riorganizzato.
- Applicata la correzione rapida per riorganizzare il codice.
- Ottenuta una conferma che la correzione rapida è stata applicata.
Sfruttamento delle potenzialità della revisione codice
Eseguendo in modo proattivo le revisioni codice, si è in grado di analizzare i risultati tempestivamente. Questo significa che è inoltre possibile indirizzarli tempestivamente, prima di arrivare ai seguenti problemi:
- Compromettere la scalabilità, manutenzione e le prestazioni dell'applicazione
- Valutare il guadagno aziendale, i tempi e le risorse
Sfruttamento delle potenzialità della correzione rapida
Applicando una correzione rapida fornita, esiste un modo automatizzato per risolvere un risultato comune. Le correzioni rapide facilitano nei seguenti casi:
- Correggere un problema in maniera consistente ogni volta
- Liberare nel codice e impiegare meno tempo a correggere i bug
Finire l'esercitazione revisionando gli obiettivi di apprendimento di Riepilogo: Eseguire una revisione codice.