JavaJavaコンソールアプリ

【Java】コンソールで操作するクイズアプリを作成

Javaクイズアプリ解説ページのアイキャッチ画像 Java

Javaを使用してコンソールで操作するクイズアプリケーションを作成する方法を解説します。この記事では、オブジェクト指向プログラミングの原則を活用し、レコードを使用した効率的なデータ構造の実装から、クイズゲームのロジックの構築、そしてメインプログラムの作成を紹介します。

はじめに

この記事のコードをコピペしてEclipseで出力結果を確認してみよう

Javaコンソールアプリ:クイズアプリを作成

以下のクイズアプリを作成します。

Javaクイズゲームへようこそ!
以下の質問に答えてください:

質問 1: 日本の首都は何ですか?
あなたの回答: 東京
正解です!

質問 2: 7 x 8 の答えは?
あなたの回答: 56
正解です!

質問 3: Javaはコンパイル言語ですか?それともインタープリタ言語ですか?
あなたの回答: コンパイル
正解です!

質問 4: Java 21 はどの年にリリースされましたか?
あなたの回答: 2023
正解です!

クイズ終了!
あなたのスコア: 4 / 4
正答率: 100.00%
  • クリックするとコードが表示されます。

Question.javaでレコードを使用し、質問のデータ構造を実装

Java
/**
 * 質問とその正解を表すレコードクラス。
 * ユーザーの回答が正解かどうかをチェックする機能も提供します。
 */
public record Question(String text, String correctAnswer) {
    
    /**
     * ユーザーの回答が正解かどうかをチェックするメソッド。
     * 大文字小文字は区別しません。
     *
     * @param userAnswer ユーザーが入力した回答
     * @return 正解の場合はtrue、不正解の場合はfalse
     */
    public boolean checkAnswer(String userAnswer) {
        return userAnswer.equalsIgnoreCase(correctAnswer);
    }
}

QuizGame.javaクイズゲームのロジックを実装

Java
import java.util.List;
import java.util.Scanner;

/**
 * Javaクイズゲームを実行するクラス。
 * 質問のリストを管理し、ユーザーとのインタラクションを処理します。
 */
public class QuizGame {
    private final List<Question> questions;
    private int score;

    /**
     * QuizGameのコンストラクタ。
     * @param questions クイズの質問リスト
     */
    public QuizGame(List<Question> questions) {
        this.questions = questions;
        this.score = 0;
    }

    /**
     * クイズゲームを開始するメソッド。
     * ユーザーに質問を提示し、回答を受け付けます。
     */
    public void start() {
        System.out.println("Javaクイズゲームへようこそ!");
        System.out.println("以下の質問に答えてください:");

        try (var scanner = new Scanner(System.in)) {
            for (int i = 0; i < questions.size(); i++) {
                askQuestion(questions.get(i), i + 1, scanner);
            }
        }

        displayResults();
    }

    /**
     * 個々の質問を処理するプライベートメソッド。
     * @param question 現在の質問
     * @param questionNumber 質問番号
     * @param scanner ユーザー入力を読み取るためのScanner
     */
    private void askQuestion(Question question, int questionNumber, Scanner scanner) {
        System.out.println("\n質問 " + questionNumber + ": " + question.text());
        System.out.print("あなたの回答: ");
        String userAnswer = scanner.nextLine();

        if (question.checkAnswer(userAnswer)) {
            System.out.println("正解です!");
            score++;
        } else {
            System.out.println("残念、不正解です。");
        }
    }

    /**
     * クイズの結果を表示するプライベートメソッド。
     * 最終スコアと正答率を計算して表示します。
     */
    private void displayResults() {
        System.out.println("\nクイズ終了!");
        System.out.println("あなたのスコア: " + score + " / " + questions.size());

        double percentage = (double) score / questions.size() * 100;
        System.out.printf("正答率: %.2f%%\n", percentage);
    }
}

Main.javaアプリケーションの開始地点を実装

Java
import java.util.List;

/**
 * クイズゲームを実行するメインクラス。
 * 質問リストを作成し、QuizGameを開始します。
 */
public class Main {
    /**
     * プログラムのエントリーポイント。
     * 質問リストを初期化し、QuizGameインスタンスを作成して開始します。
     *
     * @param args コマンドライン引数(このプログラムでは使用しません)
     */
    public static void main(String[] args) {
        // クイズの質問リストを作成
        var questions = List.of(
            new Question("日本の首都は何ですか?", "東京"),
            new Question("7 x 8 の答えは?", "56"),
            new Question("Javaはコンパイル言語ですか?それともインタープリタ言語ですか?", "コンパイル"),
            new Question("Java 21 はどの年にリリースされましたか?", "2023")
        );

        // QuizGameインスタンスを作成
        var game = new QuizGame(questions);

        // クイズゲームを開始
        game.start();
    }
}

