Tenacity 技术文档

1. 安装指南

在开始使用 Tenacity 前，您需要确保已经安装了以下依赖：

• Ruby 1.9.3 或更高版本
• SQLite
• MongoDB
• Riak
• CouchDB

安装依赖：

bundle install

运行测试以确保安装正确：

rake test

2. 项目的使用说明

Tenacity 提供了一种独立于数据库客户端的方式来管理不同数据库支持的模型间的关系。这对于那些需要在应用中使用多数据库（多语言持久化）的场景非常有用。Tenacity 基于 ActiveRecord 的关联，并尽可能地模仿其行为，支持许多相同的选项。

示例

以下是一个 Tenacity 的简单使用示例：

class Car
  include MongoMapper::Document
  include Tenacity

  t_has_many :wheels
  t_has_one  :dashboard
end

class Wheel < ActiveRecord::Base
  include Tenacity

  t_belongs_to :car
end

class Dashboard < CouchRest::Model::Base
  include Tenacity
  use_database MY_COUCHDB_DATABASE

  t_belongs_to :car
end

car = Car.create

# 设置关联对象
dashboard = Dashboard.create({})
car.dashboard = dashboard
car.save

# 从相应数据库获取关联对象
car.dashboard

# 从数据库获取关联对象 ID
car.dashboard.car_id

# 设置关联对象集合
wheel_1 = Wheel.create
wheel_2 = Wheel.create
wheel_3 = Wheel.create
wheels = [wheel_1, wheel_2, wheel_3]
car.wheels = wheels
car.save

wheel_1.car_id    # car.id

# 从相应数据库获取关联对象数组
car.wheels        # [wheel_1, wheel_2, wheel_3]

# 从数据库获取关联对象 ID 数组
car.wheel_ids     # [wheel_1.id, wheel_2.id, wheel_3.id]

# 向集合中添加关联对象
new_wheel = Wheel.create
car.wheels << new_wheel
car.save
car.wheels        # [wheel_1, wheel_2, wheel_3, new_wheel]

请注意，为了让 Tenacity 能够找到您的模型类，包含模型类的目录必须在您的加载路径中。

3. 项目 API 使用文档

关于 Tenacity 支持的关联以及它们各自选项的文档，请参考：Tenacity/ClassMethods。

完整的 API 文档请参考：frames。

4. 项目安装方式

如前所述，项目的安装方式是通过 Ruby 的包管理器进行依赖安装，并运行测试以确保安装正确。

bundle install
rake test

之后，您可以按照示例代码开始使用 Tenacity。