Hanami框架中数据库记录创建方式的演进与最佳实践

Hanami作为一款现代化的Ruby Web框架，其数据库访问层在2.x版本中经历了显著的变化。本文将深入探讨Hanami框架中创建数据库记录的两种主要方式，帮助开发者理解其演进过程并掌握当前版本的最佳实践。

历史版本中的Repository模式

在Hanami 1.3版本中，框架采用了Repository模式作为数据库操作的主要方式。Repository作为数据访问层，封装了所有与数据库交互的逻辑，开发者通过定义Repository类来操作实体对象。

典型的1.3版本Repository定义如下：

class UserRepo < ROM::Repository[:users]
  commands :create
end

这种方式通过声明commands :create来启用创建功能，然后可以通过UserRepo.new.create(user_attributes)来创建记录。Repository模式提供了良好的抽象层，将业务逻辑与数据持久化细节分离。

2.x版本的Relation与Repository并存

Hanami 2.2版本引入了更灵活的数据库访问方式，Relation成为底层实现，而Repository则作为更高层次的抽象继续存在。Relation直接映射到数据库表，提供了基础的CRUD操作能力。

通过Relation创建记录的方式非常直接：

user_relation.insert(name: "John", email: "[e-mail]")

同时，Hanami 2.2保留了Repository的概念，但实现方式有所变化。现在Repository类继承自Hanami::DB::Repository，并提供了更简洁的接口：

class UserRepo < Hanami::DB::Repository
end

# 使用方式
user_repo.create(name: "John", email: "[e-mail]")

当前版本的最佳实践

对于Hanami 2.2及以上版本，推荐以下实践：

1. 简单场景：直接使用Relation的insert方法，适合简单的、不需要业务逻辑验证的插入操作。

2. 复杂业务场景：使用Repository模式，可以在创建前后添加业务逻辑，如数据验证、关联处理等。

3. 自定义Repository方法：当需要封装复杂操作时，可以在Repository中定义自定义方法：

class UserRepo < Hanami::DB::Repository
  def create_with_profile(user_attrs, profile_attrs)
    command(:create, result: :one) do |t|
      t.create(user_attrs)
      t.create(profile_attrs)
    end
  end
end

版本迁移建议

对于从1.x迁移到2.x的项目，需要注意：

1. Repository的基类从ROM::Repository变更为Hanami::DB::Repository
2. 命令声明方式不再使用commands宏
3. 查询接口更加统一和简洁

Hanami框架在保持简洁性的同时，提供了灵活的数据库访问策略。理解这些变化有助于开发者根据项目需求选择最合适的持久化方式，构建更健壮的应用程序。