IChou (小虫)

[RubyConfChina2017 话题分享] 从零开始，打造 Ruby 项目的容器化集成工具

IChou — Tue, 19 Sep 2017 12:46:29 +0800

slides

关于分享的主题其实之前有犹豫很久，本来是想分享我们的工具，但是又觉得我们做得不够好，不足以拿出来见人。

于是就改为分享我们这一路的经历，把我们怎么一步步建立这个体系的过程讲出来，希望能帮到一些打算要做容器化迁移的同学们，告诉他们需要考虑哪些问题，经过哪些步骤，少走弯路。

于是最后给大家呈现出一个不太「严肃」的演讲，对此感到不适的朋友还请见谅，毕竟也是第一次，经验欠缺。🤣

这次分享的内容主要包括：

如何设计镜像
如何将打包内容模块化
如何通过自己编写工具简化工作内容
如何进一步偷懒

在这次演讲之后的讨论中，我们也收获了很多，发现了一些之前没有太注意的问题。

正如大家所讨论的，演讲中给大家展示的方案中有不少 tricks，也没有保证各个环境下镜像的一致性，这些都是速递易以后需要去改进的方向。

感谢大家，长期处于一种状态下，视野容易被限制，所以也希望大家能分享出自己的 docker 部署方案，互相交流，互相学习，探索出一种能媲美 capistrano 的模式

参考资料：

用 method chain 方式来包装 HTTP API 调用

IChou — Sun, 07 May 2017 21:12:50 +0800

最近项目组有一个关于人脸识别相关的需求，需要用到 FacePP 的服务，而官方提供的 Ruby SDK 自 2013 年提交以来，从未更新过，Issue 和 PR 也无人处理。So, 我被安排去『重新』实现 FacePP 的 SDK。

官方 SDK 地址：https://github.com/FacePlusPlus/facepp-ruby-sdk

本以为这是个苦差事，难鹅，当我拉下官方的 SDK 源码时，却被华丽丽的惊艳到了 w(°o°)w

通常来说我们写 SDK 的常规思路：

实现一个通用的请求处理，包括 url 拼装，参数处理，签名等
根据各个接口去实现一个方法（method）

而这个 SDK 的实现，直接使用了 Ruby 里的大杀器 —— 元编程，进而毫不费力的实现了链式调用

链式调用

关于链式调用相信大家都不陌生，最常见的就是 ActiveRecord 的查询方法

Article.where('id > 10').limit(20).order('id desc').only(:order, :where)

个人认为，链式调用最大的优点就是优雅，相比起把所有参数放在一个 options(hash) 里喂给一个方法的调用方式，链式调用的可读性明显更好，参数组合也更自由。

FacePP 的 SDK 里面实现的链式调用

api = FacePP.new 'YOUR_API_KEY', 'YOUR_API_SECRET'
puts api.detection.detect url: '/tmp/0.jpg'

实现原理

链式调用的实现原理其实很好理解，每当你调用一个链式对象的某个方法时，返回一个该对象所属类的新实例即可

比如在 ActiveRecord 中，当你调用 Model Article 的 where 方法时，它返回了一个 ActiveRecord::Relation 实例，假定它叫 relation_1。.limit(20) 其实调用的是relation_1 的 limit 方法，然后返回一个新的 ActiveRecord::Relation 实例 relation_2，以此类推。

所以当你只是调用 ActiveRecord::Relation 的各种查询方法时，并没有真的触发查询，而是不停的返回新的 ActiveRecord::Relation 实例，直到遇到第一个需要取值的调用，才会触发查询，并返回数据。

以上只是简单的描述，实际上 ActiveRecord::Relation 的实现还挺复杂的，有兴趣可以去看看源码：

https://github.com/rails/rails/blob/5-1-stable/activerecord/lib/active_record/relation.rb

相比起数据库查询的复杂性，http api 的复杂度就算很低了，因此在 http 接口上实现链式调用，其实可以很容易。

简单实现

这个部分我就直接贴 FacePP SDK 的源码了：

# https://github.com/FacePlusPlus/facepp-ruby-sdk/blob/master/lib/facepp/client.rb
# 代码略有删减

