Day 84:基本機能① — データ登録
Day 83で設計したクラス構造に基づき、読書管理アプリの最初の基本機能である「本の登録」を実装します。この機能は、ユーザーが本の情報を入力し、それをアプリに保存するためのものです。ここでは、コンソールアプリとしての実装手順を段階的に説明します。
ステップ1:登録機能の流れを確認する
本の登録は、以下の手順で進めます。
- ユーザーに入力を促す:タイトル、著者、カテゴリなどの情報を入力してもらいます。
- 入力チェックを行う:必須項目が空でないか、評価が1〜5の範囲内かなどを確認します。
- データをモデルに格納する:入力された情報を
BookItemオブジェクトに設定します。 - サービス層を呼び出す:
BookServiceを使ってデータを保存します。 - 結果をユーザーに伝える:登録が成功したかどうかをフィードバックします。
ステップ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:動作確認を行う
プログラムを実行し、以下の操作を行って正しく動作するか確認します。
- 必須項目のチェック:タイトルを空欄にした場合、再入力を促されるか。
- 評価の範囲チェック:評価に
0や6を入力した場合、エラーメッセージが表示されるか。 - 正常な登録:すべての情報を正しく入力した場合、
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では、読書管理アプリの最初の基本機能である「本の登録」を実装しました。入力チェック、モデルへのマッピング、サービス層を介したデータ保存の流れを学びました。次回は、登録した本の一覧表示機能を実装し、データの読み込みと表示方法を習得します。
- 必須項目のチェックは、ユーザーが正しいデータを入力するための重要なステップです。
- サービス層を利用することで、ビジネスロジックとデータアクセスを分離できます。
- 例外処理を適切に行うことで、アプリの信頼性が向上します。
