Form object pattern in Ruby on Rails - Step-by-Step Execution

Concept Flow - Form object pattern

User submits form data

↓

Form Object receives data

↓

Validate data in Form Object

↓

Save or update

↓

Update underlying models

↓

Return success or failure

The form object receives user input, validates it, and if valid, updates one or more models; otherwise, it returns errors.

Execution Sample

Ruby on Rails

class SignupForm
  include ActiveModel::Model
  attr_accessor :email, :password

  validates :email, presence: true, format: { with: /\A[^@\s]+@[^@\s]+\z/ }
  validates :password, presence: true, length: { minimum: 6 }

  def save
    return false unless valid?
    User.create(email: email, password: password)
  end
end

This form object collects email and password, validates them, and creates a User if valid.

Execution Table

Step	Action	Input Data	Validation Result	Model Interaction	Output
1	Initialize SignupForm	{email: '[e-mail]', password: 'secret'}	N/A	N/A	Form object created with data
2	Call save method	Form data present	Check validations	N/A	Validations run
3	Validation passes?	email and password valid	Yes	N/A	Proceed to create User
4	Create User model	email and password	N/A	User record created	User instance returned
5	Return from save	User created	N/A	N/A	User instance returned
6	If validation failed	invalid data	No	N/A	Return false and errors

💡 Execution stops after save returns user instance or false depending on validation and model creation

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 4	Final
email	nil	'[e-mail]'	'[e-mail]'	'[e-mail]'	'[e-mail]'
password	nil	'secret'	'secret'	'secret'	'secret'
valid?	N/A	N/A	true	true	true
User instance	nil	nil	nil	User object created	User object created
save return	nil	nil	nil	User object created	User object created

Key Moments - 3 Insights

Why does the form object validate data before creating the User?

The form object runs validations first (see step 3 in execution_table). If validations fail, it stops and returns errors without creating a User (step 6). This prevents bad data from saving.

How does the form object handle multiple models?

Though this example shows one model, the form object can update many models inside the save method after validation (step 4). It acts as a coordinator for complex form data.

What happens if save returns false?

If validations fail, save returns false (step 6). The controller or caller can then show errors to the user without saving anything.

Visual Quiz - 3 Questions

Look at the execution_table at step 3, what happens if validation fails?

A The User model is created anyway

B The form object retries validation

C The save method returns false and stops

D The form object ignores errors

💡 Hint

Check step 6 in execution_table where validation fails and save returns false

According to variable_tracker, what is the value of 'valid?' after step 2?

A true

B false

C nil

D undefined

💡 Hint

Look at the 'valid?' row under 'After Step 2' column in variable_tracker

If the form object handled two models, how would the execution_table change?

A Validation would be skipped

B There would be multiple model creation steps after validation

C The form object would not return any output

D The form object would only update one model

💡 Hint

Refer to key_moments about handling multiple models inside save method

Concept Snapshot

Form Object Pattern in Rails:
- Create a plain Ruby class including ActiveModel::Model
- Define attributes with attr_accessor
- Add validations inside the form object
- Implement a save method that validates and updates one or more models
- Returns true on success, false on failure with errors
- Helps manage complex forms involving multiple models cleanly

Full Transcript

The Form Object pattern in Rails helps manage complex form data by creating a separate class that collects input, validates it, and updates one or more models. When a user submits a form, the form object receives the data and runs validations. If the data is valid, it creates or updates the underlying models and returns success. If not, it returns errors without saving. This pattern keeps controllers and models simpler by moving form logic into its own object. The example shows a SignupForm class that takes email and password, validates them, and creates a User if valid. The execution table traces each step from initialization, validation, model creation, to returning success or failure. Variable tracking shows how data changes through the process. Key moments clarify why validation happens first, how multiple models can be handled, and what happens on failure. The visual quiz tests understanding of validation flow, variable states, and handling multiple models. This pattern improves code organization and makes complex forms easier to maintain.