jhjguxin/creating-nested-resources-in-ruby-on-rails-3-and-updating-scaffolding-links-and-redirection.markdown

In this article, I'll walk through a basic Rails (3.2.x) setup for creating a nested resource for two models. Nested resources work well when you want to build out URL structure between two related models, and still maintain a RESTful convention. This code assumes you are running RVM to manage Ruby/Gem versions, and Git for version control.

Creating a new Rails project

$ mkdir family # create rvm gemset 
$ echo "rvm use --create ruby-1.9.2@family" > family/.rvmrc 
$ cd family # install rails 
$ gem install rails # create new rails project 
$ rails new . # version control 
$ git init 
$ git add . 
$ git commit -am "new rails project"

Create two models (Parent & Child)

# Parent model 
$ rails generate scaffold Parent name:string 
$ git add . 
$ git commit -am "rails generate scaffold Parent name:string" 
# Child model 
$ rails generate scaffold Child name:string parent_id:integer 
$ git add . 
$ git commit -am "rails generate scaffold Child name:string parent_id:integer" 
# Create db (defaults to SQLite3) 
$ rake db:migrate 
# version control 
$ git add db/schema.rb 
$ git commit db/schema.rb -m "created database schema"

Review un-nested routes

$ rake routes
   children GET    /children(.:format)          children#index
            POST   /children(.:format)          children#create
  new_child GET    /children/new(.:format)      children#new
 edit_child GET    /children/:id/edit(.:format) children#edit
      child GET    /children/:id(.:format)      children#show
            PUT    /children/:id(.:format)      children#update
            DELETE /children/:id(.:format)      children#destroy
    parents GET    /parents(.:format)           parents#index
            POST   /parents(.:format)           parents#create
 new_parent GET    /parents/new(.:format)       parents#new
edit_parent GET    /parents/:id/edit(.:format)  parents#edit
     parent GET    /parents/:id(.:format)       parents#show
            PUT    /parents/:id(.:format)       parents#update
            DELETE /parents/:id(.:format)       parents#destroy

Adding model relationships

# file: app/models/parent.rb
class Parent < ActiveRecord::Base
  attr_accessible :name
  has_many :children
end

# file: app/models/child.rb
class Child < ActiveRecord::Base
  attr_accessible :name, :parent_id
  belongs_to :parent
end

# version control
$ git commit app/models -m "added relationships to models"

Nesting the routes

$ rake routes
  parent_children GET    /parents/:parent_id/children(.:format)          children#index
                  POST   /parents/:parent_id/children(.:format)          children#create
 new_parent_child GET    /parents/:parent_id/children/new(.:format)      children#new
edit_parent_child GET    /parents/:parent_id/children/:id/edit(.:format) children#edit
     parent_child GET    /parents/:parent_id/children/:id(.:format)      children#show
                  PUT    /parents/:parent_id/children/:id(.:format)      children#update
                  DELETE /parents/:parent_id/children/:id(.:format)      children#destroy
          parents GET    /parents(.:format)                              parents#index
                  POST   /parents(.:format)                              parents#create
       new_parent GET    /parents/new(.:format)                          parents#new
      edit_parent GET    /parents/:id/edit(.:format)                     parents#edit
           parent GET    /parents/:id(.:format)                          parents#show
                  PUT    /parents/:id(.:format)                          parents#update
                  DELETE /parents/:id(.:format)                          parents#destroy

Adding test data via Rails console

$ rails c

> dad = Parent.new(:name => 'Paul')
 => #<Parent id: nil, name: "Paul", created_at: nil, updated_at: nil> 

> dad.save
   (0.1ms)  begin transaction
  SQL (20.0ms)  INSERT INTO "parents" ("created_at", "name", "updated_at") VALUES (?, ?, ?)  [["created_at", Fri, 06 Apr 2012 16:13:17 UTC +00:00], ["name", "Paul"], ["updated_at", Fri, 06 Apr 2012 16:13:17 UTC +00:00]]
   (2.4ms)  commit transaction
 => true 

> son = dad.children.new(:name => 'Eric')
 => #<Child id: nil, name: "Eric", parent_id: 1, created_at: nil, updated_at: nil> 

> daughter = dad.children.new(:name => 'Mara')
 => #<Child id: nil, name: "Mara", parent_id: 1, created_at: nil, updated_at: nil> 

> exit

Adding a private controller method to load the Parent object for each method

# file: app/controllers/children_controller.rb
@@ -1,4 +1,7 @@
 class ChildrenController < ApplicationController