class FacePP
  APIS = [
      '/detection/detect',
      '/info/get_image',
      # ...
    ]

  def initialize(key, secret, options={})
    APIS.each do |api|
      m = self
      breadcrumbs = api.split('/')[1..-1]
      breadcrumbs[0..-2].each do |breadcrumb|
        unless m.instance_variable_defined? "@#{breadcrumb}"
          m.instance_variable_set "@#{breadcrumb}", Object.new
          m.singleton_class.class_eval do
            attr_reader breadcrumb
          end
        end
        m = m.instance_variable_get "@#{breadcrumb}"
      end

      m.define_singleton_method breadcrumbs[-1] do |*args|
        # send a request to #{api} with #{args}
      end
    end
  end
end

先预置了一个 api path 的列表，相当于一个路由表。
当 FacePP 被 new 的时候，会逐条解析这个路由表，把每条路由以 / 作分割符解析为数组。
遍历数组至倒数第二个元素，把每个元素变成上层对象的一个同名实例变量，其值是一个新的 Object 实例，并通过 attr_reader 为该实例变量添加访问方法
将数组的最后一个元素变成上层对象的一个 singleton_method, 里面包含了真正的请求代码。

其成果就是，我们可以以

api.detection.detect url: '/tmp/0.jpg'

这样的方式，『形象的』调用 FacePP 的各个接口。当有新增接口的时候，也只需要添加一条路由即可。

作者 @MaskRay 用一个普通的 Object 替代了 ActiveRecord::Relation 的功能，我觉得是一种灰常 geek 的方式。因为这个东西足够简单，我们并没有必要去造一个自己的 Relation

改进空间

假定我们的需求场景再复杂一点

包含的项目多，接口数量庞大，接口变动相对频繁
常用的 4 种 http 请求方式都需要被支持（FacePP 所有接口都是 POST）
被调用的路由很长，但前面有一大段是几乎不会变的前缀
各个接口的的请求实现方式可能不完全一样

由此，我想到了一些改进思路

抛弃预置路由表，通过覆写 method_missing 方法，在被调用的时候才去生成链式对象
以 get|post|put|delete 或 index|show|create|update|destroy|save 作为最后一层发起请求的方法来结束一串调用
为链式对象 Object.new 增加一些实例变量，比如 @host， @path 等，初始化时可以通过附加参数指定前缀等参数
允许传入一个 block

总结

在我所在的公司，有一个内部 gem 叫 services_support, 专门用来处理系统间的 api 调用。这个 gem 实现了两种接口调用方式：

一种是诸如 ServicesSupport::BMS.post 'api/orders', args 这样将 path 作为参数传入
一种是预定义一个 ServicesSupport::BMS.create_order(args) 方法来调用

实际使用中，几乎所有同事都倾向于使用后面这种方式来书写代码，有定义好的要用，没有定义好的自己去加上也要用。不知道这是不是 Rubyists 们追求代码优雅的一个常态。

Anyway，等我用链式调用重写了这个 gem 后，他们就再也不用纠结怎么调了，也不用在新增接口时一个个的去新增调用方法了。想一想那酸爽，鸡肉味，嘎嘣脆~~~

PS：最后还是贴一下我更新之后的 FacePP SDK 吧，没准有人需要

https://github.com/IvanChou/facepp-ruby-sdk

Rails + Puma 线程死掉了没有报错么？

IChou — Tue, 05 Jul 2016 11:57:21 +0800

先容我描述一下这个场景：

这是一个微信公众号项目，大部分时间，它还是讲道理的，看上去老老实实，勤勤恳恳的。但是，冷不防你准备下班或者睡觉的时候，微信报警群里就会跳出来一条报警：

XXX 公众号在微信服务器请求后 5s 内没有响应

然后你屁颠屁颠的去查 Rails 日志，擦咧，没有报错，也基本没有超过 5s 的请求。去 OneApm 上去看，报错率 0%，顿时感觉日了🐶了

就在你还没找到问题是什么的时候，这个时候，第二条报警又来了。。吓得我立马重启服务，终于世界安静了

但是哪儿出错了依旧没找到。

背景交代结束，下面是正文

是问题终归要解决，Rails 里查不出问题，就往下一层走，先去看看 nginx，果然有收获

2016/07/04 22:05:58 [error] 32398#0: *18194461 upstream prematurely closed connection while reading response header from upstream, client: ***.207.54.75, server: **.cn, request: "POST /robot?signature=1dd244608fe34b**650c3497185d33d60cd12cfe&timestamp=1467641156&nonce=443071359&openid=***FPt3ibC_ujlPjUF5Y79SwRkEw HTTP/1.0", upstream: "http://**.168.***.86:10081/robot?signature=1dd244608fe34b**650c3497185d33d60cd12cfe&timestamp=1467641156&nonce=443071359&openid=***FPt3ibC_ujlPjUF5Y79SwRkEw", host: "**.cn"

