Last updated on December 20, 2021
If you want to either retrieve or set a value of an instance variable from a Ruby class, you need to learn about getters and setters. Learning about attr_accessor is also really useful to help you keep your class clean and tidy.
If you want to learn about Ruby classes, you can read about the basics in this article
Getter methods help you retrieve the value of an instance variable. If you don’t have a getter method, trying to retrieve a variable is going to result in an error.
class Company def initialize(name) @name = name end end company = Company.new("The Bluth Company") p company.name # => undefined method `name' for #<Company:0x00007fe25f021b30> (NoMethodError)
Let’s include a getter method
class Company # ... # Getter def name @name end end company = Company.new("The Bluth Company") p company.name # => "The Bluth Company"
Setter methods help us assign new values to our instance variables. Let see what happens if you don’t have a setter method and you try to assign a new value to your instance variable
class Company def initialize(name) @name = name end # Getter def name @name end end company = Company.new("The Bluth Company") p company.name # => "The Bluth Company" company.name = "Dunder Mifflin" # => undefined method `name=' for #<Company:0x00007fdd680f50f8 @name="The Bluth Company"> (NoMethodError)
So let’s create a setter method
class Company # ... # Setter def name=(name) @name = name end end # ... company.name = "Dunder Mifflin" # => "Dunder Mifflin"
You can see how classes can become quite big with having to define 2 methods for every instance variable. That’s why we have access to 3 build-in Ruby methods:
class Company attr_reader :name attr_writer :name def initialize(name) @name = name end end company = Company.new("The Bluth Company") p company.name # => "The Bluth Company" company.name = "Dunder Mifflin" p company.name # =>"Dunder Mifflin"
When you want both
attr_writer, just use:
You can define multiple attributes on the same line, which will generate the relevant methods
attr_accessor :name, :email, :address
By the way, you can get a list of your instance variables using the built-in
#instance_variables method and a list of your class methods using
class User attr_accessor :name attr_accessor :age def initialize(name, age) @name = name @age = age end end user = User.new("Kris", 24) p user.instance_variables # => [:@name, :@age] p user.public_methods # => [:age, :age=, :name, :name=]
Sometimes you might want to combine your attribute accessor methods depending on your variables. For example, you might want to read and write the email variable but only read the id variable.
attr_accessor :name attr_reader :id
At its core, a Rails model is just a Ruby class. The model attributes are defined using attr_accessor under the hood, but Rails automatically does it for us in order to keep our models tidy.
However, if you want to add an attribute that is not defined in the model’s table, you can define it manually using attr_accessor. This will create a non-persistent instance variable.
# models/customer.rb class Customer # ... attr_accessor :password_token end
These non-persistent instance variables are useful in cases when you only need the variable for a limited time or you don’t need to store it in your database.
Articles, guides and interviews about web development and career progression.
Max 1-2x times per month.