Question.javaの解説

全体の構造

このコードはpublic recordという特殊なクラスを定義しています。recordはJava 14から導入された新しい機能で、主にデータを保持するためのクラスを簡潔に書くために使用されます。

レコードの定義

Java
public record Question(String text, String correctAnswer) {
    // メソッドの定義
}
  • public record:これがレコードの宣言です。
  • Question:レコードの名前です。
  • (String text, String correctAnswer):これらはレコードのコンポーネントと呼ばれ、自動的にprivate finalフィールドとして扱われます。

メソッドの定義

Java
public boolean checkAnswer(String userAnswer) {
    return userAnswer.equalsIgnoreCase(correctAnswer);
}

このメソッドはレコード内で定義されています:

  • public boolean:メソッドの戻り値の型がbooleanであることを示します。
  • checkAnswer:メソッド名です。
  • (String userAnswer):メソッドの引数です。ユーザーの回答を受け取ります。
  • return userAnswer.equalsIgnoreCase(correctAnswer);
    • equalsIgnoreCaseメソッドを使用して、ユーザーの回答と正解を大文字小文字を区別せずに比較します。
    • 一致すればtrue、一致しなければfalseを返します。

レコードの特徴

  1. コンストラクタが自動生成されます。
  2. getterメソッドが自動生成されます(例:text()、correctAnswer())。
  3. equals(), hashCode(), toString() メソッドが自動実装されます。

このレコードは、質問のテキストと正解を保持し、ユーザーの回答が正しいかどうかをチェックする機能を持つ簡潔なクラスです。

QuizGame.javaの解説

インポート文

Java
import java.util.List;
import java.util.Scanner;
  • ListインターフェースとScannerクラスをインポートしています。これらは質問リストの管理とユーザー入力の読み取りに使用されます。

クラス定義とフィールド

