Featured image of post 第9回-完成!レポートジェネレーター - PerlとMooでレポートジェネレーターを作ってみよう

第9回-完成!レポートジェネレーター - PerlとMooでレポートジェネレーターを作ってみよう

全機能を統合してレポートジェネレーターを完成させます。月次・週次・日次・四半期レポートを生成できる、拡張性の高いシステムの全体像をお見せします。

@nqounetです。

前回の振り返り

前回は、四半期レポートを追加して、開放閉鎖原則を実証しました。

  • QuarterlyReportクラスを新規作成した
  • QuarterlyReportGeneratorクラスを新規作成した
  • 既存のコードを一切修正せずに機能を追加できた

今回の目標

今回は、これまで作ってきた全ての機能を統合して、レポートジェネレーターを完成させます。

具体的には、以下のことを行います。

  • 完成したクラス群の全体像を確認する
  • 各種レポートの生成例を実行する
  • 設計の振り返りと今後の拡張について考える

シリーズの振り返り

これまでの流れを振り返ってみましょう。

何をしたか
第1回月次レポートを生成する基本クラスを作成
第2回週次レポートを追加(if/elseで切り替え)→ 問題発覚
第3回ReportRoleで共通ルールを定義
第4回継承でジェネレーターを種別ごとに分離
第5回create_reportをオーバーライドして生成処理を実装
第6回基底クラスに共通処理を集約
第7回isaで型チェックを追加
第8回四半期レポートを追加して拡張性を実証

完成コード

コード例1: 完成したクラス群の全体像

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
#!/usr/bin/env perl
use v5.36;

# ========================================
# ReportRole ロール
# すべてのレポートが持つべきメソッドを定義
# ========================================
package ReportRole {
    use Moo::Role;

    requires 'generate';
    requires 'get_period';
}

# ========================================
# MonthlyReport クラス
# ========================================
package MonthlyReport {
    use Moo;
    with 'ReportRole';

    has title => (
        is       => 'ro',
        required => 1,
    );

    sub generate ($self) {
        my @lines = (
            "╔══════════════════════════════════════╗",
            "║ " . $self->title,
            "╠══════════════════════════════════════╣",
            "║ 期間: " . $self->get_period(),
            "║ 種別: 月次売上レポート",
            "╚══════════════════════════════════════╝",
        );
        return join("\n", @lines);
    }

    sub get_period ($self) {
        return '月次';
    }
}

# ========================================
# WeeklyReport クラス
# ========================================
package WeeklyReport {
    use Moo;
    with 'ReportRole';

    has title => (
        is       => 'ro',
        required => 1,
    );

    sub generate ($self) {
        my @lines = (
            "┌──────────────────────────────────────┐",
            "│ " . $self->title,
            "├──────────────────────────────────────┤",
            "│ 期間: " . $self->get_period(),
            "│ 種別: 週次売上レポート",
            "└──────────────────────────────────────┘",
        );
        return join("\n", @lines);
    }

    sub get_period ($self) {
        return '週次';
    }
}

# ========================================
# DailyReport クラス
# ========================================
package DailyReport {
    use Moo;
    with 'ReportRole';

    has title => (
        is       => 'ro',
        required => 1,
    );

    sub generate ($self) {
        my @lines = (
            "+-----------------------------------------+",
            "| " . $self->title,
            "+-----------------------------------------+",
            "| 期間: " . $self->get_period(),
            "| 種別: 日次売上レポート",
            "+-----------------------------------------+",
        );
        return join("\n", @lines);
    }

    sub get_period ($self) {
        return '日次';
    }
}

# ========================================
# QuarterlyReport クラス
# ========================================
package QuarterlyReport {
    use Moo;
    with 'ReportRole';

    has title => (
        is       => 'ro',
        required => 1,
    );

    has quarter => (
        is       => 'ro',
        required => 1,
    );

    sub generate ($self) {
        my @lines = (
            "╔══════════════════════════════════════════╗",
            "║ " . $self->title,
            "╠══════════════════════════════════════════╣",
            "║ 期間: " . $self->get_period(),
            "║ 四半期: Q" . $self->quarter,
            "║ 種別: 四半期業績レポート",
            "╚══════════════════════════════════════════╝",
        );
        return join("\n", @lines);
    }

    sub get_period ($self) {
        return '四半期';
    }
}

