default_value_for 插件技术文档

1. 安装指南

Rails 3.2 - 4.2 / Ruby 1.9.3 及以上版本

当前版本的 default_value_for (3.x 及以上) 兼容 Rails 3.2 及以上版本，以及 Ruby 1.9.3 及以上版本。

在 Gemfile 中添加以下内容：

gem "default_value_for", "~> 3.0"

Rails 3.0 - 3.1 / Ruby 1.9.3 及以下版本

如果你使用的是较旧版本的 Ruby 和 Rails，你需要使用之前的稳定版本 2.0.3。该版本兼容 Rails 3.0、3.1 和 3.2，以及 Ruby 1.8.7 及以上版本。但它不兼容 Rails 4。

在 Gemfile 中添加以下内容：

gem "default_value_for", "~> 2.0.3"

Rails 2

如果你使用的是 Rails 2.x 版本，你需要使用较旧的版本：

./script/plugin install git://github.com/FooBarWidget/default_value_for.git -r release-1.0.7

2. 项目的使用说明

default_value_for 插件允许你以声明式的方式为 ActiveRecord 模型定义默认值。例如：

class User < ActiveRecord::Base
  default_value_for :name, "(no name)"
  default_value_for :last_seen do
    Time.now
  end
end

u = User.new
u.name       # => "(no name)"
u.last_seen  # => Mon Sep 22 17:28:38 +0200 2008

注意事项

在某些情况下，默认值不会被填充到现有记录中。例如，当你从数据库中检索记录时，默认值不会被重新填充。

3. 项目API使用文档

default_value_for 方法

default_value_for 方法可以在所有 ActiveRecord 模型类中使用。

第一个参数是属性名称，第二个参数是默认值。默认值可以通过值或块的形式传递。

default_value_for :age, 20

或

default_value_for :age do
  if today_is_sunday?
    20
  else
    30
  end
end

default_value_for 选项

• allows_nil (默认: true) - 如果设置为 true，则允许显式传递的 nil 值。

default_value_for :age, :value => 20, :allows_nil => false

default_values 方法

default_values 方法可以一次性设置多个默认值。

default_values :age  => 20,
               :uuid => lambda { UuidGenerator.new.generate_uuid }

4. 项目安装方式

通过 Gemfile 安装

在 Gemfile 中添加以下内容：

gem "default_value_for", "~> 3.0"

然后运行 bundle install 进行安装。

通过插件安装

对于 Rails 2.x 版本，可以通过以下命令安装：

./script/plugin install git://github.com/FooBarWidget/default_value_for.git -r release-1.0.7

验证 Gem 的真实性

你可以通过以下步骤验证 Gem 的真实性：

1. 使用 Phusion Software Signing 密钥进行验证。
2. 通过 rubygems-openpgp 证书颁发机构进行验证。

详细的验证步骤可以参考相关文档。