Inherited Resources 技术文档

1. 安装指南

Inherited Resources 是一个 Ruby gem，可以通过以下两种方式安装：

• 使用 Bundler：在您的 Gemfile 中添加以下内容

  gem 'inherited_resources'
  

  然后执行以下命令：

  $ bundle install
  

• 手动安装：使用以下命令

  $ gem install inherited_resources
  

2. 项目的使用说明

Inherited Resources 旨在加快开发过程，通过继承的方式让您的控制器自动拥有 RESTful 行为。这样做可以让控制器更加简洁和强大。

基本用法

要使用 Inherited Resources，您只需要让您的控制器继承自 InheritedResources::Base：

class ProjectsController < InheritedResources::Base
end

这样，所有 RESTful 行为都会被自动定义。在 index 动作中，您的资源集合依然可通过 @projects 实例变量访问，而在其他动作中，可通过 @project 访问单个资源。

指定响应类型

您可以指定控制器支持的 MIME 类型：

class ProjectsController < InheritedResources::Base
  respond_to :html, :xml, :json
end

也可以针对特定动作指定：

class ProjectsController < InheritedResources::Base
  respond_to :html, :xml, :json
  respond_to :js, :only => :create
  respond_to :iphone, :except => [ :edit, :update ]
end

继承特定动作

如果您只想继承特定的动作，可以使用以下方式：

class ProjectsController < InheritedResources::Base
  actions :index, :show, :new, :create
end

或者：

class ProjectsController < InheritedResources::Base
  actions :all, :except => [ :edit, :update, :destroy ]
end

3. 项目API使用文档

Inherited Resources 主要用于控制器层面的代码继承和简化，并不直接提供 API。但是它提供了丰富的助手方法，例如：

• resource：返回单个资源实例的变量
• collection：返回资源集合的变量
• resource_class：返回资源类

4. 项目安装方式

项目的安装方式已在“安装指南”一节中详细说明，概括如下：

• 使用 Bundler 将 Inherited Resources 添加到 Gemfile 中，然后执行 bundle install。
• 直接使用 gem install inherited_resources 命令安装。