Summary  
This chapter explains how to annotate code with single-line (`//`) and multi-line (`/* … */`) comments that are ignored at runtime to clarify and document your code for human readers.

General domain of usage  
Code documentation

**Commenti** sono annotazioni all'interno del codice che vengono completamente ignorate dal programma durante l'esecuzione. Sono destinate agli esseri umani, non al computer — Java le salta durante l'esecuzione, quindi non influenzano in alcun modo il funzionamento del programma.

Nonostante ciò, i commenti sono estremamente utili. Aiutano a spiegare cosa fa il codice, a lasciare promemoria per sé stessi e a rendere i programmi più facili da leggere e comprendere — soprattutto quando diventano più lunghi o complessi.

## Commenti su una sola riga

Un commento su una sola riga inizia con `//`. Tutto ciò che viene scritto dopo `//` sulla stessa riga viene considerato un commento.


cGFja2FnZSBjb20uZXhhbXBsZTsKCnB1YmxpYyBjbGFzcyBNYWluIHsKICAgIHB1YmxpYyBzdGF0aWMgdm9pZCBtYWluKFN0cmluZ1tdIGFyZ3MpIHsKICAgICAgICAvLyBUaGlzIHByaW50cyBhIG1lc3NhZ2UgdG8gdGhlIHNjcmVlbgogICAgICAgIFN5c3RlbS5vdXQucHJpbnRsbigiSGVsbG8hIik7CiAgICB9Cn0=

## Commenti su più righe

Quando è necessario scrivere spiegazioni più lunghe, è possibile utilizzare i commenti su più righe. Questi iniziano con `/*` e terminano con `*/`. Tutto ciò che si trova tra questi simboli viene ignorato da Java.

```java
public class Main {
   public static void main(String[] args) {
       /*
       This program prints a simple message.
       The comment can span multiple lines.
       Java will ignore everything inside it.
       */
       System.out.println("Hello!");
   }
}
```

I commenti sono particolarmente utili nei programmi più grandi perché aiutano a comprendere cosa dovrebbero fare le diverse parti del codice senza dover analizzare tutto da zero.

import static org.junit.jupiter.api.Assertions.assertTrue;

import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.PrintStream;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.regex.Pattern;

import com.example.Main;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;

public class MainTest {

    @Test
    @DisplayName("The code prints the right message")
    void testPrintsHelloWorldFlexible() {
        ByteArrayOutputStream outContent = new ByteArrayOutputStream();
        PrintStream originalOut = System.out;
        System.setOut(new PrintStream(outContent));

        Main.main(new String[]{});

        System.setOut(originalOut);

        String output = outContent.toString().trim();

        Pattern pattern = Pattern.compile("Hey\\\s+I'm\\\s+working", Pattern.CASE_INSENSITIVE);
        assertTrue(pattern.matcher(output).find(), "Actual output: " + output);
    }

    @Test
    @DisplayName("Comment was used to ignore the line with mistake.")
    public void testContainsCommentToRemoveThirdLine() throws IOException {
        String path = "/app/devResources/java/src/main/java/com/example/Main.java";
        String content = new String(Files.readAllBytes(Paths.get(path)));

        String[] lines = content.split("\\\R");
        String normalizedContent = content.replaceAll("\\\s+", "");

        boolean foundAsComment = normalizedContent.contains("//System.out.println");

        assertTrue(foundAsComment);
    }
}

MainTest.java

Immergiti nei fondamenti di Java apprendendo i concetti chiave che alimentano le applicazioni moderne. Esplora variabili, tipi di dato, operatori, costrutti condizionali e stringhe mentre costruisci una solida base nella programmazione. Attraverso esempi pratici e sfide operative, svilupperai le competenze necessarie per scrivere, comprendere e risolvere problemi nel codice Java con sicurezza.

Scopri come iniziare il tuo percorso Java imparando cos'è Java, dove viene utilizzato e come sono strutturati i programmi Java. Comprendi come stampare output, scrivere commenti e costruire le basi necessarie per tutti i futuri concetti di programmazione.

Padroneggiare le competenze necessarie per memorizzare, gestire e lavorare con i dati in Java. Comprendere il funzionamento di variabili, costanti, tipi di dati, operatori e conversione di tipi, applicando questi concetti tramite esercizi pratici di programmazione ed esempi reali.

Esplora gli elementi essenziali del processo decisionale in Java lavorando con operatori di confronto e logici, istruzioni condizionali ed espressioni switch. Scopri come i programmi valutano le condizioni, prendono decisioni e rispondono a diverse situazioni attraverso esempi pratici e sfide.

Approfondisci i fondamenti della gestione del testo in Java. Scopri come vengono create e manipolate le stringhe, esplora le tecniche di formattazione e confronto, valida l'input dell'utente, estrai informazioni utili dal testo e applica queste competenze in scenari di programmazione realistici.

Commenti

Commenti su una sola riga

Commenti su più righe

Soluzione