ホーム 全セッション S06

保存の途中で失敗した場合の結果

10 / 20 目安 1分

ページ一覧

解決策: 保存の途中で失敗したときに、何も残らないことを確認します。

transaction の途中で書き込みが失敗すると、transaction は取り消され(rollback)、そこまでの書き込みは破棄されます。防止できる事故は、監査記録の保存だけが失敗して、予約だけが診察中になることです。

状態と監査記録を1回で保存する

修正後: 監査記録の保存に失敗

  1. storeAtomically が transaction を開始します。
  2. 予約を再度取得します。CheckedIn であるため先へ進みます。
  3. saveState が状態を書き込みます。まだ未確定です。
  4. appendAudit が書き込みに失敗し、AppointmentPersistenceError を投げます。
  5. 例外で transaction が取り消され、未確定だった状態の行も消えます。予約は CheckedIn のままで、監査記録もありません。
  6. ResultAsync の内側の Promise(非同期処理の結果を表す値)が reject(非同期処理が例外で終わること)すると、結果は Ok にも Err にもならず、await した場所で例外になります。状態だけが残ることはありません。

呼び出し元のコード

修正前 examples/session-06/src/useCase/startExamination.ts:69-70 呼び出し元
await deps.stateStore.save(event.aggregateState);
await deps.eventLog.append(event);
修正後 examples/session-06-solution/src/useCase/startExamination.ts:89 呼び出し元
.andThrough(deps.examinationStartedStore.store)

実装のコード

修正前 examples/session-06/src/adaptor/secondary/sqlite/appointmentStore.ts:182, 100-102 実装
save: async (appointment) => saveState(database, appointment),
…
executor
  .insert(appointmentsTable)
  .values(row)
修正前 examples/session-06/src/adaptor/secondary/sqlite/appointmentStore.ts:185, 118, 120 実装
append: async (event) => appendAudit(database, event),
…
executor.insert(auditLogsTable).values(toAuditRow(event)).run();
…
throw new AppointmentPersistenceError("append-audit", cause);
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:185-188 実装
store: (event) =>
  ResultAsync.fromSafePromise(
    Promise.resolve().then(() => storeAtomically(event)),
  ).andThen((result) => result),
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:148-149 実装
const storeAtomically = (event: ExaminationStarted) =>
  database.transaction((transaction) => {
    …
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:150-151 実装
const current = findInTransaction(transaction, event.appointmentId);
if (current === undefined || current.kind !== "CheckedIn") {
  …
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:158-161 実装
const committedEvent = Appointment.startExamination({
  eventId: event.eventId,
  occurredAt: event.occurredAt,
})(current, event.aggregateState.veterinarianId);
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:151-156 実装
if (current === undefined || current.kind !== "CheckedIn") {
  return err({
    kind: "AppointmentConflict",
    appointmentId: event.appointmentId,
  } as const);
}
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:163, 99-101, 106 実装
saveState(transaction, committedEvent.aggregateState);
…
executor
  .insert(appointmentsTable)
  .values(row)
  …
  .run();
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:164, 117, 119 実装
appendAudit(transaction, committedEvent);
…
executor.insert(auditLogsTable).values(toAuditRow(event)).run();
…
throw new AppointmentPersistenceError("append-audit", cause);
修正後 examples/session-06-solution/src/adaptor/secondary/sqlite/examinationStartedStore.ts:149, 165-166 実装
database.transaction((transaction) => {
  …
  return ok(undefined);
});

「保存済み」ははじめからある行、「未確定」は transaction の中だけにある行、「確定」は書き込みが残った行です。