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

**Comentários** são anotações dentro do seu código que são completamente ignoradas pelo programa durante a execução. Eles são destinados a pessoas, não ao computador — o Java os ignora durante a execução, portanto, não afetam o funcionamento do seu programa de nenhuma forma.

Apesar disso, os comentários são extremamente úteis. Eles ajudam a explicar o que seu código está fazendo, servem como lembretes para você mesmo e tornam seus programas mais fáceis de ler e entender — especialmente quando ficam mais longos ou complexos.

## Comentários de uma linha

Um comentário de uma linha começa com `//`. Tudo o que for escrito após `//` na mesma linha é tratado como comentário.


cGFja2FnZSBjb20uZXhhbXBsZTsKCnB1YmxpYyBjbGFzcyBNYWluIHsKICAgIHB1YmxpYyBzdGF0aWMgdm9pZCBtYWluKFN0cmluZ1tdIGFyZ3MpIHsKICAgICAgICAvLyBUaGlzIHByaW50cyBhIG1lc3NhZ2UgdG8gdGhlIHNjcmVlbgogICAgICAgIFN5c3RlbS5vdXQucHJpbnRsbigiSGVsbG8hIik7CiAgICB9Cn0=

## Comentários de múltiplas linhas

Para explicações mais longas, utilize comentários de múltiplas linhas. Eles começam com `/*` e terminam com `*/`. Tudo o que estiver entre eles é ignorado pelo 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!");
   }
}
```

Comentários são especialmente úteis em programas maiores, pois ajudam a compreender o propósito de diferentes partes do código sem a necessidade de analisar tudo do 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

Mergulhe nos fundamentos do Java aprendendo os conceitos centrais que impulsionam aplicações modernas. Explore variáveis, tipos de dados, operadores, condicionais e strings enquanto constrói uma base sólida em programação. Por meio de exemplos práticos e desafios interativos, você desenvolverá as habilidades necessárias para escrever, compreender e depurar código Java com confiança.

Descubra como iniciar sua jornada em Java aprendendo o que é Java, onde é utilizado e como os programas Java são estruturados. Compreenda como exibir saídas, escrever comentários e construir a base necessária para todos os conceitos futuros de programação.

Domine as habilidades necessárias para armazenar, gerenciar e trabalhar com dados em Java. Aprenda como variáveis, constantes, tipos de dados, operadores e conversão de tipos funcionam, e aplique esses conceitos por meio de exercícios práticos de programação e exemplos do mundo real.

Explore os fundamentos da tomada de decisão em Java ao trabalhar com operadores de comparação e lógicos, instruções condicionais e expressões switch. Aprenda como os programas avaliam condições, tomam decisões e respondem a diferentes situações por meio de exemplos práticos e desafios.

Mergulhe nos fundamentos do trabalho com texto em Java. Aprenda como as strings são criadas e manipuladas, explore técnicas de formatação e comparação, valide a entrada do usuário, extraia informações úteis de textos e aplique essas habilidades em cenários de programação realistas.

Comentários

Comentários de uma linha

Comentários de múltiplas linhas

Solução