[DAY11] Data Access Layer 设计概念

前言

这篇将介绍 boxenn 与 DAL 层的依赖关系和介面。

简易 Class Diagram

Source 代表的是外部 gem 的 class，本系列文章使用的案例会是 ActiveRecord 的 Model

Repository(仓储)

Repository 的责任是管理 aggregate 持久性和资料取得，因此在 boxenn 中定义了 4个 public method，分别是

def find_by_identity(hash)
	## main logic
	aggregate
end

def find_by_query(query)
	## main logic
	[aggregates]
end

def save(aggregates)
	## main logic
end

def destroy(aggregates)
	## main logic
end

find_by_identity (以唯一识别搜寻)

• 使用的是 identity 做搜寻，因此回传为一个 aggregate
• 如果底层的 source 找到不只一笔 record，可以在 repository 的实作中决定处理方式(raise error 或 取第一个…等)

find_by_query (以query搜寻)

save (新建和更新)

• 可以做批次的更新
• 如果需要用 transaction，则需要在外部 call 这个 method 的地方包

ActiveRecord::Base.transaction do
	repository.save(entities)
end

• 这个 method 包含 create 和 update
  如果传进来 aggregate 的 identity 存在於 DB 内，则更新该笔 record，反之则用此 identity 建立一笔新的 record

destroy (删除)

• 可批次删除
• 同上，如果需要用 transaction，则需要在外部 call 这个 method 的地方包
• 利用传进来 aggregate 的 identity 删除资料

下一篇开始会针对每个 class 进行解说并有实际的范例 code。