はじめに アプリケーションレイヤーでトランザクションを考慮した実装をどのようにすればいいのか悩んでいる人が多いことに気がつきました。オニオンアーキテクチャ等でアプリケーションコードを関心ごとのレイヤーに分離するときに、トランザクションを開始するためのDBとのコネクションの作成をどのレイヤーで実施するのか悩んでいる人が多いそうです。 本記事ではDDD+オニオンアーキテクチャ+Repositoryパターンを使う前提で、私がよく使うトランザクションを考慮した実装について説明しようと思います。 トランザクションを考慮した実装 私はトランザクションを開始するためのDBとのコネクションの作成はUsecase層で実施します。 私がよく書く実装ではDDDでいうEntityを定義します。そしてRepositoryではEntityのCRUDのみ行うように実装し、Repositoryをトランザクション境界にしま

はじめに 私が社内のプロダクト開発で、コメントを書くときに考えていることをまとめようと思います。個人の主観を元に書くので参考程度に読んでください。 社内プロダクトとは、社内の1チームで開発しているプロダクトを指し、社内の他のチームや、社外の不特定多数の人から利用されるものではないとします。プロダクトはWeb APIを想定しています。 サンプルコードはGoで書いています。 コメントを書く目的 コメントを書く目的は、ソースコードから読み取れる情報を補足したり、誤読を防ぐことで、 ソースコードの可読性を高めるためだと思っています。 コメントを書くことでソースコードから読み取れる情報は増えるため、コメントを書くことはメリットしかないように思えますが、デメリットもあります。次にコメントを書くことのメリット/デメリットについて説明します。 コメントを書くメリット ソースコードから読み取れない情報を補足