基礎から学ぶC#入門 90日コース | 総合アプリ開発 - Day 84:基本機能①

C# 90日で身につけるC#
スポンサーリンク
スポンサーリンク

Day 84:基本機能① — データ登録

Day 83で設計したクラス構造に基づき、読書管理アプリの最初の基本機能である「本の登録」を実装します。この機能は、ユーザーが本の情報を入力し、それをアプリに保存するためのものです。ここでは、コンソールアプリとしての実装手順を段階的に説明します。


ステップ1:登録機能の流れを確認する

本の登録は、以下の手順で進めます。

  1. ユーザーに入力を促す:タイトル、著者、カテゴリなどの情報を入力してもらいます。
  2. 入力チェックを行う:必須項目が空でないか、評価が1〜5の範囲内かなどを確認します。
  3. データをモデルに格納する:入力された情報を BookItem オブジェクトに設定します。
  4. サービス層を呼び出す:BookService を使ってデータを保存します。
  5. 結果をユーザーに伝える:登録が成功したかどうかをフィードバックします。

ステップ2:入力ヘルパーメソッドを用意する

ユーザーからの入力を受け取り、必須項目のチェックを行うためのヘルパーメソッドを Program.cs に追加します。

using System;
using ReadingApp.Models;

namespace ReadingApp
{
    class Program
    {
        // 必須の文字列入力を取得します
        static string ReadRequiredString(string prompt)
        {
            while (true)
            {
                Console.Write(prompt);
                string input = Console.ReadLine()?.Trim() ?? "";

                if (!string.IsNullOrEmpty(input))
                {
                    return input;
                }

                Console.WriteLine("入力が必須です。再度入力してください。");
            }
        }

        // 任意の文字列入力を取得します
        static string ReadOptionalString(string prompt, string defaultValue = "")
        {
            Console.Write(prompt);
            string input = Console.ReadLine()?.Trim() ?? "";
            return string.IsNullOrEmpty(input) ? defaultValue : input;
        }

        // 評価を取得します(1〜5または未設定)
        static int? ReadRating()
        {
            while (true)
            {
                Console.Write("評価(1〜5、未設定の場合はEnter): ");
                string input = Console.ReadLine()?.Trim() ?? "";

                if (string.IsNullOrEmpty(input))
                {
                    return null; // 未設定
                }

                if (int.TryParse(input, out int rating) && rating >= 1 && rating <= 5)
                {
                    return rating;
                }

                Console.WriteLine("評価は1〜5の整数で入力してください。");
            }
        }
    }
}
C#

ステップ3:本の登録メソッドを実装する

Program.cs に、本の登録を行うメソッド AddBook を追加します。このメソッドは、BookService を利用してデータを保存します。

static void AddBook(BookService bookService)
{
    Console.WriteLine("\n=== 本の登録 ===");

    // ユーザーから入力を受け取る
    string title = ReadRequiredString("タイトル: ");
    string author = ReadOptionalString("著者: ");
    string category = ReadOptionalString("カテゴリ: ");
    int? rating = ReadRating();

    // BookItem オブジェクトを作成
    var book = new BookItem
    {
        Title = title,
        Author = author,
        Category = category,
        Status = ReadingStatus.Unread, // 初期値は「未読」
        Rating = rating
    };

    try
    {
        // サービス層を呼び出して保存
        bookService.AddBook(book);
        Console.WriteLine("本を登録しました。");
    }
    catch (ArgumentException ex)
    {
        Console.WriteLine($"エラー: {ex.Message}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"予期せぬエラーが発生しました: {ex.Message}");
    }
}
C#

ステップ4:メインメニューに登録機能を組み込む

Main メソッドで BookService を初期化し、メニューから登録機能を呼び出せるようにします。

static void Main()
{
    // リポジトリとサービスを初期化
    var repository = new JsonBookRepository("books.json");
    var bookService = new BookService(repository);

    while (true)
    {
        Console.WriteLine("\n読書管理アプリ");
        Console.WriteLine("1. 本を登録");
        Console.WriteLine("2. 本の一覧を表示");
        Console.WriteLine("3. 終了");
        Console.Write("選択: ");

        string choice = Console.ReadLine()?.Trim() ?? "";

        switch (choice)
        {
            case "1":
                AddBook(bookService);
                break;
            case "2":
                // 一覧表示機能は次回実装
                Console.WriteLine("機能は準備中です。");
                break;
            case "3":
                return;
            default:
                Console.WriteLine("1から3の番号を選んでください。");
                break;
        }
    }
}
C#

ステップ5:動作確認を行う

プログラムを実行し、以下の操作を行って正しく動作するか確認します。

  1. 必須項目のチェック:タイトルを空欄にした場合、再入力を促されるか。
  2. 評価の範囲チェック:評価に 0 や 6 を入力した場合、エラーメッセージが表示されるか。
  3. 正常な登録:すべての情報を正しく入力した場合、books.json ファイルにデータが保存されるか。

ステップ6:データ保存の確認

登録が成功すると、books.json ファイルが作成され、以下のようなJSON形式でデータが保存されます。

[
  {
    "Id": 1,
    "Title": "C#入門",
    "Author": "山田太郎",
    "Category": "技術書",
    "Status": 0,
    "Rating": 4
  }
]
JSON

このファイルは、アプリを再起動した後もデータが保持されることを確認するために重要です。


ステップ7:エラーハンドリングを強化する

登録時に発生し得るエラーに対処するため、以下の点を考慮します。

  • ファイルの書き込み権限がない場合: `IOException` をキャッチし、ユーザーに通知します。
  • JSONのシリアライズに失敗した場合: `JsonException` をキャッチし、データが破損しないようにします。
try
{
    bookService.AddBook(book);
    Console.WriteLine("本を登録しました。");
}
catch (IOException ex)
{
    Console.WriteLine($"ファイルの保存に失敗しました: {ex.Message}");
}
catch (JsonException ex)
{
    Console.WriteLine($"データの形式が不正です: {ex.Message}");
}
catch (Exception ex)
{
    Console.WriteLine($"予期せぬエラーが発生しました: {ex.Message}");
}
C#

ステップ8:リファクタリングの機会を探す

現時点でのコードは機能しますが、以下のような改善点が考えられます。

  • 入力ヘルパーの汎用化: 他の機能(編集や検索)でも同じ入力チェックを使い回せるようにします。
  • サービスのメソッド分割: `AddBook` の前にバリデーションを別メソッドに分離し、テストを容易にします。
  • エラーメッセージの一元化: エラーメッセージをリソースファイルや定数で管理します。

Day 84のゴール

  • 本の登録機能を実装し、必須項目のチェックとデータ保存が行えるようになります。
  • ユーザーからの入力を受け取り、モデルにマッピングする方法を理解します。
  • 例外処理を追加し、堅牢なアプリケーションの基礎を築きます。

まとめ

Day 84では、読書管理アプリの最初の基本機能である「本の登録」を実装しました。入力チェック、モデルへのマッピング、サービス層を介したデータ保存の流れを学びました。次回は、登録した本の一覧表示機能を実装し、データの読み込みと表示方法を習得します。

  • 必須項目のチェックは、ユーザーが正しいデータを入力するための重要なステップです。
  • サービス層を利用することで、ビジネスロジックとデータアクセスを分離できます。
  • 例外処理を適切に行うことで、アプリの信頼性が向上します。
タイトルとURLをコピーしました