【Go + レイヤードアーキテクチャ】DDDを意識してWeb APIを実装してみる

Fri, 14 Jun 2019 09:00:00 +0900

更新（2019年10月30日）

初回投稿から3ヶ月経ちました。
この3ヶ月で新しく得た知見を基に、内容を一部アップデートしました。

今回やること

Goのディレクトリ構成についていろいろと調べる中で、
こちらの資料がとても分かりやすかったので、
今回はこちらを参考にGoでWeb APIを作っていきたいと思います。

加えて、本プロジェクトでは、DDD とレイヤードアーキテクチャを取り入れます。
（内容はほぼレイヤードアーキテクチャになってしまいましたが…）

DDD については、「DDD を Go とレイヤードアーキテクチャでやるなら、こんな感じかな？」という個人の見解レベルです。
パッケージ構成の参考になれば幸いです。
（なので、ドメインモデルは重度の貧血症）

環境

MacOS Mojave 10.14.6
Go 1.12.5

なお、今回は、Gin や Mux などといったフレームワークは使わず、
httprouter のみで薄く作っていこうと思います。

Mux を使った実装は僕の前のブログで紹介しているのでよければどうぞ。

・

では、早速本題に入っていきましょう。

採用アーキテクチャ：レイヤードアーキテクチャ

参考記事内で紹介されているのはレイヤードアーキテクチャをベースに
いろいろカスタマイズされたものらしいです。

クリーンアーキテクチャに似たアーキテクチャだとか。

ユースケース層という呼び方はクリーンアーキテクチャ由来ですね。

DDD の文脈ではアプリケーション層と呼ばれますが、
アプリケーションって意味が広くて分かりづらいので、
本プロジェクトではユースケースという単語を使用します。

とりあえず、今回はスライドページ19で紹介されているディレクトリ構成に従って、
DDD を意識して Web API を実装していこうと思います。

（意識だけして、実践できずに終わりましたが😇）

レイヤードアーキテクチャにおける各層の依存関係について説明します。

依存関係の図は下記のとおりです。

矢印は依存の方向を示しています。
例えば、上図だと Handler層は UseCase層の処理を利用することを意味します。

【Web API（Rails） + Vue.js】ブログのいいねボタン自作してみた

Sat, 08 Jun 2019 09:00:00 +0900

いいねボタンがないブログ

本ブログ、いいねボタンがありませんでした。

だから、作っちゃいました。っていう記事です。

構成

上図のように

記事ページからAPIサーバにリクエストを送り、いいねの数を取得・加算します。

記事ページからAPIサーバへのリクエスト部分（クライアント）には Vue + axios を使用。

APIサーバは Rails で実装しました。

（以前から Slackのスラッシュコマンド用に使用していたAPIサーバを流用しました）

APIサーバ

Rails で APIサーバを建てる方法に関しては、

以前に Qiita で入門記事書いたのでそちらをご覧ください。

（少し古い記事ですが、そんなに問題はないはずです）

DB にテーブル作成

今回、ブログ記事を管理するために、下記のテーブルを作成しました。

mysql> describe blog_posts;
+------------+--------------+------+-----+---------+----------------+
| Field | Type | Null | Key | Default | Extra |
+------------+--------------+------+-----+---------+----------------+
| id | bigint(20) | NO | PRI | NULL | auto_increment |
| title | varchar(255) | NO | | NULL | |
| count | varchar(255) | NO | | 0 | |
| created_at | datetime | NO | | NULL | |
| updated_at | datetime | NO | | NULL | |
+------------+--------------+------+-----+---------+----------------+
5 rows in set (0.00 sec)

titleには、日本語のタイトル（本記事だと『【WEB API（RAILS） + VUE.JS】ブログのいいねボタン自作してみた』）ではなく、記事ファイル（マークダウン）の名前（本記事だと『good_api』, 拡張子抜き）が入ります。

Web API on Indexing my brain