+
+  before_filter :load_parent
+
   # GET /children
   # GET /children.json
   def index
@@ -80,4 +83,11 @@ class ChildrenController < ApplicationController
       format.json { head :no_content }
     end
   end
+
+  private
+
+    def load_parent
+      @parent = Parent.find(params[:parent_id])
+    end
+
 end

At this point, each controller and view for the Child class model needs to be adjusted (links, redirection, form, etc)

Method: children#index

# file: app/controllers/children_controller.rb

   def index
-    @children = Child.all
+    @children = @parent.children.all

# file: app/views/children/index.html.erb

-    <td><%= link_to 'Show', child %></td>
-    <td><%= link_to 'Edit', edit_child_path(child) %></td>
-    <td><%= link_to 'Destroy', child, confirm: 'Are you sure?', method: :delete %></td>
+    <td><%= link_to 'Show', parent_child_path(@parent, child) %></td>
+    <td><%= link_to 'Edit', edit_parent_child_path(@parent, child) %></td>
+    <td><%= link_to 'Destroy', [@parent, child], confirm: 'Are you sure?', method: :delete %></td>
 
-<%= link_to 'New Child', new_child_path %>
+<%= link_to 'New Child', new_parent_child_path(@parent) %>

Method: children#new

# file: app/controllers/children_controller.rb

   def new
-    @child = Child.new
+    @child = @parent.children.new

# file: app/views/children/_form.html.erb

-<%= form_for(@child) do |f| %>
+<%= form_for([@parent, @child]) do |f| %>

# file: app/views/children/new.html.erb

-<%= link_to 'Back', children_path %>
+<%= link_to 'Back', parent_children_path(@parent) %>

Method: children#create

# file: app/controllers/children_controller.rb

   def create
-    @child = Child.new(params[:child])
+    @child = @parent.children.new(params[:child])
 
     respond_to do |format|
       if @child.save
-        format.html { redirect_to @child, notice: 'Child was successfully created.' }
+        format.html { redirect_to [@parent, @child], notice: 'Child was successfully created.' }

Method: children#show

# file: app/controllers/children_controller.rb

   def show
-    @child = Child.find(params[:id])
+    @child = @parent.children.find(params[:id])

# file: app/views/children/show.html.erb

-<%= link_to 'Edit', edit_child_path(@child) %> |
-<%= link_to 'Back', children_path %>
+<%= link_to 'Edit', edit_parent_child_path(@parent, @child) %> |
+<%= link_to 'Back', parent_children_path(@parent) %>

Method: children#edit

# file: app/controllers/children_controller.rb

   def edit
-    @child = Child.find(params[:id])
+    @child = @parent.children.find(params[:id])

# file: app/views/children/edit.html.erb

-<%= link_to 'Show', @child %> |
-<%= link_to 'Back', children_path %>
+<%= link_to 'Show', parent_child_path(@parent, @child) %> |
+<%= link_to 'Back', parent_children_path(@parent) %>

Method: children#update

# file: app/controllers/children_controller.rb

   def update
-    @child = Child.find(params[:id])
+    @child = @parent.children.find(params[:id])
 
     respond_to do |format|
       if @child.update_attributes(params[:child])
-        format.html { redirect_to @child, notice: 'Child was successfully updated.' }
+        format.html { redirect_to [@parent, @child], notice: 'Child was successfully updated.' }

Method: children#destroy

# file: app/controllers/children_controller.rb

   def destroy
-    @child = Child.find(params[:id])
+    @child = @parent.children.find(params[:id])
     @child.destroy
 
     respond_to do |format|
-      format.html { redirect_to children_url }
+      format.html { redirect_to parent_children_path(@parent) }

At this point, the default scaffolding's links and redirection have been updated to work with the nested routes.

jgjerset · 2013-11-19T19:05:45Z

Rails noob and had been trying to figure this out for hours. Your tutorial helped me tremendously. Thanks.

dmakhmutov · 2013-11-21T16:30:08Z

good tutorial. thanks

valdemarua · 2013-11-22T19:18:12Z

Good tutorial. Thank you.

oskarlakner · 2013-12-19T14:40:23Z

Very helpful, thank you!

nguyenj · 2014-01-03T14:40:35Z

This is great, can you also provide an update to Rails 4?

nslindtner · 2014-01-11T13:00:40Z

Nice gist. Perhaps you want to add the change to config/routes.rb files, made after adding the relation between models:

resources :parents do
resources :children
end

sangwonl · 2014-01-22T17:07:17Z

