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

**コメント**は、コード内に記述されるメモであり、プログラムの実行時には完全に無視される要素。
これらはコンピュータではなく人間のためのものであり、Javaは実行時にコメントを読み飛ばすため、プログラムの動作には一切影響を与えない。

それにもかかわらず、コメントは非常に有用な存在。
コードの内容を説明したり、自分自身へのリマインダーを残したり、プログラムを読みやすく理解しやすくするのに役立つ。
特に、プログラムが長くなったり複雑になった場合にその効果が大きい。

## 一行コメント

一行コメントは `//` で始まる。
同じ行で `//` の後に書かれた内容はすべてコメントとして扱われる。


cGFja2FnZSBjb20uZXhhbXBsZTsKCnB1YmxpYyBjbGFzcyBNYWluIHsKICAgIHB1YmxpYyBzdGF0aWMgdm9pZCBtYWluKFN0cmluZ1tdIGFyZ3MpIHsKICAgICAgICAvLyBUaGlzIHByaW50cyBhIG1lc3NhZ2UgdG8gdGhlIHNjcmVlbgogICAgICAgIFN5c3RlbS5vdXQucHJpbnRsbigiSGVsbG8hIik7CiAgICB9Cn0=

## 複数行コメント

より長い説明を書く必要がある場合は、複数行コメントを使用できます。これらは `/*` で始まり、`*/` で終わります。その間にあるすべての内容は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!");
   }
}
```

コメントは特に大規模なプログラムで有用です。コードの各部分が何をするのかを、すべてを最初から分析しなくても理解しやすくなります。

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

Javaの基礎を学び、現代のアプリケーションを支えるコアコンセプトを探求します。変数、データ型、演算子、条件分岐、文字列について学びながら、プログラミングの強固な基礎を築きます。実践的な例やハンズオン課題を通じて、Javaコードの記述、理解、トラブルシューティングに必要なスキルを自信を持って身につけます。

Javaとは何か、どこで使用されているか、Javaプログラムの構造について学び、Javaの学習を始めましょう。出力の表示方法、コメントの記述方法を理解し、今後のすべてのプログラミング概念の基礎を築きます。

Javaでデータを保存、管理、操作するために必要なスキルを習得します。変数、定数、データ型、演算子、型変換の仕組みを学び、実践的なコーディング演習や実例を通じてこれらの概念を応用します。

Javaにおける意思決定の基本を、比較演算子や論理演算子、条件文、switch式を使って学びます。プログラムが条件を評価し、選択を行い、さまざまな状況に応じて応答する方法を、実践的な例や課題を通じて理解します。

Javaにおけるテキスト操作の基礎を学びます。文字列の生成と操作方法、フォーマットや比較の手法、ユーザー入力の検証、テキストからの有用な情報の抽出、そしてこれらのスキルを実際のプログラミングシナリオで応用する方法を探求します。

コメント

一行コメント

複数行コメント

解答