ActiveRecord Associations in Sinatra
Objectives
- Understand primary and foreign key.
- Understand the has many/ belongs to relationship.
Introduction
Previously, we learned about foreign and primary keys in SQL and how they relate tables to one another. In this lesson, we're going to learn how to do this using ActiveRecord. This lab has pre-written code that you can follow along with - feel free to fork and clone the repo locally.
Primary Keys
The end goal of this readme is to create a relationship in our app that mimics the real life cat-owner relationship: owners can have many cats and cats belong to an owner. Let's assume we have two tables in our database: cats
and owners
, which we created from the command line using rake.
Review: Creating a table with ActiveRecord
First, we create a cats table from the command line:
rake db:create_migration NAME="create_cats"
This will give us an empty migration in our db/migrate/
folder. Now lets give our cats table attributes: name
, age
and breed
. This will go into our change
method.
class CreateCats < ActiveRecord::Base
def change
create_table :cats do |t|
t.string :name
t.integer :age
t.string :breed
end
end
end
Review: Primary Keys
A primary key uniquely identifies each record in a table. It must be unique and cannot have NULL values. Luckily, ActiveRecord will create the primary key for us and will also auto-increment it every time we save a new row in our table.
Go ahead and use Tux to create three instances of the Cat class:
Cat.create(:name => "Maru", :age => 3, :breed => "Scottish Fold")
Cat.create(:name => "Hannah", :age => 2, :breed => "Tabby")
Cat.create(:name => "Patches", :age => 2, :breed => "Calico")
And two instances of our Owner class:
Owner.create(:name => "Sophie")
Owner.create(:name => "Ann")
Our cats
table looks like this:
id | name | age | breed |
---|---|---|---|
1 | Maru | 3 | Scottish Fold |
2 | Hannah | 2 | Tabby |
3 | Patches | 2 | Calico |
Our owners
table looks like this:
id | name |
---|---|
1 | Sophie |
2 | Ann |
Now, we need to tell our tables how to relate to each other. This is where we'll use a foreign key.
Using Foreign Keys
A foreign key points to a primary key in another table. In ActiveRecord we will use the tablename_id
convention. To add the foreign key to our cats table, we will create another migration.
The foreign key always sits on the table of the object that belongs to. In this case, because cats belong to an owner, the owner_id becomes a column in the cats table.
class AddColumnToCats < ActiveRecord::Base
def change
add_column :cats, :owner_id, :integer
end
end
Our cats
table should look like this:
id | name | age | breed | owner_id |
---|---|---|---|---|
1 | Maru | 3 | Scottish Fold | 1 |
2 | Hannah | 2 | Tabby | 2 |
3 | Patches | 2 | Calico | 1 |
We now know what our table should look like. However, we haven't told our application how to relate the models to each other.
belongs_to
and has_many
Before we write our association let's think about our table structure: A cat belongs to an owner, and an owner can have many cats.
This translates into ruby like this:
class Cat
belongs_to :owner
end
class Owner
has_many :cats
end
Whenever we use a has_many
we also have to use the belongs_to
(and vice-versa) in the other model. Keep in mind: The model with the belongs_to
association also has the foreign key.
Creating objects
After setting our associations, we can create a cat and an owner and save them to our database. Try using Tux to play around. Create objects, view them, edit them, delete them!
sophie = Owner.create(name: "Sophie")
maru = Cat.new(name: "Maru", age: 3, breed: "Scottish Fold")
maru.owner = sophie
maru.save
We used the .create
method to instantiate and save the owner to our database. To instantiate the cat object we used the .new
method, after that we set "Maru's" owner to the owner we created. Because the .new
method did not save the cat object to our database the last line will persist the cat object to our database.
The has_many
/belongs_to
relationship is the most used association, but there are others as well. You can read more about ActiveRecord Associations here.
View ActiveRecord Associations in Sinatra on Learn.co and start learning to code for free.