# ========================================
# ReportGenerator 基底クラス
# ========================================
package ReportGenerator {
    use Moo;
    use Scalar::Util qw(blessed);

    sub create_report ($self, $title) {
        die "create_report() must be implemented by subclass";
    }

    sub create_validated_report ($self, $title) {
        my $report = $self->create_report($title);

        unless (blessed($report) && $report->does('ReportRole')) {
            die "create_report() must return an object that does ReportRole";
        }

        return $report;
    }

    sub generate_and_print ($self, $title) {
        my $report = $self->create_validated_report($title);
        my $content = $report->generate();
        say $content;
        return $report;
    }

    sub generate_and_save ($self, $title, $filename) {
        my $report = $self->create_validated_report($title);
        my $content = $report->generate();

        say $content;
        say "";
        say "[INFO] ファイル '$filename' に保存しました。";

        return $report;
    }
}

# ========================================
# MonthlyReportGenerator クラス
# ========================================
package MonthlyReportGenerator {
    use Moo;
    extends 'ReportGenerator';

    sub create_report ($self, $title) {
        return MonthlyReport->new(title => $title);
    }
}

# ========================================
# WeeklyReportGenerator クラス
# ========================================
package WeeklyReportGenerator {
    use Moo;
    extends 'ReportGenerator';

    sub create_report ($self, $title) {
        return WeeklyReport->new(title => $title);
    }
}

# ========================================
# DailyReportGenerator クラス
# ========================================
package DailyReportGenerator {
    use Moo;
    extends 'ReportGenerator';

    sub create_report ($self, $title) {
        return DailyReport->new(title => $title);
    }
}

# ========================================
# QuarterlyReportGenerator クラス
# ========================================
package QuarterlyReportGenerator {
    use Moo;
    extends 'ReportGenerator';

    has quarter => (
        is       => 'ro',
        required => 1,
    );

    sub create_report ($self, $title) {
        return QuarterlyReport->new(
            title   => $title,
            quarter => $self->quarter,
        );
    }
}

# ========================================
# メイン処理
# ========================================
package main;

say "=" x 50;
say " レポートジェネレーター v1.0";
say " 月次・週次・日次・四半期レポートに対応";
say "=" x 50;
say "";

# 月次レポート
say "[1] 月次レポートを生成中...";
my $monthly = MonthlyReportGenerator->new();
$monthly->generate_and_print("2026年1月 売上レポート");
say "";

# 週次レポート
say "[2] 週次レポートを生成中...";
my $weekly = WeeklyReportGenerator->new();
$weekly->generate_and_print("2026年1月 第1週 売上レポート");
say "";

# 日次レポート
say "[3] 日次レポートを生成中...";
my $daily = DailyReportGenerator->new();
$daily->generate_and_print("2026年1月9日 売上レポート");
say "";

# 四半期レポート
say "[4] 四半期レポートを生成中...";
my $q1 = QuarterlyReportGenerator->new(quarter => 1);
$q1->generate_and_print("2026年度 Q1 業績レポート");
say "";

say "=" x 50;
say " すべてのレポートが正常に生成されました!";
say "=" x 50;

コード例2: 実行結果

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
==================================================
 レポートジェネレーター v1.0
 月次・週次・日次・四半期レポートに対応
==================================================

[1] 月次レポートを生成中...
╔══════════════════════════════════════╗
║ 2026年1月 売上レポート
╠══════════════════════════════════════╣
║ 期間: 月次
║ 種別: 月次売上レポート
╚══════════════════════════════════════╝

