Value Object in Ruby

May 4, 2015 · 2 min read

Perhaps you already stumbled upon a piece of code like this:

class ReportCard
attr_accessor :grades
def initialize(attributes = {})
@scores = attributes[:scores]
@grades ||= grade_scores
private def grade_scores do |score|
def grade_score(score)
if score < 60
elsif score < 70
elsif score < 80
elsif score < 90

Grade Score is something that stores some values, maybe those values are not persisted in any database, maybe we're just using these values in our business logic. Normally they are simple objects which are used widely. Value Objects may be Dates, MoneyCurrency, strings, etc.

Let's try to define what a value object is:

A small simple object, like money or a date range, whose equality isn’t based on identity. — Martin Fowler

Now we know how to discover a value object in our code and some possible definitions.

Why value objects are important?

Maybe the question should be: when should I use value objects? Or even, when should I extract value objects from my code?

In the code above we have the Grade Score code as value object and I certainly should extract that and put it in a new ruby class file or module named GradeScore or something like that.

There are some important facts we should take attention related to value objects, they are:

  • Value objects normally have multiple attributes
  • Attributes should be immutable through its life cycle
  • Equality is determined by its attributes and not related to the memory address.

Probably using Value Objects might inspire you to write a more neat code?

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch

Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore

Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store