Rails Create, Index, and Show Lab

Learning Goals

  • Generate create, index and show routes for one resource
  • Use strong params to create a new resource

Introduction

In this lab, we'll be building an API for a plant store! In addition to our usual Rails code, there is code for a React frontend application in the client directory.

The code for the frontend application is done. Your job is to create the Rails API so that the fetch requests on the frontend work successfully.

Instructions

The React application is in the client directory. To set it up, from the root directory, run:

$ npm install --prefix client

Using --prefix client will run the npm command within the client directory.

To set up your backend, run:

$ bundle install

To see how the React application and Rails API are interacting, you can run the Rails application in one terminal by running:

$ rails s

Then, open another terminal and run React:

$ npm start --prefix client

Each application will run on its own port on localhost:

Take a look through the components in the client/src/components/ folder to get a feel for what our app does. Note that the fetch requests in the frontend (in NewPlantForm and PlantPage) don't include the backend domain:

fetch("/plants");
// instead of fetch("http://localhost:3000/plants")

This is because we are proxying these requests to our API.

Deliverables

Model

Create a Plant model that matches this specification:

Column Name Data Type
name string
image string
price decimal

If you use a Rails generator, don't forget to pass the --no-test-framework argument!

After creating the Plant model, you can run rails db:migrate db:seed to run your migration and add some sample data to your database.

Check your progress by running rails c and verifying that the plants were created successfully!

Routes

Your API should have the following routes as well as the associated controller actions that return the appropriate JSON data:

Index Route

GET /plants


Response Body
-------
[
  {
    "id": 1,
    "name": "Aloe",
    "image": "./images/aloe.jpg",
    "price": 11.50
  },
  {
    "id": 2,
    "name": "ZZ Plant",
    "image": "./images/zz-plant.jpg",
    "price": 25.98
  }
]

Show Route

GET /plants/:id


Response Body
------
{
  "id": 1,
  "name": "Aloe",
  "image": "./images/aloe.jpg",
  "price": 11.50
}

Create Route

In your controller's create action, use strong params when creating the new Plant object.

POST /plants


Headers
-------
Content-Type: application/json


Request Body
------
{
  "name": "Aloe",
  "image": "./images/aloe.jpg",
  "price": 11.50
}


Response Body
-------
{
  "id": 1,
  "name": "Aloe",
  "image": "./images/aloe.jpg",
  "price": 11.50
}

Once all the tests are passing, start up the React app and explore the functionality to see how the routes you created are being used.