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

**Comentarios** son notas dentro de tu código que son completamente ignoradas por el programa cuando se ejecuta. Están destinados a las personas, no a la computadora — Java los omite durante la ejecución, por lo que no afectan el funcionamiento de tu programa de ninguna manera.

A pesar de eso, los comentarios son extremadamente útiles. Ayudan a explicar lo que hace tu código, dejar recordatorios para ti mismo y hacer que tus programas sean más fáciles de leer y entender, especialmente cuando se vuelven más largos o complejos.

## Comentarios de una sola línea

Un comentario de una sola línea comienza con `//`. Todo lo que se escriba después de `//` en la misma línea se trata como un comentario.


cGFja2FnZSBjb20uZXhhbXBsZTsKCnB1YmxpYyBjbGFzcyBNYWluIHsKICAgIHB1YmxpYyBzdGF0aWMgdm9pZCBtYWluKFN0cmluZ1tdIGFyZ3MpIHsKICAgICAgICAvLyBUaGlzIHByaW50cyBhIG1lc3NhZ2UgdG8gdGhlIHNjcmVlbgogICAgICAgIFN5c3RlbS5vdXQucHJpbnRsbigiSGVsbG8hIik7CiAgICB9Cn0=

## Comentarios multilínea

Para escribir explicaciones más extensas, se pueden utilizar comentarios multilínea. Estos comienzan con `/*` y terminan con `*/`. Todo lo que se encuentre entre ellos es ignorado por 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!");
   }
}
```

Los comentarios son especialmente útiles en programas grandes porque ayudan a comprender qué hacen las diferentes partes del código sin tener que analizar todo desde cero.

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

Sumérgete en los fundamentos de Java aprendiendo los conceptos clave que impulsan las aplicaciones modernas. Explora variables, tipos de datos, operadores, condicionales y cadenas de texto mientras construyes una base sólida en programación. A través de ejemplos prácticos y desafíos interactivos, desarrollarás las habilidades necesarias para escribir, comprender y depurar código Java con confianza.

Descubre cómo comenzar tu camino en Java aprendiendo qué es Java, dónde se utiliza y cómo se estructuran los programas en Java. Comprende cómo imprimir salidas, escribir comentarios y construir la base necesaria para todos los conceptos de programación futuros.

Domina las habilidades necesarias para almacenar, gestionar y trabajar con datos en Java. Aprende cómo funcionan las variables, constantes, tipos de datos, operadores y conversión de tipos, y aplica estos conceptos mediante ejercicios prácticos de codificación y ejemplos del mundo real.

Explora los aspectos esenciales de la toma de decisiones en Java mediante el uso de operadores de comparación y lógicos, sentencias condicionales y expresiones switch. Aprende cómo los programas evalúan condiciones, toman decisiones y responden a diferentes situaciones a través de ejemplos prácticos y desafíos.

Sumérgete en los fundamentos del trabajo con texto en Java. Aprende cómo se crean y manipulan las cadenas, explora técnicas de formato y comparación, valida la entrada del usuario, extrae información útil del texto y aplica estas habilidades en escenarios de programación realistas.

Comentarios

Comentarios de una sola línea

Comentarios multilínea

Solución