Java プログラムの構造

JPKODA 編集部 May 10, 2026

小説を書く前に言語の文法をマスターする必要があるように、Javaプログラミングにおいてもその基本構造を理解することは不可欠です。本章では、Javaプログラムを構成する各コンポーネントを解剖し、それぞれの役割とそれらがどのように連携して動作するのかを解説します。パッケージ (Packages)、クラス (Classes)、メソッド (Methods)、ステートメント (Statements)、そしてコメント (Comments) という、Javaプログラムを形作る5つの核心的な要素を探求していきましょう。

1. Java プログラムのコードスケルトン

本質的に、Javaプログラムはコンピュータに何をすべきかを伝える「インストラクション（命令）の集合体」です。これらの命令は、Javaが理解できる特定の構造に整理されています。それぞれのコアコンポーネントを順に見ていきましょう。

1.1 パッケージ (Packages)

パッケージは、関連するクラスやインターフェースを異なる「ネームスペース（名前空間）」に整理するために使用されます。コンピュータのファイルシステムにおける「フォルダ」のようなものだと考えてください。これらは名前の衝突を効果的に防ぎ、大規模なプロジェクトの管理を容易にします。

役割: 関連するクラスの整理とグループ化。
構文: package パッケージ名; （このコードは必ずJavaファイルの先頭に記述する必要があります）。
例: package com.example.myapp;

この例では、com.example.myapp がパッケージ名です。慣習として、世界中でのユニーク（一意）性を確保するために、会社のドメイン名を逆順にしたものをパッケージ名に使用します。

リアルな活用シーン: 大規模なECサイトのアプリケーションでは、商品関連を com.ecommerce.products、ユーザー関連を com.ecommerce.users、注文関連を com.ecommerce.orders といったパッケージで分け、それぞれのコードを整理します。

シミュレーション: ゲームを開発している場合、com.game.graphics (グラフィックス)、com.game.audio (オーディオ)、com.game.logic (ロジック) のようにモジュールごとにパッケージを分離します。

1.2 クラス (Classes)

クラスは、オブジェクトを作成するための「ブループリント（設計図）」または「テンプレート」です。そのクラスのオブジェクトが保持するデータ（フィールド/プロパティ）と振る舞い（メソッド）を定義します。Javaにおいて、すべての要素は「クラス」を中心に展開されます。

役割: オブジェクトの構造と振る舞いの定義。
構文: public class クラス名 { ... }

コード例:

package com.example.myapp;

public class MyClass {
    // フィールド（変数）
    int x;
    String name;

    // メソッド（関数）
    public void myMethod() {
        System.out.println("こんにちは、MyClassへようこそ！");
    }
}

解析: この例では、MyClass がクラス名です。2つのフィールド（x と name）と1つのメソッド（myMethod）が含まれています。public キーワードは、このクラスがプログラム内のどこからでもアクセス可能であることを意味します。

1.3 main メソッド

main メソッドは、Javaプログラムのエントリポイント（実行起点）です。Javaプログラムを実行すると、Java仮想マシン (JVM) は直接この main メソッドからコードの実行を開始します。独立して実行されるすべてのJavaアプリケーションには、必ず main メソッドが含まれていなければなりません。

役割: プログラム実行のスタート地点を提供。
構文: public static void main(String[] args) { ... }

詳細解説:

public: クラスの外部から呼び出せるようにします（JVMが呼び出すために必要）。
static: そのクラスのオブジェクトを生成（インスタンス化）することなく、直接このメソッドを呼び出せるようにします。
void: このメソッドが値を返さないことを示します。
main: メソッドの具体的な名称。これはJVMが要求する固定の名前です。
String[] args: 文字列の配列。コマンドラインからプログラムに引数を渡すために使用します。

コード例:

package com.example.myapp;

public class Main {
    public static void main(String[] args) {
        System.out.println("Hello, World!");
    }
}

1.4 ステートメント (Statements)

ステートメントは、Javaプログラムを構成する独立した命令です。コンピュータに特定の操作を実行させる役割を持ちます。Javaでは、すべてのステートメントは必ずセミコロン (;) で終わらなければなりません。

役割: 具体的な操作の実行。

コード例:

int x = 10; // 宣言と代入のステートメント
System.out.println(x); // 出力のステートメント
x = x + 5; // 代入（更新）のステートメント

ステートメントの分類:

宣言ステートメント (Declaration Statements): 変数を宣言するために使用（例: int x;）。
代入ステートメント (Assignment Statements): 変数に具体的な値を割り当てるために使用（例: x = 10;）。
制御フローステートメント (Control Flow Statements): コードの実行順序を制御（例: if, for, while）。
メソッド呼び出しステートメント (Method Call Statements): 既存のメソッドを実行（例: System.out.println("Hello");）。

1.5 コメント (Comments)

コメントは、コード内に追加できる説明書きです。コンパイラはこれらを完全に無視するため、純粋に人間がコードの意図やロジックを理解しやすくするために存在します。

役割: コードの意図やロジックの説明。
コメントの種類:

シングルラインコメント: // で始まり、その行の終わりまでがコメントになります。
マルチラインコメント: /* で始まり、*/ で終わります。複数行にわたる記述が可能です。
Javadocコメント: /** で始まり、*/ で終わります。このコメントは、コードから公式のAPIドキュメントを自動生成するために使用されます。

コード例:

// これはシングルラインコメントです

/*
 * これはマルチラインコメントです。
 * 複数の行にわたって記述できます。
 */

/**
 * これは Javadoc コメントです。
 * このクラスのドキュメントを生成するために使用されます。
 */
public class MyClass {
    // クラス内部のコメント
    int x; // 行の末尾に置くコメント
}

ベストプラクティス: 複雑なビジネスロジックを説明したり、変数やメソッドの具体的な用途を明記したりするために、コメントを適切に活用しましょう。未来の開発者（数ヶ月後の自分自身も含めて！）に、必要なコンテキストを提供することが重要です。

2. 完全な Java プログラムの例

これまでに学んだすべてのピースを組み合わせて、標準的なJavaプログラムを見てみましょう。

package com.example.myapp;

/**
 * このクラスは Java プログラムの基本構造をデモンストレーションします。
 */
public class MyProgram {

    /**
     * main メソッドはプログラムのエントリポイントです。
     * @param args コマンドライン引数（この例では使用されません）。
     */
    public static void main(String[] args) {
        // コンソールにウェルカムメッセージを表示
        System.out.println("Javaの世界へようこそ！");

        // シンプルな数学的計算を実行
        int x = 5;
        int y = 10;
        int sum = x + y;

        // 計算結果を出力
        System.out.println(x + " と " + y + " の合計は: " + sum);
    }
}

このプログラムは、パッケージの宣言、クラスの定義、main メソッドの構造、具体的な実行ステートメント、そして各種コメントの使い方を網羅しています。シンプルですが、Javaプログラムの屋台骨（スケルトン）を完璧に凝縮した形になっています。