6日でできる 新Java入門｜ソースファイルの構成

6日でできる 新Java入門｜ソースファイルの構成

Javaの型を知れば、コードはもっと読みやすくなる。ソースファイルの構成を覚えて、修行の土台を固めよう

Javaの学習を始めると、まず目にするのがソースファイルです。ソースファイルは、ただ文字が並んでいるだけのメモではありません。クラス、メソッド、文、コメントといった部品が、きちんとルールに沿って並べられた設計図のようなものです。ドラゴンボールの世界でたとえるなら、戦士が技を出すための動きや構えが、流派ごとにしっかり決まっているのと似ています。自由に見えても、実は土台には大切な型があります。

Javaでは、プログラムを書くときに好き勝手な形で書いてよいわけではありません。ファイル名とクラス名の対応、mainメソッドの位置づけ、文の終わり方、コメントの書き方など、いくつかの基本ルールがあります。これらを最初に理解しておくと、今後コードを書くときも読むときも、とても楽になります。逆にここがあいまいなままだと、どこがクラスで、どこが処理で、どこが補足説明なのかが見分けにくくなってしまいます。

この記事では、Javaのソースファイルがどんな部品で構成されているのかを、いちばんシンプルな例から少しずつ確認していきます。Lesson02_1.java では基本の形、Lesson02_2.java では少し処理を増やした形、Lesson02_3.java ではコメントの使い方を見ながら、ソースファイル全体の見取り図をつかんでいきます。ドラゴンボール風にいえば、まずは構えを覚え、そのあと基本技をつなぎ、最後に修行メモの残し方まで身につける流れです。ここを押さえておくと、Javaのコードがぐっと読みやすくなります。

ソースファイルの基本構成

Javaのソースファイルは、いくつかの大切な部品でできています。中心になるのはクラスです。そして、そのクラスの中に mainメソッド などのメソッドを書き、その中に文を書いて処理を組み立てていきます。必要に応じてコメントも加えます。

ドラゴンボール風に考えるなら、ソースファイルは修行書全体、クラスは流派の名前、メソッドは技の型、文は実際の動作のひとつひとつ、コメントは師匠が残した補足メモのようなものです。どれがどの役割なのかを見分けられるようになると、Javaのコードがただの文字列ではなく、意味のある構造として見えてきます。

ソースファイルを構成する主な部品

この表から分かるのは、Javaのソースファイルが単なる文章ではなく、役割の異なる部品の集まりだということです。最初は難しく感じても、ひとつずつ見れば整理して理解できます。

クラス名とソースファイル名の関係

Javaでは、public class で宣言したクラス名と、ソースファイル名を一致させる必要があります。これはJavaのとても大切なルールです。たとえば Lesson02_1 というクラスを書くなら、ファイル名も Lesson02_1.java にします。

このルールは、Javaがどのクラスがどのファイルにあるのかを正しく見つけるために必要です。もし名前が食い違っていると、コンパイル時にエラーになります。

ドラゴンボール風にいえば、流派名と修行書の表紙の名前が一致していないようなものです。表紙に 龍拳流 と書いてあるのに、中身の最初に 気弾流 と書かれていたら、読む側も混乱します。Javaも同じで、名前をそろえることで全体が整理されます。

クラス名とファイル名の基本ルール

例：

ここで大事なのは、大文字小文字も含めて一致させることです。Lesson02_1 と lesson02_1 は別物として扱われます。見た目が似ていても、Javaはきちんと区別します。

シンプルなソースファイルの形

まずは、Javaソースファイルのいちばん基本的な形を見てみます。短いプログラムでも、クラス、mainメソッド、文という大事な部品がそろっています。

ファイル名：Lesson02_1.java

public class Lesson02_1 {
    public static void main(String[] args) {
        // 修行の開始を知らせる
        System.out.println("気を整えて、Java修行を始めます。");
    }
}

実行結果

気を整えて、Java修行を始めます。

このプログラムでは、Lesson02_1 というクラスを宣言し、その中に mainメソッド を書いています。そして mainメソッド の中で System.out.println を使い、メッセージを1行表示しています。

短いですが、Javaの基本構造がしっかり入っています。ドラゴンボール風にたとえるなら、これは最初の基本構えを身につけるような段階です。まだ技の種類は少なくても、型が整っていることが大切です。

このプログラムで押さえたいこと

このように、たった数行でも、Javaプログラムの土台になる考え方が入っています。

mainメソッドの役割

Javaアプリケーションでは、mainメソッドが実行のスタート地点になります。これは Javaプログラムがどこから動き始めるのかを示す特別なメソッドです。

ドラゴンボール風に考えるなら、mainメソッドは試合開始の合図や、修行開始の第一声のようなものです。どれだけ多くの技や説明があっても、最初の合図がなければ動き出せません。Javaではその役割を mainメソッド が担っています。

mainメソッドの意味を分けて見る

最初のうちは、この全部を暗記しようとしなくても大丈夫です。まずは Javaプログラムの開始点として必要な定型の形 だと押さえておくとよいです。あとで少しずつ意味が深まっていきます。

少し長めのプログラムで構造を見る

次に、ソースファイルの中で処理が少し増えた場合の形を見てみます。ここでは変数、メソッド呼び出し、繰り返し、最後のメッセージまで入れた例にしています。

ファイル名：Lesson02_2.java

public class Lesson02_2 {
    // メインメソッド：修行の流れを開始する
    public static void main(String[] args) {
        String fighterName = "リュウタ";
        System.out.println("ようこそ、" + fighterName + "さん。");
        showTrainingMessage();
        for (int i = 1; i <= 2; i++) {
            System.out.println("かめはめ波の構えを " + i + " 回確認します。");
        }
        System.out.println("本日のJava修行を終了します。");
    }