upstream 非正常提前退出，好，现在拿着这个请求去 Rails 的日志中查

# grep 64d3bb21-af3b-46c3-af98-5056a64e7088 log/production.log

I, [2016-07-04T22:05:56.714306 #11883]  INFO -- : [64d3bb21-af3b-46c3-af98-5056a64e7088] Started POST "/robot?signature=1dd244608fe34b**650c3497185d33d60cd12cfe&timestamp=1467641156&nonce=443071359&openid=***FPt3ibC_ujlPjUF5Y79SwRkEw" for 140.207.54.75 at 2016-07-04 22:05:56 +0800
I, [2016-07-04T22:05:56.718092 #11883]  INFO -- : [64d3bb21-af3b-46c3-af98-5056a64e7088] Processing by RespondersController#create as XML
I, [2016-07-04T22:05:56.718229 #11883]  INFO -- : [64d3bb21-af3b-46c3-af98-5056a64e7088]   Parameters: {"signature"=>"1dd244608fe34b**650c3497185d33d60cd12cfe", "timestamp"=>"1467641156", "nonce"=>"443071359", "openid"=>"***FPt3ibC_ujlPjUF5Y79SwRkEw"}
W, [2016-07-04T22:05:56.721179 #11883]  WARN -- : [64d3bb21-af3b-46c3-af98-5056a64e7088] Request Info:  event   click btn_search    By User:    ***FPt3ibC_ujlPjUF5Y79SwRkEw

发现这个请求跟平时的日志比，少了类似这样的一行

I, [2016-07-05T10:59:45.049711 #9389]  INFO -- : [e026d1c6-bb33-48ff-ad76-fac910f2bbdb] Completed 200 OK in 4ms (Views: 0.1ms | ActiveRecord: 0.0ms)

也就是说，这个请求没有被执行完，就中断了，nginx 收到后端处理异常退出的信号，就抛出了上面的错误

由于应用是用 puma 在跑，rails 某个请求没执行完突然中断了，应该是由于某些原因导致这个线程死掉了吧，打开 puma 的日志一看，哭了

[8553] ! Terminating timed out worker: 22146
[8553] - Worker 3 (pid: 7459) booted, phase: 0
[8553] ! Terminating timed out worker: 22181
[8553] - Worker 0 (pid: 7457) booted, phase: 0
[8553] - Worker 1 (pid: 7495) booted, phase: 0

连个时间戳都没有，也没有报错（这个可能是我配置的问题，请先忽略）

下面，就是想要请教各位的问题了

puma 中某个请求死掉，在 Rails 和 puma 的日志里面都不会有标志性的体现，如果不去对比着 nginx 的日志查，根本就不知道这种情况的存在。是否有什么方法配置 puma，让这种情况发生的时候，记录在日志中，以方便观测或预警
这种情况下希望 Rails 自己去输出错误日志，我觉得已经不太可能了，毕竟线程已死。那么，我要如何去定位问题究竟是在哪一个环节上触发的呢？在代码里加入大量的 debug logger 可行，但是有点 low，这种情况的线上触发概率还是很低的
通过排查请求处理时间大于 5s 的 nginx 日志，我还发现一种更奇怪的现象：请求没执行完，死掉了，但是连 nginx 都没有收到信号，也没有错误日志。由于微信自己对于 5s 没有回应的请求会主动发送 499，中断 Nginx 的处理，不然估计 nginx 会对这个请求挂起到超时，大面积出现的话，那不是连 nginx 都被拖跨了

已经开始去查找相关资料，感觉我是不是碰到个疑难杂症，如果哪位大大知道什么思路，还望提点

关于在 Rails Model 中使用 Enum (枚举) 的若干总结

IChou — Fri, 08 Jan 2016 05:09:15 +0800

题记：本文最初针对 Rails 4 编写，内容过时，会对当前 Rails 5 的使用者造成干扰，故已更新此文到适合 Rails 5 的版本

在 Rails 的 ActiveRecord 中，有一个 ActiveRecord::Enum 的 Module，即枚举对象。

官方说明：

Declare an enum attribute where the values map to integers in the database, but can be queried by name.

给数据库中的整型字段声明一个一一对应的枚举属性值，这个值可以以字面量用于查询。

拿到具体的运用场景中去考虑，Enum 的主要用于数据库中类似于状态 (status) 的字段，这类字段用不同的整数 (Integer) 来表示不用的状态。如果不使用 Enum，那就意味着我们代码中会出现很多表示状态的数字，他们可能会出现在查询条件里，也可能会出现在判断条件里，除非你记得或者拿着数据字典去看，否则你很难理解这段代码的含义。

代码中，以数字方式去表示数据状态，导致代码可读性被破坏，这样的数字被称为『魔鬼数字』。

Enum 就是 Rails 用来消灭魔鬼数字的工具。

ActiveRecord::Enum 与 Mysql 的 Enum 有何不同

枚举的功能，是为了解决数据库相关的问题，那么当然的，数据库本身大多都含有枚举的功能。

以 Mysql 为例，mysql 的字段类型中有一个 ENUM 的类型：

CREATE TABLE person(
    name VARCHAR(255),
    gender ENUM('Male', 'Female')
);

这样就设置了一个叫 gender 的 ENUM 字段，其值为： {NULL: NULL, 1: 'Male', 2: 'Female'}, 在使用 SQL 的时候，数字键值 (index of the value) 和定义的字面量（actual constant literal）是通用的。

既然数据库的 ENUM 已是如此的方便，为什么我们不直接使用它呢？最大的问题在于 ENUM 的属性值在建表的时候就已经固定了下来，一旦到了后期需要加一个状态，那么就意味着需要改字段。而且目前各种数据库对于 ENUM 的处理方式也并非是完全一致的，给 ORM 的实现也带来的不少的问题。

ActiveRecord::Enum 在实现上，和对外键的处理方式一样，并不直接使用数据库自身的 ENUM，仅用普通的 Integer 来做存储，以此避免了 Enum 属性变动时需要修改数据库结构的问题。

ActiveRecord::Enum 的使用

具体使用请参见官方文档

# Migration
create_table :conversations do |t|
  t.integer :status, default: 0
end

# Model
class Conversation < ActiveRecord::Base
  enum status: { active: 0, waiting: 1, archived: 2 }
  # or, but not recommended
  enum status: [ :active, :waiting, :archived ]
end

声明之后，会多出以下一些辅助方法：

conversation.active! # 改写状态为 active
conversation.active? # 检查状态是否为 active

conversation.status     # => "active" 输出为字面量
conversation[:status]   # => 0 输出为数字键值（仅 Rails 4.x的版本）


conversation.status = 2            # => "archived"
conversation.status = "archived"   # => "archived"
conversation.status = :archived    # => "archived" 赋值时，三者等价

# 自动添加 Scope
Conversation.active    # 等价于 Conversation.where(status: 0)

# 获得一个名为 statuses 的 HashWithIndifferentAccess
Conversation.statuses # => { "active" => 0, "waiting" => 1, "archived" => 2 }
Conversation.statuses[:active]    # => 0
Conversation.statuses["archived"] # => 2

ActiveRecord::Enum 在 Rails 5.0+ 中的新特性

首先需要提一下，ActiveRecord::Enum 是在 Rails 4.1 加入的功能，所以 4.1 以下的版本是没有原生 Enum 支持的，可以使用 simple_enum 这个 gem 来实现类似需求

然后在 Rails 5.0 中，又对 ActiveRecord::Enum 做了一些扩展，使得它现在用起来更为顺手

主要的改进有：

1. where 查询支持直接使用字面量做查询条件

# 在 Rails 4.1+ 中
Conversation.where(status: %i[active waiting]).to_sql
# => "SELECT `conversations`.* FROM `conversations` WHERE `conversations`.`status` IN (NULL, NULL)"

# 惊不惊喜，意不意外，这也是 4.x 版本 Enum 比较鸡肋的原因，正确的你应这样写
Conversation.where(status: %i[active waiting].map { |s| Conversation.statuses[s] }).to_sql
# => "SELECT `conversations`.* FROM `conversations` WHERE `conversations`.`status` IN (0, 1)"

# 好在，Rails 5.0 之后就可以这么用了
Conversation.where(status: %i[active waiting]).to_sql
# => "SELECT \"conversations\".* FROM \"conversations\" WHERE \"conversations\".\"status\" IN (0, 1)"

# BUT，当你选择手写 SQL 查询条件的时候，仍是需要自己转义的
Conversation.where("status <> ?", Conversation.statuses[:archived])

2. conversation[:status] 与 conversation.status 返回值一致，都是字面量

# Rails 4.1+
conversation.status # => "active"
conversation[:status] # => 0
Conversation.pluck(:status) # => [0, 1, 2, 1, ...]

# Rails 5.0+
conversation.status # => "active"
conversation[:status] # => "active"
Conversation.pluck(:status) # => ["active", "waiting", "archived", "waiting", ...]

3. 增加了两个可选参数 `_prefix` 和 `_suffix`

在 Rails 4.1+ 的版本中，即使是不同的 enum 字段也不能有同名的值

# user.rb
  enum status: [:temporary, :active, :deleted]
  enum admin_status: [:active, :super_admin]

# rails console
irb(main):001:0> u = User.new
ArgumentError: You tried to define an enum named "admin_status" on the model "User", but this will generate a instance method "active?", which is already defined by another enum.
...

于是在 Rails 5 中，引入了 _prefix 和 _suffix 两个选项来解决这个问题，它会给对应的 !、? 以及 scope 方法加上前/后缀以示区分

# user.rb
  enum status: [:temporary, :active, :deleted], _suffix: true
  enum admin_status: [:active, :super_admin]

# rails console
  user = User.active_status.first
  user.active_status?
  user.deleted_status!

# user.rb
  enum status: [:temporary, :active, :deleted], _suffix: :stat
  enum admin_status: [:active, :super_admin]

# rails console
  user = User.active_stat.first
  user.active_stat?
  user.deleted_stat!

实际使用中的一些经验总结

1. 不要使用数据库的 enum！！！

除非你们的 DBA 同意你这么做，并且以后的迁移由他负责，否则真心不建议使用

2. 尽量升级到 Rails 5 以上的版本

Rails 4.x 的 Enum 有点鸡肋的感觉，看上去感觉很爽，实际上用着蛋疼。

3. 对 enum 字段赋值时，已经隐含了数据验证

在对一个 enum 字段赋值时，值必须是该字段字面量（symbol/string 皆可）或数字键值中的一个，否则会直接抛出一个 ArgumentError

以上文例子来说，给 conversation.status 赋值时，必须是 [:active, :waiting, :archived, "active", "waiting", "archived", 0, 1, 2] 中的一个，否则就会报错

4. 尽量不要使用数组来定义 enum

就是不要使用下面这种形式

enum status: [ :active, :waiting, :archived ]
enum status: %i[active waiting archived]

相比起使用 Hash，数组相当于隐式指定了数字键值，字面量的顺序就很关键。你无法保证每个可能改这处代码的人都深知这一点，而一旦被插值或者打乱顺序，可能会导致几个通宵的加班。

5. 手动设置了 table_name 时，需要警惕关联查询的陷阱

注：这条是 Rails 5.x 的专属烦恼

# post.rb
class Post < ActiveRecord::Base
  self.table_name = :articles

  has_many :comments

  enum category: { it: 0, law: 1, medical: 2 }
end

# comment.rb
class Comment < ActiveRecord::Base
    belongs_to :post, foreign_key: :article_id
end

# 正常查询是 OK 的
Post.law.to_sql 
#=> "SELECT \"articles\".* FROM \"articles\" WHERE \"articles\".\"category\" = 1"

# 作为关联表的查询条件，enum 字段就无法转义了，查询会报错
Comment.joins(:post).where(articles: { category: :law }).to_sql
# => "SELECT \"comments\".* FROM \"comments\" INNER JOIN \"articles\" ON \"articles\".\"id\" = \"comments\".\"article_id\" WHERE \"articles\".\"category\" = 'law'"

# 故意写个错的查询，看看错出在哪儿
Comment.joins(:post).where(post: { category: :law }).to_sql
# => "SELECT \"comments\".* FROM \"comments\" INNER JOIN \"articles\" ON \"articles\".\"id\" = \"comments\".\"article_id\" WHERE \"post\".\"category\" = 1"

通过这个对比可以发现，因为手动设置了 table_name 时，关联表查询需要指定真实的表名，这会导致 enum 字段无法被正确转义

前方高能预警，神坑要来了！！！

猜猜这个查询会不会报错？能不能查出数据？

Comment.joins(:post).where(articles: { category: [:law] })

答案是：不会报错，会查到数据，但绝不是你想要的

Comment.joins(:post).where(articles: { category: [:law] }).to_sql
# => "SELECT \"comments\".* FROM \"comments\" INNER JOIN \"articles\" ON \"articles\".\"id\" = \"comments\".\"article_id\" WHERE \"articles\".\"category\" = 0"

where 条件里面变成了 "articles"."category" = 0, 也就是查出了条件为 { category: :it } 的数据，够惊悚吧

所以，遇到这种情况，最好自己做转义！自己做转义！自己做转义！

6. 给 enum 字段添加默认值是一个好习惯

默认值最好还是定义的属性值里的第一个，通常来说是『0』

create_table :conversations do |t|
  t.integer :status, limit: 2, default: 0, null: false
end

特别是对于 4.x 版本而言，如果字段允许为 null，那当你按 5.x 的习惯写 where 查询的时候，可能会返回些让你一脸懵逼的结果。

7. 添加新属性时，最好写一个迁移

加属性值的时候，并不涉及到数据库变动，为什么要写迁移呢？当然这不是必须的，建议写主要出于两项考虑

检测当前数据库中新加的值是否已经被占用
更新数据库字段的 comment

当多个系统使用同一张数据表的时候，可能会出现 A 系统加了一个新的状态 { deleted: 3 }，B 系统不知道，也添加了一个 { reactive: 3 } 的新状态，等到某天其中一方发现问题时，线上的数据早已经是一团浆糊了。

所以在这种情况下，应该写一个迁移

class AddDeletedStatusToConversations < ActiveRecord::Migration[5.1]
  def up
    raise "The value of deleted status has already been taken." if Conversation.deleted.count.positive?
    change_column :conversations, :status, :integer, default: 0, null: false, comment: "0 - active, 1 - waiting, 2 - archived, 3 - deleted"
  end
end

虽然这并不能保证万无一失，但及时的修改 comment 至少还是一个好习惯，毕竟使用数据库的可能不止是写 Rails 的人，还有 DBA，还有数据分析师，好的 comment 给他们带来很多便利

8. 数据库字段不一定非得是 Integer

可以是 boolean（个人觉得 boolean 字段已经没有必要使用 enum 了，毕竟语意已经很明确了）

还可以是 string，在对一些老代码做重构的时候，这个特性可能会很实用

9. 结合 I18n 食用，风味更佳

针对 enum 的 i18n 方案有很多，比如

enum_i18n / human_enum / active_record-humanized_enum

这三个很相似，都是把翻译写在 zh-CN.activerecord.attributes.conversation.statuses 下面，只是调用方式略微有点不同

另外还有 @zmbacker 写的 enum_help

它的翻译写在 zh-CN.enums.conversation.status 下面，相比起来更直观一点，而且它支持 simple_form，个人比较推荐

如果你不怕麻烦，也不想引入任何 gem，还可以利用 human_attribute_name 来实现：

# zh-CN.yml
# zh-CN:
#   activerecord:
#     attributes:
#       conversation/status:
#         active: 当前激活
#         waiting: 等待中
#         archived: 已归档

conversation.status # => "active"
Conversation.human_attribute_name("status.#{conversation.status}") # => "当前激活"

10. enum 的字面量要注意避开 model 已有的 method_names/attribute_names

这一点就不用啰嗦了，除非是表字段特别复杂，正常情况下，应该是不太会在这个问题上犯错的。

参考文章：When you should and should NOT use ENUM data type

关于 inverse_of 的困惑与探究

IChou — Sat, 04 Apr 2015 15:11:29 +0800

🚨 Rails5 以后，inverse_of 已经做了不少变更，这篇帖子的内容可能已经不在符合现在的情况

最近在使用关联的时候，由于一点手误遇到了些问题，于是花了一下午时间来仔细读了 Guide 中关于 Active Record Associations 的部分。在看到 inverse_of 时，感觉自己突然一下就懵了。

问题缘由

我对 inverse_of 的困惑并不是在实际使用中产生的，即使不了解它也能在项目中愉快的玩耍，这似乎又旁证了 Rails 是一个很智能的框架。

不过它的 Guide 文档里这一部分就有些描述不清了（或说自相矛盾？）。关于 inverse_of 的功用倒是没有什么疑惑，只是被这混乱的文档弄得不知道哪些情况下需要去显式的声明 inverse_of , 哪些情况下 inverse_of 又是无效果的。

问题描述

Guide 中关于 inverse_of 的解释：http://guides.rubyonrails.org/association_basics.html#bi-directional-associations

其中有两处说明让我很费解：

其一：

There are a few limitations to inverse_of support:

They do not work with :through associations.

They do not work with :polymorphic associations.

They do not work with :as associations. 4. For belongs_to associations, has_many inverse associations are ignored.

~~按第四条所说的，has_many 的关联是无效的，但是 Guide 中的栗子便是使用的 has_many, 而且很好的证明了 inverse_of 的效果。~~

【2016.6.17】这个其实没有疑问，这是指在 has_many / belongs_to 关联的两端都声明 inverse_of，只会按 belongs_to 一方的声明处理

其二：

Every association will attempt to automatically find the inverse association and set the :inverse_of option heuristically (based on the association name). Most associations with standard names will be supported. However, associations that contain the following options will not have their inverses set automatically:

:conditions

:through

:polymorphic

:foreign_key

按这个说法，只要是按约定命名的关联会自动加上 inverse_of, 那么，演示用例是按约定命名的吧，也不属于下面声明的四种情况，为什么加与不加是有差别的？

【2016.6.17】这个其实也没有疑问，这是因为 Rails 版本变迁，我当时看得文档没来得及更新导致的。文章后面部分已经解释了这个问题，这里提前把结论贴一下。

动手验证

验证环境 Rails 版本：4.2.1

定义模型：

# a.rb
class A < ActiveRecord::Base
    has_many :b
end

# b.rb
class B < ActiveRecord::Base
    belongs_to :a
end

测试结果：

2.2.1 :001 > a = A.create :name => 'ichou'
 => #<A id: 2, name: "ichou", created_at: "2015-04-04 06:41:41", updated_at: "2015-04-04 06:41:41">

2.2.1 :002 > b1 = B.create :name => 'kindle', :a => a
 => #<B id: 3, name: "kindle", a_id: 2, created_at: "2015-04-04 06:42:45", updated_at: "2015-04-04 06:42:45">

2.2.1 :003 > b2 = B.create :name => 'Air', :a => a
 => #<B id: 4, name: "Air", a_id: 2, created_at: "2015-04-04 06:43:10", updated_at: "2015-04-04 06:43:10">

2.2.1 :004 > a.name.object_id
 => 70264637654120

2.2.1 :005 > b1.a.name.object_id
 => 70264637654120

2.2.1 :006 > b2.a.name.object_id
 => 70264637654120

object_id 全都一样，说明 inverse_of 已经被启用了。事实上，即使严格按照 Guide 的案例来做，你也会发现结果全是 True，而不是 Guide 所说的结果。

结论：在 4.1+ 的 Rails 中，即使不手动声明 inverse_of ，has_many 关联也会自动创建，而且是有效的！

总结与使用

inverse_of 的作用在于关联模型间共用实例，而不是让不同的查询在内存中存在多份 Copies. 实际运用中可以带来两个好处，一是减少数据库查询；二是在对关联对象修改数据后写入数据前，保证从任何一方取得的值都是最新的。
从 4.1 开始，基本的关联类型（has_many, has_one, belongs_to），若按约定命名，不需要再手动设定 inverse_of
(当时的)Guide 的相关用例是有问题的，或者说是适用于老版本的 Rails，而不是当前版本。 因为给 basic associations\* 自动添加 inverse_of 是在 Rails 4.1 加入的特性。 事实上，关于 has_many 的那个例子，在 4.1 及以后的版本中已经不能复现了。
inverse_of 已经支持 has_many 是从 3.2.1 开始的，4.1 开始支持自动添加 inverse_of, 但是 has_many :through 仍然需要显式声明 inverse_of
使用没有持久化的关联对象时，根据需要使用 inverse_of，否则反向调用会得到 nil 或者还未更新的对象。详见 topics/6426

感谢社区和 stackoverflow 上的大大们，感谢微信群成都 Ruby 群里的星哥。

比较新手向的帖子，若有纰漏，烦请指正

参考文章

关于 mpg123 获取音频文件比特率的问题

IChou — Thu, 01 May 2014 12:03:53 +0800

啊啦作为小白实在扛不住了还是决定到论坛上来咨询一下了

涉及 gem：audite , mpg123 , portaudio

事件描述：我最近在练习 ruby，决定把虾米猜电台写个 ruby 版。我想把下载进度和播放进度以进度条的形式展现出来，所以我至少需要获取 mp3 的时长，问题就出在这里：

1.虾米的 mp3 文件既有 CBR 又有 VBR

2.audite 这个 gem 计算时间采用的是 Duration = Samples / Samples_per_Frame * time_per_frame 这个公式对于没有在第一桢后面用 header 记录信息的 CBR 来说，在文件没下载完整之前取到的 Samples 是错误的，于是也就没有办法获得时长

3.当然如果能对 CBR 编码的 mp3 取到比特率（Bitrate），根据 http header 里面提供的文件大小也是能算出音频时长的，但是各种找资料，还是不知道 mpg123 该如何取得比特率

由于对音频文件的知识十分有限（都是现学的 ~~o(>_<)o ~~），所以也不知道上边的理解对不对主要是实在找不到思路了所以拿出来给大家看看，看还能不能再抢救一下，没有要做伸手党的意思哈~

PS：不知道有人发现没，通过 gem 安装的 audite 好像是有点小问题的，不过 github 上边的源码是 ok 的，也不知是不是我打开的方式不对 ~

等回复的时间，我还是去研究下虾米的手机版吧，看看它是怎么处理的，阿门

The Great Wall 没有墙掉 Ruby 包地址了？！

IChou — Sat, 15 Sep 2012 14:39:59 +0800

今天在阿里云的服务器上部署 Rails 环境，由于是第一次使用 Centos，发现它有点不同比如：它没有在用户根目录下创建.rvm 文件夹（这好像是真 rvm 文件夹的替身，求解）于是我按论坛 Wiki 里的帖子安装时，这一步

# 替换 Ruby 下载地址到国内淘宝镜像服务器
$ sed -i 's/ftp\.ruby-lang\.org\/pub\/ruby/ruby\.taobao\.org\/mirrors\/ruby/g' ~/.rvm/config/db

失败了

接着我硬着头皮继续安装，发现从原始位置也可以下载！！ 难道伟大的 Wall 已经不再屏蔽这个地址了？

找到rvm/config/db后看到的下载地址

Mac 下 Rails 连接 Mysql 的一点点心得

IChou — Sat, 08 Sep 2012 04:04:15 +0800

首先附上我的工作环境

系统：Mac OS X 10.7.4

Ruby：ruby 1.9.3p194

Rails：Rails 3.2.6

Mysql：5.5.27 MySQL Community Server

由于我手上的书籍都是从图书馆借来的，他们的 rails 版本普遍比较早，虽然都是默认 mysql 数据库，但都没提到 rails 与 mysql 的连接问题，在他们看来这似乎不需要任何说明的。

但事实是，这是个灰常严肃的问题！至少在我这个版本下是的。

按书上操作，只会得到一个结果

ActiveRecord::ConnectionNotEstablished

目前为止，这个问题百度无法解决，我是在一个视频中无意看到的

原来在这个版本里，gem 里面内含了 sqlite3 的驱动包，但是没有 mysql 的，需要自己安装

安装方法：

1.cd 到你的项目目录比如我的是

cd ruby/demo

2.安装 mqsql 驱动包（插件）

gem install mysql

3.在项目的 Gemfile 文件中包含 mysql 驱动包

vi Gemfile

新加一行

gem 'mysql'

**感谢2L @ywjno 提醒 用Mysql2才是王道**

gem install mysql2

gem 'mysql2'

好，到这儿就安装完成了，重新启动 WEBrick 服务。这时你有可能得到两种结果：

成功了，或者报错：

undefined method 'init' for Mysql:Class

这又是怎么回事儿呢？

研究过 Mac 下 Mysql 与 Apche 连接的同学应该明白的，没错，因为 Mac 下 Mysql 的安装目录与 Liunx 等使用的默认安装路径是不一样的，rails 去找默认路径当然找不到，这个时候只要只要导入 mysql lib 环境变量即可。

export DYLD_LIBRARY_PATH=/usr/local/mysql/lib/

现在在运行，没问题了是不是？文章大部分解说都是自己参详的，看我还在研究这个就能明白我也才入门的小白，若有错误之处，请各位大神指正！