[2] 週次レポートを生成中...
┌──────────────────────────────────────┐
│ 2026年1月 第1週 売上レポート
├──────────────────────────────────────┤
│ 期間: 週次
│ 種別: 週次売上レポート
└──────────────────────────────────────┘

[3] 日次レポートを生成中...
+-----------------------------------------+
| 2026年1月9日 売上レポート
+-----------------------------------------+
| 期間: 日次
| 種別: 日次売上レポート
+-----------------------------------------+

[4] 四半期レポートを生成中...
╔══════════════════════════════════════════╗
║ 2026年度 Q1 業績レポート
╠══════════════════════════════════════════╣
║ 期間: 四半期
║ 四半期: Q1
║ 種別: 四半期業績レポート
╚══════════════════════════════════════════╝

==================================================
 すべてのレポートが正常に生成されました!
==================================================

設計の振り返り

完成したシステムの構造をMermaid図で表すと、以下のようになります。

	classDiagram
    class ReportRole {
        <<Role>>
        +generate()*
        +get_period()*
    }

    class MonthlyReport {
        +title
        +generate()
        +get_period()
    }
    class WeeklyReport {
        +title
        +generate()
        +get_period()
    }
    class DailyReport {
        +title
        +generate()
        +get_period()
    }
    class QuarterlyReport {
        +title
        +quarter
        +generate()
        +get_period()
    }

    ReportRole <|.. MonthlyReport : with
    ReportRole <|.. WeeklyReport : with
    ReportRole <|.. DailyReport : with
    ReportRole <|.. QuarterlyReport : with
	classDiagram
    class ReportGenerator {
        <<abstract>>
        +create_report(title)*
        +create_validated_report(title)
        +generate_and_print(title)
        +generate_and_save(title, filename)
    }

    class MonthlyReportGenerator {
        +create_report(title)
    }
    class WeeklyReportGenerator {
        +create_report(title)
    }
    class DailyReportGenerator {
        +create_report(title)
    }
    class QuarterlyReportGenerator {
        +quarter
        +create_report(title)
    }

    ReportGenerator <|-- MonthlyReportGenerator : extends
    ReportGenerator <|-- WeeklyReportGenerator : extends
    ReportGenerator <|-- DailyReportGenerator : extends
    ReportGenerator <|-- QuarterlyReportGenerator : extends

    MonthlyReportGenerator ..> MonthlyReport : creates
    WeeklyReportGenerator ..> WeeklyReport : creates
    DailyReportGenerator ..> DailyReport : creates
    QuarterlyReportGenerator ..> QuarterlyReport : creates

ポイント

  • ReportRoleがレポートの「契約」を定義
  • ReportGeneratorがジェネレーターの「骨格」を定義
  • 各サブクラスはcreate_reportをオーバーライドして「具体的なレポート」を返す
  • 新しいレポート種別を追加するときは、新しいクラスを追加するだけ

今後の拡張

このシステムは、以下のように拡張できます。

新しいレポート種別の追加

  • 年次レポート(YearlyReport + YearlyReportGenerator
  • 半期レポート(SemiAnnualReport + SemiAnnualReportGenerator
  • カスタムレポート(任意の期間を指定)

機能の追加

  • レポートをPDF形式で出力
  • レポートをメールで送信
  • レポートをデータベースに保存

いずれの場合も、基本的な構造は変わりません。

今回のまとめ

今回は、レポートジェネレーターを完成させました。

  • 月次・週次・日次・四半期の4種類のレポートに対応
  • ReportRoleで共通のインターフェースを定義
  • ReportGenerator基底クラスで共通処理を実装
  • 各ジェネレーターはcreate_reportをオーバーライドするだけ

このシステムは、継承とオーバーライドを活用した拡張性の高い設計になっています。

次回予告

次回は最終回「これがFactory Methodパターンだ!」として、これまで作ってきたものが実はデザインパターンの1つだったことを明かします。

「Factory Methodパターン」とは何か、そしてStrategyパターンとの違いも解説します。お楽しみに!

comments powered by Disqus
Hugo で構築されています。
テーマ StackJimmy によって設計されています。