В Rails 3 Docs , то buildметод ассоциаций описывается как такой же , как newметод, но с автоматическим присвоением внешнего ключа. Прямо из документации:

Firm#clients.build (similar to Client.new("firm_id" => id))

Я читал подобное в другом месте.

Однако, когда я использую new(например , some_firm.clients.newбез каких - либо параметров), нового клиента firm_idассоциация будет создана автоматически. Я прямо сейчас смотрю на результаты в консоли!

Я что-то упускаю? Документы немного устарели (маловероятно)? В чем разница между buildи new?

Вы немного неправильно читаете документы. some_firm.client.newсоздает новый Clientобъект из коллекции клиентов, и поэтому он может автоматически установить firm_idзначение some_firm.id, тогда как вызываются документы, Client.newкоторые вообще не знают идентификатора какой-либо фирмы, поэтому ему нужно firm_idпередать ему.

Единственная разница между some_firm.clients.newи, some_firm.clients.buildпохоже, состоит в том, что buildв clientsколлекцию также добавляется вновь созданный клиент :

henrym:~/testapp$ rails c
Loading development environment (Rails 3.0.4)
r:001 > (some_firm = Firm.new).save # Create and save a new Firm
#=> true 
r:002 > some_firm.clients           # No clients yet
#=> [] 
r:003 > some_firm.clients.new       # Create a new client
#=> #<Client id: nil, firm_id: 1, created_at: nil, updated_at: nil> 
r:004 > some_firm.clients           # Still no clients
#=> [] 
r:005 > some_firm.clients.build     # Create a new client with build
#=> #<Client id: nil, firm_id: 1, created_at: nil, updated_at: nil> 
r:006 > some_firm.clients           # New client is added to clients 
#=> [#<Client id: nil, firm_id: 1, created_at: nil, updated_at: nil>] 
r:007 > some_firm.save
#=> true 
r:008 > some_firm.clients           # Saving firm also saves the attached client
#=> [#<Client id: 1, firm_id: 1, created_at: "2011-02-11 00:18:47",
updated_at: "2011-02-11 00:18:47">] 

Если вы создаете объект через ассоциацию, это buildдолжно быть предпочтительнее, так newкак сборка сохраняет ваш объект в памяти some_firm(в данном случае) в согласованном состоянии даже до того, как какие-либо объекты были сохранены в базе данных.

buildэто просто псевдоним для new:

alias build new

Полный код можно найти: https://github.com/rails/rails/blob/master/activerecord/lib/active_record/relation.rb#L74

Вы правы, функции build и new имеют одинаковый эффект установки внешнего ключа, когда они вызываются через ассоциацию. Я считаю, что причина, по которой документация написана таким образом, состоит в том, чтобы уточнить, что создается новый объект Client, а не отношения новой активной записи. Это тот же эффект, что и вызов .new для класса в Ruby. Это означает, что в документации разъясняется, что вызов построения на основе ассоциации - это то же самое, что и создание нового объекта (вызов .new) и передача внешних ключей этому объекту. Все эти команды эквивалентны:

Firm.first.clients.build
Firm.first.clients.new
Client.new(:firm_id => Firm.first.id)

Я считаю, что причина .build существует в том, что Firm.first.clients.new может интерпретироваться как означающее, что вы создаете новый объект отношения has_many, а не фактического клиента, поэтому вызов .build - это способ прояснить это.

buildпротив new:

в основном новый и сборка такие же, но сборка хранит объект в памяти ,

например:

для новых:

Client.new(:firm_id=>Firm.first.id)

Для сборки:

Firm.first.clients.build

Здесь клиенты хранятся в памяти, при сохранении фирмы также сохраняются связанные записи.

Model.new

Tag.new post_id: 1создаст экземпляр тега с его post_idнабором.

@ model.models.new

@post.tags.buildделает то же самое, И созданный тег будет существовать @post.tagsдаже до его сохранения.

Это означает, что @post.saveбудут сохранены как @post, так и вновь созданный тег (при условии, что установлен inverse_of). Это замечательно, потому что Rails будет проверять оба объекта перед сохранением, и ни один из них не будет сохранен, если какой-либо из них не прошел проверку.

models.new против models.build

@post.tags.buildи @post.tags.newэквивалентны (по крайней мере, начиная с Rails 3.2).