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

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

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:動作確認を行う

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

  1. 本を登録する:複数の本を登録し、books.json ファイルにデータが保存されていることを確認します。
  2. 一覧を表示する:登録した本がすべて表示され、読書状況や評価が正しく反映されているか確認します。
  3. 本が未登録の場合:「登録されている本はありません。」と表示されるか確認します。

ステップ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では、読書管理アプリの「本の一覧表示」機能を実装しました。サービス層からデータを取得し、コンソールに整形して表示する流れを学びました。次回は、本の検索や読書状況の更新機能を追加し、アプリの操作性をさらに向上させます。

  • 一覧表示は、登録データを確認するための基本機能です
  • サービス層を活用することで、データ取得と表示の責務を分離できます
  • 見た目の整形やページネーションにより、ユーザーエクスペリエンスを向上させられます
  • 例外処理を適切に行うことで、アプリの信頼性が高まります
タイトルとURLをコピーしました