私が好きなプロジェクト
https://github.com/jkazama/ddd-java
このプロジェクトでは以下のように流れるようなインターフェースで処理の見通しが良くなっている。
<div class="remark-highlight"><pre class="language-java"><code class="language-java">public List&#x3C;CashInOut> findUnprocessedCashOut() {
 final String accId = actor().getId();
 return TxTemplate.of(txm).readOnly().readIdLock(idLock, accId).tx(
 () -> CashInOut.findUnprocessed(rep, accId));
 }
</code></pre></div>
トランザクションテンプレートを取得して、参照専用にして、指定したIDにロックをかけて、振込依頼情報を検索する。
メソッドチェーンは自身のインスタンスを返して実現しています。
<ul>
<li>ofしてインスタンスを取得して、readOnlyは自身のインスタンスを返却しています</li>
<li>readIdLockも仕組みは同じです。自身のインスタンスを返却しています</li>
</ul>
txメソッドはSupplierを受取ります。SupplierはfactoryのようなものでT型のインスタンスを返却するラムダ式を渡します。ここではDBから取得したListを返却します。
順序をまとめると
<ul>
<li>TxTemplateを作成する(TransactionTemplateを変数で保持しているクラス)</li>
<li>TransactionTemplateを読取専用にする
<ul>
<li>自身のインスタンスを返却</li>
</ul>
</li>
<li>指定したIDの参照ロックをかける
<ul>
<li>自身のインスタンスを返却</li>
</ul>
</li>
<li>txメソッドはTransactionTemplate#executeの呼び出しを行う
<ul>
<li>ここはトランザクション処理が働くのでここでDBアクセスを行うexecuteメソッドの戻り値はSupplierの結果
<ul>
<li>executeメソッドの戻り値はSupplierの結果</li>
</ul>
</li>
</ul>
</li>
<li>txメソッドの戻り値(Supplierの結果)がfindUnprocessedCashOutメソッドの戻り値として返却されます。</li>
<li>コントローラーではDtoに変換して結果を戻します。</li>
</ul>
<h2>TransactionCallback</h2>
tmpl.execute(status -> supplier.get()));という個所が今回のポイントです。
<div class="remark-highlight"><pre class="language-java"><code class="language-java">public &#x3C;T> T tx(Supplier&#x3C;T> supplier) {
 if (this.idLock.isPresent()) {
 return this.idLock.get().call(this.IdLockPair.get().getId(), this.IdLockPair.get().getLockType(),
 () -> tmpl.execute(status -> supplier.get()));
 } else {
 return tmpl.execute(status -> supplier.get());
 }
 }
</code></pre></div>
TransactionTemplate#executeはTransactionCallbackを引数に取ります。
TransactionCallbackはorg.springframework.transaction.supportパッケージにありクラスの説明は以下のようになっています
とりあえずトランザクションを行うコードをここに記載するようです。
execute内からdoInTransactionメソッドが呼ばれて戻り値を得るようです。
<div class="remark-highlight"><pre class="language-java"><code class="language-java">@Override
	@Nullable
	public &#x3C;T> T execute(TransactionCallback&#x3C;T> action) throws TransactionException {
		Assert.state(this.transactionManager != null, "No PlatformTransactionManager set");

		if (this.transactionManager instanceof CallbackPreferringPlatformTransactionManager) {
			return ((CallbackPreferringPlatformTransactionManager) this.transactionManager).execute(this, action);
		}
		else {
			TransactionStatus status = this.transactionManager.getTransaction(this);
			T result;
			try {
				result = action.doInTransaction(status);
			}
			catch (RuntimeException | Error ex) {
				// Transactional code threw application exception -> rollback
				rollbackOnException(status, ex);
				throw ex;
			}
			catch (Throwable ex) {
				// Transactional code threw unexpected exception -> rollback
				rollbackOnException(status, ex);
				throw new UndeclaredThrowableException(ex, "TransactionCallback threw undeclared checked exception");
			}
			this.transactionManager.commit(status);
			return result;
		}
	}
</code></pre></div>
ちなみに戻り値を必要としないTransactionCallbackWithoutResultも利用できるそうです。https://www.techscore.com/tech/Java/Others/Spring/7-2/
ここでいう戻り値はSupplierの結果になります。とりあえずまとめると
<ul>
<li>executeメソッドにはデータアクセスをする処理を記載する</li>
<li>データアクセスする処理とその結果の取得はSupplierで実装している</li>
</ul>
サービスクラスからの呼び出し方がカッコイイです。。

Java | ddd-javaからトランザクション処理を学ぶ