    // 修行メッセージを表示するメソッド
    public static void showTrainingMessage() {
        System.out.println("基本の型を整えることが強さにつながります。");
    }
}

実行結果

ようこそ、リュウタさん。
基本の型を整えることが強さにつながります。
かめはめ波の構えを 1 回確認します。
かめはめ波の構えを 2 回確認します。
本日のJava修行を終了します。

このプログラムでは、mainメソッドの中でいくつかの文を順番に実行しています。さらに、showTrainingMessage という別のメソッドも用意し、それを呼び出しています。

元の文章では一般的なメソッド名でしたが、ここではドラゴンボール風の世界観に合わせて、修行メッセージを出す流れに寄せています。オブジェクト指向の入口として見るなら、クラスは戦士の修行書、メソッドはその修行書に書かれた動作や技、と考えるとイメージしやすいです。

このプログラムに入っている要素

この例から分かるのは、Javaのソースファイルが単なる1行表示だけで終わらず、複数の処理を組み合わせて構成できるということです。ソースファイルは、少しずつ部品を増やしながら成長させていけます。

文とその構成

Javaプログラムは、文の集まりでできています。文とは、プログラムの中で実際に行う処理の最小単位のことです。たとえば、画面に文字を表示する命令、変数に値を入れる命令、メソッドを呼び出す命令などが文にあたります。

Javaでは、多くの文は ; で終わります。これが文の終わりの合図です。ここが抜けるとエラーになります。

ドラゴンボール風にたとえるなら、文は技の動作の一区切りです。構える、気をためる、放つ、といったひとつひとつの動作が区切られているからこそ、全体の流れが分かりやすくなります。

文の基本ルール

たとえば、System.out.println("テスト"); も1つの文です。変数を作る String fighterName = "リュウタ"; も1つの文です。こうした文が積み重なって、プログラム全体が動いています。

インデントが大切な理由

Javaではインデントの幅そのものに厳しい決まりはありませんが、見やすさのためにとても大切です。mainメソッドの中を少し下げて書くことで、どこがクラスの中で、どこがメソッドの中なのかが視覚的に分かりやすくなります。

これは、修行書の段組みを整えて、どこが大見出しで、どこが補足なのかを見やすくするようなものです。動作そのものには直接影響しなくても、読みやすさには大きく影響します。

コメント文の使い方

コメントは、プログラムの説明や補足を書くためのものです。コメントに書いた内容は、実行するときには動作の対象になりません。つまり、人間が読みやすくするためのメモです。

ドラゴンボール風に考えるなら、コメントは師匠が修行書に書き込んだ注意書きのようなものです。ここで気を整える、この技は2回くり返す、ここは基本姿勢を確認する、といった補足があると、後から見直したときに理解しやすくなります。

コメントの種類

ファイル名：Lesson02_3.java

public class Lesson02_3 {
    public static void main(String[] args) {
        // 修行に入る前のあいさつを表示する
        System.out.println("修行メニューの確認を始めます。");

        /* ここでは
           複数行コメントの形を
           確認しています */
        System.out.println("コメントはプログラムの意図を伝える助けになります。"); // 行末コメント
    }
}

実行結果

修行メニューの確認を始めます。
コメントはプログラムの意図を伝える助けになります。

このプログラムでは、1行コメント、複数行コメント、行末コメントの使い方を確認できます。実際に画面へ表示されるのは System.out.println の内容だけで、コメント部分は実行結果には出ません。

コメントで意識したいこと

コメントは多ければよいわけではありません。大切なのは、コードを読む人にとって役立つ説明になっていることです。未来の自分に向けたメモでもあります。

ソースファイル全体を図でつかむ

ここまで見てきた内容を、全体の形として整理すると理解しやすくなります。クラスの中に mainメソッド があり、その中に文が入り、必要に応じてコメントが添えられる、という流れです。

下図は、Javaソースファイルの中で、クラス、mainメソッド、文、コメントがどのように入れ子になっているかを示したものです。外側にクラス、その内側に mainメソッド、その中に文やコメントが並ぶという構造が一目で分かります。

↓クリックすると拡大表示されます。

この図から分かること

この図を見ると、Javaソースファイルは平らに文字が並んでいるのではなく、外側から内側へと構造を持って組み立てられていることが分かります。クラスがいちばん大きな入れ物で、その中に mainメソッド があり、その中で文が動く、という関係が分かります。

ソースファイルを読むときに意識したい見方

Javaのコードを見るときは、いきなり細かい内容を全部追うよりも、まず全体の構造を見ると理解しやすいです。最初にクラス名を見る、次に mainメソッド を探す、そのあと文やコメントを見る、という順番です。

読む順番の目安

この見方を覚えておくと、新しいコードを見たときも迷いにくくなります。ドラゴンボールの修行書を読むときに、まず流派名を見て、次に基本の型を見て、そのあと細かな技の説明に入るような感覚です。

最初は型を覚えることが大切

Javaのソースファイルは、自由に見えて実はかなり整理された型を持っています。クラス名とファイル名を一致させること、mainメソッドを開始点として書くこと、文を ; で区切ること、コメントで補足を書くこと。こうしたルールは、最初のうちは少し窮屈に見えるかもしれません。でも、この型があるからこそ、誰が書いても読みやすく、Javaとして正しく動くプログラムになります。

ドラゴンボールの修行でも、いきなり派手な技に走るのではなく、まずは構えや呼吸や気の流し方といった型を身につけることが大切です。Javaのソースファイルの構成も同じです。Lesson02_1.java、Lesson02_2.java、Lesson02_3.java のような基本例を通して、まずはコードの形に慣れていくことが、これから先の学習を支えるしっかりした土台になります。