Day 85:基本機能② — データ一覧
Day 84で実装した本の登録機能に続き、今回は登録した本の一覧を表示する機能を追加します。この機能は、ユーザーがこれまでに登録した本を確認し、読書状況や評価を把握するために不可欠です。コンソールアプリとしての実装手順を段階的に説明します。
ステップ1:一覧表示の要件を確認する
一覧表示では、以下の情報をユーザーに提供します。
- 登録されているすべての本を表示します
- 各本について、ID、タイトル、著者、カテゴリ、読書状況、評価を表示します
- 読書状況は「未読」「読書中」「読了」のいずれかで表示します
- 評価は1〜5の数値で表示し、未評価の場合は「-」と表示します
- 本が1冊も登録されていない場合は、その旨を伝えるメッセージを表示します
ステップ2:サービス層に一覧取得メソッドを追加する
IBookService インターフェースに、すべての本を取得するメソッドを定義します。このメソッドは、BookService クラスで実装します。
1. インターフェースにメソッドを追加
namespace ReadingApp.Services
{
public interface IBookService
{
// 既存のメソッドは省略...
// すべての本を取得します
List<BookItem> GetAllBooks();
}
}C#2. サービスクラスでメソッドを実装
namespace ReadingApp.Services
{
public class BookService : IBookService
{
private readonly IBookRepository _repository;
// 既存のコンストラクタとメソッドは省略...
// すべての本を取得します
public List<BookItem> GetAllBooks()
{
return _repository.GetAll();
}
}
}C#ステップ3:一覧表示用のヘルパーメソッドを用意する
Program.cs に、本の一覧を整形して表示するためのヘルパーメソッドを追加します。
using System;
using ReadingApp.Models;
using ReadingApp.Services;
namespace ReadingApp
{
class Program
{
// 既存のメソッドは省略...
// 本の一覧を表示します
static void ShowAllBooks(BookService bookService)
{
Console.WriteLine("\n=== 登録済みの本一覧 ===");
// サービス層からすべての本を取得
var books = bookService.GetAllBooks();
if (books.Count == 0)
{
Console.WriteLine("登録されている本はありません。");
return;
}
// ヘッダー行を表示
Console.WriteLine("ID | タイトル | 著者 | カテゴリ | 状況 | 評価");
Console.WriteLine(new string('-', 70));
// 各本の情報を表示
foreach (var book in books)
{
// 読書状況を文字列に変換
string status = book.Status switch
{
ReadingStatus.Unread => "未読",
ReadingStatus.Reading => "読書中",
ReadingStatus.Finished => "読了",
_ => "不明"
};
// 評価を表示(未評価の場合は "-")
string rating = book.Rating?.ToString() ?? "-";
Console.WriteLine($"{book.Id,2} | {book.Title,-15} | {book.Author,-10} | {book.Category,-8} | {status,-5} | {rating}");
}
}
}
}C#ステップ4:メインメニューに一覧表示機能を組み込む
Main メソッドで、ユーザーがメニューから一覧表示を選択できるようにします。
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":
ShowAllBooks(bookService); // 一覧表示を呼び出す
break;
case "3":
return;
default:
Console.WriteLine("1から3の番号を選んでください。");
break;
}
}
}C#ステップ5:動作確認を行う
プログラムを実行し、以下の操作を行って正しく動作するか確認します。
- 本を登録する:複数の本を登録し、
books.jsonファイルにデータが保存されていることを確認します。 - 一覧を表示する:登録した本がすべて表示され、読書状況や評価が正しく反映されているか確認します。
- 本が未登録の場合:「登録されている本はありません。」と表示されるか確認します。
ステップ6:表示の改善(オプション)
一覧の見た目をさらに整えるために、以下のような改善が考えられます。
1. 評価を星で表示する
評価を数値ではなく星(★)で表示すると、直感的に分かりやすくなります。
// 評価を星で表示(未評価の場合は "-")
string rating = book.Rating.HasValue
? new string('★', book.Rating.Value) + new string('☆', 5 - book.Rating.Value)
: "-";C#2. ページネーションを追加する
登録された本が多い場合、一度にすべてを表示せず、ページごとに区切って表示します。
static void ShowAllBooks(BookService bookService, int pageSize = 5)
{
var books = bookService.GetAllBooks();
int totalPages = (int)Math.Ceiling((double)books.Count / pageSize);
int currentPage = 1;
while (true)
{
Console.Clear();
Console.WriteLine($"=== 登録済みの本一覧 (ページ {currentPage}/{totalPages}) ===");
var pageBooks = books.Skip((currentPage - 1) * pageSize).Take(pageSize).ToList();
if (pageBooks.Count == 0)
{
Console.WriteLine("表示する本がありません。");
break;
}
// ヘッダーと本の表示(省略)
Console.WriteLine("\n[N] 次ページ, [P] 前ページ, [Q] 終了");
Console.Write("選択: ");
var key = Console.ReadKey().Key;
if (key == ConsoleKey.N && currentPage < totalPages)
{
currentPage++;
}
else if (key == ConsoleKey.P && currentPage > 1)
{
currentPage--;
}
else if (key == ConsoleKey.Q)
{
break;
}
}
}C#ステップ7:エラーハンドリングを追加する
一覧表示時にも例外が発生する可能性があるため、適切なエラーハンドリングを行います。
static void ShowAllBooks(BookService bookService)
{
try
{
Console.WriteLine("\n=== 登録済みの本一覧 ===");
var books = bookService.GetAllBooks();
if (books.Count == 0)
{
Console.WriteLine("登録されている本はありません。");
return;
}
// 表示処理(省略)
}
catch (Exception ex)
{
Console.WriteLine($"本の一覧を取得できませんでした: {ex.Message}");
}
}C#Day 85のゴール
- 登録した本の一覧を表示する機能を実装できます
- サービス層を利用してデータを取得し、コンソールに整形して表示できます
- 読書状況や評価を分かりやすく表示する方法を学びます
- ページネーションやエラーハンドリングなどの拡張方法を理解します
まとめ
Day 85では、読書管理アプリの「本の一覧表示」機能を実装しました。サービス層からデータを取得し、コンソールに整形して表示する流れを学びました。次回は、本の検索や読書状況の更新機能を追加し、アプリの操作性をさらに向上させます。
- 一覧表示は、登録データを確認するための基本機能です
- サービス層を活用することで、データ取得と表示の責務を分離できます
- 見た目の整形やページネーションにより、ユーザーエクスペリエンスを向上させられます
- 例外処理を適切に行うことで、アプリの信頼性が高まります

