Ruby on Rails. ¿Cómo uso el método Active Record .build en un: pertenece a una relación?

No he podido encontrar ninguna documentación sobre el método .build en Rails (actualmente estoy usando 2.0.2).

A través de la experimentación, parece que puede usar el método de compilación para agregar un registro a una has_manyrelación antes de que cualquiera de los registros se haya guardado.

Por ejemplo:

class Dog < ActiveRecord::Base
  has_many :tags
  belongs_to :person
end

class Person < ActiveRecord::Base
  has_many :dogs
end

# rails c
d = Dog.new
d.tags.build(:number => "123456")
d.save # => true

Esto guardará tanto el perro como la etiqueta con las claves externas correctamente. Esto no parece funcionar en una belongs_torelación.

d = Dog.new
d.person.build # => nil object on nil.build

También he intentado

d = Dog.new
d.person = Person.new
d.save # => true

La clave foránea Dogno está configurada en este caso debido al hecho de que en el momento en que se guarda, la nueva persona no tiene una identificación porque aún no se ha guardado.

Mis preguntas son:

1. ¿Cómo funciona Build para que Rails sea lo suficientemente inteligente como para descubrir cómo guardar los registros en el orden correcto?

2. ¿Cómo puedo hacer lo mismo en una belongs_torelación?

3. ¿Dónde puedo encontrar documentación sobre este método?

Gracias

Donde está documentado:

De la documentación de la API bajo la asociación has_many en " Módulo ActiveRecord :: Asociaciones :: ClassMethods "

collection.build (atributos = {}, ...) Devuelve uno o más objetos nuevos del tipo de colección que han sido instanciados con atributos y vinculados a este objeto a través de una clave foránea, pero que aún no se han guardado. Nota: ¡Esto solo funciona si ya existe un objeto asociado, no si es nulo!

La respuesta para construir en la dirección opuesta es una sintaxis ligeramente alterada. En tu ejemplo con los perros,

Class Dog
   has_many :tags
   belongs_to :person
end

Class Person
  has_many :dogs
end

d = Dog.new
d.build_person(:attributes => "go", :here => "like normal")

o incluso

t = Tag.new
t.build_dog(:name => "Rover", :breed => "Maltese")

También puede usar create_dog para que se guarde instantáneamente (al igual que el método "crear" correspondiente al que puede llamar en la colección)

¿Cómo son los rieles lo suficientemente inteligentes? Es mágico (o más exactamente, simplemente no lo sé, ¡me encantaría descubrirlo!)

@article = user.articles.build(:title => "MainTitle")
@article.save