Java
public class QuizGame {
    private final List<Question> questions;
    private int score;
  • QuizGameクラスを定義しています。
  • private final List questions: 質問のリストを保持します。finalで宣言されているため、参照自体は変更できません。
  • private int score: プレイヤーのスコアを保持します。

コンストラクタ

Java
public QuizGame(List<Question> questions) {
    this.questions = questions;
    this.score = 0;
}
  • コンストラクタは質問のリストを引数として受け取ります。
  • this.questions = questions: 受け取った質問リストをフィールドに設定します。
  • this.score = 0: スコアを0に初期化します。

startメソッド

Java
public void start() {
    System.out.println("Javaクイズゲームへようこそ!");
    System.out.println("以下の質問に答えてください:");

    try (var scanner = new Scanner(System.in)) {
        for (int i = 0; i < questions.size(); i++) {
            askQuestion(questions.get(i), i + 1, scanner);
        }
    }

    displayResults();
}
  • ゲームの開始メッセージを表示します。
  • try-with-resources文を使用してScannerオブジェクトを作成します。これにより、使用後に自動的にScannerがクローズされます。
  • forループを使用して、各質問に対してaskQuestionメソッドを呼び出します。
  • ループ終了後、displayResultsメソッドを呼び出して結果を表示します。

askQuestionメソッド

Java
private void askQuestion(Question question, int questionNumber, Scanner scanner) {
    System.out.println("\n質問 " + questionNumber + ": " + question.text());
    System.out.print("あなたの回答: ");
    String userAnswer = scanner.nextLine();

    if (question.checkAnswer(userAnswer)) {
        System.out.println("正解です!");
        score++;
    } else {
        System.out.println("残念、不正解です。");
    }
}
  • 質問番号と質問テキストを表示します。
  • ユーザーの回答をscanner.nextLine()で読み取ります。
  • question.checkAnswer(userAnswer)を使用して回答をチェックします。
  • 正解の場合、”正解です!”と表示し、scoreを増やします。
  • 不正解の場合、”残念、不正解です。”と表示します。

displayResultsメソッド

Java
private void displayResults() {
    System.out.println("\nクイズ終了!");
    System.out.println("あなたのスコア: " + score + " / " + questions.size());

    double percentage = (double) score / questions.size() * 100;
    System.out.printf("正答率: %.2f%%\n", percentage);
}
  • クイズ終了のメッセージを表示します。
  • 最終スコアを表示します(正解数 / 総問題数)。
  • 正答率を計算します:(double) score / questions.size() * 100
  • System.out.printfを使用して、正答率を小数点以下2桁まで表示します。
書式指定子の解説
  • %.2f
    • %: 書式指定子の開始を示します。
    • .2: 小数点以下2桁まで表示することを指定します。
    • f: 浮動小数点数(float or double)を表示することを示します。
  • %%
    • %を文字として出力するために使用します。
    • printfメソッドでは%が特殊文字として扱われるため、%自体を出力したい場合は%%と記述します。
  • \n
    • 改行を表す特殊文字(エスケープシーケンス)です。
    • 出力後に改行を行います。

このクラスは、質問リストを管理し、ユーザーとのインタラクションを処理し、スコアを追跡し、最終結果を表示する完全なクイズゲームシステムを実装しています。重要なポイントとして、リストの使用、例外処理、ユーザー入力の処理、および書式付き出力が挙げられます。

Main.javaの解説

インポート文

Java
import java.util.List;
  • java.util.Listインターフェースをインポートしています。これは質問のリストを作成するために使用されます。

クラス定義

Java
public class Main {
    // メインメソッドがここに含まれます
}
  • Mainクラスを定義しています。このクラスはプログラムのエントリーポイントとなります。

メインメソッド

Java
public static void main(String[] args) {
    // メインメソッドの内容
}
  • public static void main(String[] args) は、Javaプログラムのエントリーポイントです。
  • プログラムが実行されると、このメソッドが最初に呼び出されます。

質問リストの作成

Java
var questions = List.of(
        new Question("日本の首都は何ですか?", "東京"),
        new Question("7 x 8 の答えは?", "56"),
        new Question("Javaはコンパイル言語ですか?それともインタープリタ言語ですか?", "コンパイル"),
        new Question("Java 21 はどの年にリリースされましたか?", "2023"));
  • var キーワードを使用して、型推論によりquestionsの型を自動的に決定しています。
  • List.of() メソッドを使用して、不変のリストを作成しています。
  • new Question(…) は、Questionオブジェクトを新しく作成しています。
  • 各Questionオブジェクトは、質問文と正解を引数として受け取ります。

QuizGameオブジェクトの作成と開始

Java
var game = new QuizGame(questions);
game.start();
  • new QuizGame(questions) で、先ほど作成した質問リストを使用してQuizGameオブジェクトを作成します。
  • game.start() を呼び出して、クイズゲームを開始します。

重要なポイント

  1. var キーワード:Java 10以降で導入された型推論を使用した変数宣言です。
  2. List.of() メソッド:Java 9以降で導入された、不変リストを簡単に作成するためのメソッドです。
  3. Questionクラス:別途定義されたクラスで、質問文と正解を保持します。
  4. QuizGameクラス:別途定義されたクラスで、クイズゲームの全体的なロジックを管理します。

このMainクラスは、クイズゲームの設定と開始を行う役割を果たしています。質問リストを作成し、それを使用してQuizGameオブジェクトを初期化し、ゲームを開始するという一連の流れを実装しています。

まとめ

  • Question.javaでレコードを使用し、効率的な質問データ構造を実装
  • QuizGame.javaクイズゲームのコアロジックを構築
  • Main.javaアプリケーションのエントリーポイントを作成し、全体を統合
  • オブジェクト指向設計の原則を実践的に適用する方法
  • レコードの特徴と利点を理解し、適切な使用方法
  • コレクションフレームワークを活用したデータ管理技術

このクイズアプリケーションの作成を通じて、Javaプログラミングの高度な概念実践的なスキルを身につけることができます。クラス設計データ構造の選択ユーザー入力の処理ゲームロジックの実装など、実際のアプリケーション開発で必要となる重要な要素を学ぶことができます。

また、このプロジェクトは拡張性が高く、追加の機能(例:タイマー、難易度レベル、スコア保存など)を実装することで、さらに複雑なアプリケーションへと発展させることができます。

未経験でもWEBスキルを取得したい方
  • Javaコース
    Javaプログラミングを基礎から応用まで、体系的に学べる実践的なカリキュラムが特徴です。「マインクラフト」を通じてJavaの基本文法とフレームワークの概念を学びます。また、実際のプロジェクト開発を通じて、データベース連携やWebアプリケーション開発のスキルを身につけることができます。

コメント

タイトルとURLをコピーしました