Great tutorial, indeed! I've struggled how to start from scaffolding.. (It's confusing to me..) Good stuff to learn!

ThomasBush · 2014-01-24T16:25:21Z

Hey I recently had a polymorphic association where I used this. In my case blocks(child) - products(parent) and blocks(child) - technologies(parent) were the associations. Products and technologies (and any number of other models) are parents and each have blocks as a child. Your view templates can't hard code just one model as shown in the example:

<%= link_to 'Edit', edit_parent_child_path(@parent, @child) %>

Instead I change controller code that populates the @parent variable so it can be dynamic depending on the parent model. Than in the controller index and show actions to can use:

resource, id = request.path.split('/')[1, 2]
parent_model = resource.singularize.classify.constantize
@parent = parent_model.find(id)

In routes.rb this would look like:

resources :products do
    resources :blocks
end

resources :technologies do
     resources :blocks
end

Thought maybe this could help someone else so I wanted to share.

helixtesting · 2014-01-30T11:31:27Z

awesome article.

codemonkey3045 · 2014-02-26T04:07:56Z

This is amazing! I've been stuck on this all day. THANK YOU! THANK YOU! THANK YOU! =D

wangguoqin1001 · 2014-04-01T04:58:23Z

Why hasn't there been a way to "rails g scaffold" a nested resource directly (or has there been one already)?

Tasha25 · 2014-05-27T13:49:15Z

How did you create this gist? I want to create steps to the various apps I build.

christianrojas · 2014-06-04T20:03:48Z

Awesome! thanks

trooney · 2014-08-05T01:06:05Z

Awesome!

gtheys · 2014-10-22T14:14:25Z

$ rails generate scaffold account name:string
$ rails g scaffold campaign name:string account:belongs_to

Can be used to create the relations

chaz1505 · 2015-03-24T23:01:54Z

great tutorial thanks

ricardocastaneda · 2015-06-23T04:59:45Z

I set myself into the large list of grateful people for this very well explained tutorial. Thanks also to those people from comments who shared code.

lortza · 2015-11-18T22:48:58Z

Beautiful work. Thank you!

khatchad · 2016-03-09T23:50:13Z

@nguyenj Any luck with rails 4?

khatchad · 2016-03-18T12:19:54Z

@nslindtner This fork has the part about the routes.rb changes.

EricLondon · 2016-06-06T19:15:55Z

name: Eric, parent: Paul, sounds a lot like my family. Thanks for the credit.

Here's the original blog post :)

Internet pro tip: when you copy someone's post, you should cite the source.

DivyaChouhan · 2016-07-15T05:43:42Z

Very well explained tutorial. It helps a lot. Thanx...

mices · 2017-04-03T21:55:52Z

You don't say what to put for else if validations cause return to form instead of save

jhjguxin/creating-nested-resources-in-ruby-on-rails-3-and-updating-scaffolding-links-and-redirection.markdown

Creating a new Rails project

Create two models (Parent & Child)

Review un-nested routes

Adding model relationships

Nesting the routes

Adding test data via Rails console

Adding a private controller method to load the Parent object for each method

jgjerset commented Nov 19, 2013

Uh oh!

dmakhmutov commented Nov 21, 2013

Uh oh!

valdemarua commented Nov 22, 2013

Uh oh!

oskarlakner commented Dec 19, 2013

Uh oh!

nguyenj commented Jan 3, 2014

Uh oh!

nslindtner commented Jan 11, 2014

Uh oh!

sangwonl commented Jan 22, 2014

Uh oh!

ThomasBush commented Jan 24, 2014

Uh oh!

helixtesting commented Jan 30, 2014

Uh oh!

codemonkey3045 commented Feb 26, 2014

Uh oh!

wangguoqin1001 commented Apr 1, 2014

Uh oh!

Tasha25 commented May 27, 2014

Uh oh!

christianrojas commented Jun 4, 2014

Uh oh!

trooney commented Aug 5, 2014

Uh oh!

gtheys commented Oct 22, 2014

Uh oh!

chaz1505 commented Mar 24, 2015

Uh oh!

ricardocastaneda commented Jun 23, 2015

Uh oh!

lortza commented Nov 18, 2015

Uh oh!

khatchad commented Mar 9, 2016

Uh oh!

khatchad commented Mar 18, 2016

Uh oh!

EricLondon commented Jun 6, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

DivyaChouhan commented Jul 15, 2016

Uh oh!

mices commented Apr 3, 2017

Uh oh!

EricLondon commented Jun 6, 2016 •

edited

Loading