.Nilify Blanks 使用详解

#.Nilify Blanks 使用详解

1. 安装指南

首先，确保你的项目使用的是Rails 4及以上版本，并且Ruby版本为2.2或更高。在项目的Gemfile文件中添加以下代码：

gem "nilify_blanks"

然后执行bundle install命令安装这个gem。

2. 项目使用说明

nilify_blanks插件允许你指定一组属性，当这些属性在表单提交时为空字符串时，会在保存模型前将这些属性转换为nil。这样做可以避免数据库中同时存在空字符串和NULL值，这可能会导致混淆。

以下是一些使用示例：

• 转换模型中的所有字段：

class Post < ActiveRecord::Base
  nilify_blanks
end

• 仅转换模型中的文本字段：

class Post < ActiveRecord::Base
  nilify_blanks types: [:text]
end

• 仅转换特定的字段：

class Post < ActiveRecord::Base
  nilify_blanks only: [:author, :title]
end

• 转换除特定字段以外的所有字段：

class Post < ActiveRecord::Base
  nilify_blanks except: [:author, :title]
end

• 忽略字段的空约束，转换任何字段：

class Post < ActiveRecord::Base
  nilify_blanks nullables_only: false
end

3. 项目API使用文档

全局使用：

你可以将nilify_blanks应用到所有继承自ActiveRecord::Base的模型中：

ActiveRecord::Base.nilify_blanks

或者仅针对特定命名空间的模型基类：

Inventory::Base.nilify_blanks

指定回调：

默认使用before_validation回调，但你也可以指定其他的回调：

class Post < ActiveRecord::Base
  nilify_blanks before: :create
end

class Post < ActiveRecord::Base
  nilify_blanks before: :validation_on_update
end

RSpec Matcher：

首先，引入matcher：

require "nilify_blanks/matchers"

确保特定列转换为nil：

describe City do
  it { should nilify_blanks_for(:name) }
end

确保所有适用字段转换为nil：

describe City do
  it { should nilify_blanks }
end

也可以选择匹配选项：

describe City do
  it { should nilify_blanks_for(:name, before: :create) }
end

describe City do
  it { should nilify_blanks(before: :create) }
end

4. 项目安装方式

请参考上述安装指南，通过将nilify_blanks添加到你的Gemfile中，然后执行bundle install来进行安装。