项目技术文档：acts_as_network 使用指南

1. 安装指南

使用 Git 安装

cd rails_project_path
./script/plugin install git://github.com/sjlombardo/acts_as_network.git
rake doc:plugins

使用 Subversion 安装（适用于 Rails 版本 <= 2.0.2）

cd rails_project_path
script/plugin source http://actsasnetwork.rubyforge.org/svn/plugins
script/plugin install acts_as_network
rake doc:plugins

2. 项目的使用说明

acts_as_network 是一个简化实体之间互惠关系定义和存储的插件，它通过使用 has_and_belongs_to_many 或 has_many :through 连接表，以 DRY（Don't Repeat Yourself）的方式实现双向连接。这种方式无需冗余数据，只需要一个关联或连接模型实例来表示关系的两个方向。

这在社交网络中特别有用，例如，当 Jack 是 Jane 的朋友时，Jane 也应该自动成为 Jack 的朋友。

3. 项目 API 使用文档

使用 HABTM 风格的关联

class Person < ActiveRecord::Base
  acts_as_network :friends, :join_table => :friends
end

在这种情况下，acts_as_network 会在 Person 模型上暴露三个新属性：

• me.friends_out：我发起的友谊关系（我视为朋友的人）
• me.friends_in：其他人发起的与我相关的友谊关系（视我为朋友的人）
• me.friends：上述两个集合的并集，即我视为朋友的人和视我为朋友的人

使用连接模型

class Invite < ActiveRecord::Base
  belongs_to :person
  belongs_to :person_target, class_name: 'Person', foreign_key: 'person_id_target'
  validates_presence_of :person, :person_target
end

class Person < ActiveRecord::Base
  acts_as_network :friends, :through => :invites, :conditions => "is_accepted = 't'"
end

在这种情况下，acts_as_network 会在 Person 模型上隐式定义五个新属性：

• person.invites_out：由我发起的邀请
• person.invites_in：由其他人发起给我的邀请
• person.friends_out：通过我发出的已接受的邀请与其他人建立的友谊关系
• person.friends_in：通过其他人发出的已接受的邀请与我建立的友谊关系
• person.friends：上述两个集合的并集，即所有我邀请的人和所有邀请我的人

4. 项目安装方式

请参考“安装指南”部分，使用 Git 或 Subversion 进行安装。

---

本文档提供了 acts_as_network 插件的安装和使用方法，以及 API 的基本使用说明。希望对您的项目有所帮助。