RESTful resource routes in Ruby on Rails - Mini Project: Build & Apply

RESTful Resource Routes in Rails

📖 Scenario: You are building a simple blog application where users can manage posts. You want to set up the routes in Rails to handle all the standard actions for posts like viewing, creating, editing, and deleting.

🎯 Goal: Set up RESTful resource routes for posts in a Rails application using the resources method. This will create all the standard routes for CRUD operations automatically.

📋 What You'll Learn

Create a Rails routes file with a Rails.application.routes.draw do block

Add a resource route for posts using the resources method

Ensure the routes include all seven standard RESTful actions: index, show, new, create, edit, update, destroy

Close the routes block properly

💡 Why This Matters

🌍 Real World

Setting up RESTful routes is a common task in Rails web applications to organize how URLs map to controller actions for resources like posts, users, or products.

💼 Career

Understanding RESTful routes is essential for Rails developers to build maintainable and scalable web applications following Rails conventions.

1

Create the routes block

Write the opening line Rails.application.routes.draw do to start the routes file.

Ruby on Rails

# Your code here

Hint

Every Rails routes file starts with Rails.application.routes.draw do and ends with end.

2

Add resource route for posts

Inside the Rails.application.routes.draw do block, add the line resources :posts to create RESTful routes for posts.

Ruby on Rails

Rails.application.routes.draw do
  # Add resource route for posts here
end

Hint

The resources method creates all standard RESTful routes for a resource.

3

Verify the routes include all standard actions

Confirm that the resources :posts line creates routes for index, show, new, create, edit, update, and destroy actions.

Ruby on Rails

Rails.application.routes.draw do
  resources :posts
  # Check that all RESTful actions are included
end

Hint

The resources method automatically sets up all seven RESTful routes for the resource.

4

Complete the routes file

Ensure the routes file is properly closed with end after the resources :posts line.

Ruby on Rails

Rails.application.routes.draw do
  resources :posts
  # Confirm the block is closed
end

Hint

Make sure the routes block is closed with end to avoid syntax errors.

Practice

1. What does the resources :books line do in a Rails routes file?

easy

A. Creates all standard RESTful routes for the books resource automatically.

B. Creates only the index and show routes for books.

C. Creates a single custom route named books.

D. Deletes all routes related to books.

Solution

1. Step 1: Understand the resources method

   The resources method in Rails automatically generates all seven standard RESTful routes (index, show, new, create, edit, update, destroy) for a given resource.

2. Step 2: Apply to resources :books

   Using resources :books creates all these routes for the books controller, enabling standard CRUD actions.

3. Final Answer:

   Creates all standard RESTful routes for the books resource automatically. -> Option A

4. Quick Check:

   resources :books = all RESTful routes [OK]

Hint: Remember: resources creates all standard routes by default [OK]

Common Mistakes:

• Thinking it creates only some routes
• Confusing resources with resource (singular)
• Assuming it deletes routes

2. Which of the following is the correct syntax to create only the index and show routes for a resource named articles?

easy

A. resources :articles, only: [:index, :show]

B. resources :articles, except: [:index, :show]

C. resource :articles, only: [:index, :show]

D. resources :articles, only: index, show

Solution

1. Step 1: Use resources with only option

   To limit routes to specific actions, use only: [:index, :show] with resources.

2. Step 2: Check syntax correctness

   resources :articles, only: [:index, :show] correctly uses symbols in an array with only. resources :articles, except: [:index, :show] uses except which excludes actions, not includes. resource :articles, only: [:index, :show] uses singular resource which is for single objects, not collections. resources :articles, only: index, show syntax is invalid because only expects an array.

3. Final Answer:

   resources :articles, only: [:index, :show] -> Option A

4. Quick Check:

   Limit routes with only and array [OK]

Hint: Use only: with an array of symbols to limit routes [OK]

Common Mistakes:

• Using except instead of only
• Using singular resource for collections
• Incorrect syntax without brackets

3. Given the route declaration resources :users, except: [:destroy], which HTTP verb and path will NOT be available?

medium

A. GET /users/:id/edit

B. DELETE /users/:id

C. POST /users

D. GET /users

Solution

1. Step 1: Understand except: [:destroy]

   The except option removes the specified action routes. Here, destroy is excluded, so no route for deleting a user is created.

2. Step 2: Identify the HTTP verb and path for destroy

   The destroy action corresponds to the HTTP DELETE verb on the path /users/:id. This route will be missing.

3. Final Answer:

   DELETE /users/:id -> Option B

4. Quick Check:

   except: [:destroy] removes DELETE route [OK]

Hint: Destroy action uses DELETE verb; except removes it [OK]

Common Mistakes:

• Confusing except with only
• Thinking GET routes are removed
• Mixing HTTP verbs with wrong actions

4. Identify the error in this routes file snippet:

resources :products, only: :show, :edit

medium

A. The only option should list all seven RESTful actions.

B. The resources method cannot use only option.

C. The resource name products should be singular.

D. The only option should be an array of symbols, not separate symbols.

Solution

1. Step 1: Check syntax of only option

   The only option expects an array of symbols like only: [:show, :edit]. Writing only: :show, :edit passes :show as the only option and :edit is outside the hash, causing syntax error.

2. Step 2: Verify other options

   resources supports only. The resource name should be plural for collections. Listing all actions is optional.

3. Final Answer:

   The only option should be an array of symbols, not separate symbols. -> Option D

4. Quick Check:

   only needs array syntax [OK]

Hint: Use brackets for multiple actions in only: [:show, :edit] [OK]

Common Mistakes:

• Omitting brackets for multiple actions
• Using singular resource for collections
• Thinking only must list all actions

5. You want to create RESTful routes for a resource orders but only allow index, show, and create actions. Additionally, you want a custom member route cancel that responds to POST requests. Which routes file code is correct?

hard

A. resources :orders, except: [:edit, :update, :destroy] do\n post 'cancel', on: :member\nend

B. resources :orders, only: [:index, :show, :create] do\n get 'cancel', on: :collection\nend

C. resources :orders, only: [:index, :show, :create] do\n post 'cancel', on: :member\nend

D. resource :orders, only: [:index, :show, :create] do\n post 'cancel', on: :member\nend

Solution

1. Step 1: Limit routes to index, show, create

   Use only: [:index, :show, :create] to restrict routes to these actions.

2. Step 2: Add custom member route for cancel

   Use a block with post 'cancel', on: :member to add a POST route for cancel on individual orders.

3. Step 3: Check other options

   resources :orders, only: [:index, :show, :create] do\n get 'cancel', on: :collection\nend uses GET and collection which is incorrect for cancel on a single order. resources :orders, except: [:edit, :update, :destroy] do\n post 'cancel', on: :member\nend uses except which is less clear and includes extra routes. resource :orders, only: [:index, :show, :create] do\n post 'cancel', on: :member\nend uses singular resource which is wrong for collections.

4. Final Answer:

   resources :orders, only: [:index, :show, :create] do\n post 'cancel', on: :member\nend -> Option C

5. Quick Check:

   Use only with member block for custom POST route [OK]

Hint: Use member block with post for single resource custom action [OK]

Common Mistakes:

• Using collection instead of member for single resource
• Using singular resource for collections
• Using wrong HTTP verb for custom action