Користувацькі валідації в Rails

Ruby on Rails — це потужний фреймворк для розробки веб-додатків, який надає безліч вбудованих можливостей для валідації даних. Однак, іноді стандартних валідацій недостатньо, і вам може знадобитися реалізувати власні, специфічні для вашого проекту. У цій статті ми розглянемо, як створювати користувацькі валідації в Rails, щоб забезпечити якість даних у вашій базі даних.

Що таке валідації в Rails?

Валідації в Rails — це механізм, який дозволяє перевіряти дані перед їх збереженням у базі даних. Вони допомагають запобігти збереженню некоректних або неповних даних, що може призвести до помилок у вашому додатку. Rails надає кілька вбудованих валідацій, таких як:

validates :name, presence: true — перевіряє, що поле не пусте.
validates :email, uniqueness: true — перевіряє, що значення унікальне.
validates :age, numericality: { only_integer: true } — перевіряє, що значення є цілим числом.

Однак, іноді вам потрібно реалізувати специфічні правила валідації, які не охоплюються стандартними методами. Ось тут і з'являються користувацькі валідації.

Створення користувацьких валідацій

Користувацькі валідації в Rails можна реалізувати кількома способами. Найпоширеніший метод — це використання методу validate у вашій моделі. Давайте розглянемо, як це зробити.

Приклад 1: Валідація на основі умов

Припустимо, у вас є модель User, і ви хочете перевірити, що вік користувача є дійсним лише для певних умов. Наприклад, якщо користувач є студентом, його вік повинен бути менше 30 років.

class User < ApplicationRecord
  validates :name, presence: true
  validates :email, presence: true, uniqueness: true
  validate :valid_age_for_student, if: :student?

  def student?
    role == 'student'
  end

  def valid_age_for_student
    if age.present? && age >= 30
      errors.add(:age, "для студентів вік повинен бути менше 30 років")
    end
  end
end

У цьому прикладі ми створили метод valid_age_for_student, який перевіряє, чи є вік користувача дійсним, якщо він є студентом. Якщо вік не відповідає умовам, ми додаємо повідомлення про помилку до об'єкта errors.

Приклад 2: Валідація на основі регулярних виразів

Інший приклад — це валідація формату електронної пошти. Хоча Rails має вбудовану валідацію для електронної пошти, ви можете захотіти реалізувати свою власну, використовуючи регулярні вирази.

class User < ApplicationRecord
  validates :email, presence: true
  validate :email_format

  def email_format
    unless email =~ /\A[\w+\-.]+@[a-z\d\-.]+\.[a-z]+\z/i
      errors.add(:email, "некоректний формат електронної пошти")
    end
  end
end

У цьому прикладі ми використовуємо регулярний вираз для перевірки формату електронної пошти. Якщо електронна пошта не відповідає формату, ми додаємо повідомлення про помилку.

Використання валідацій з блоками

Rails також дозволяє використовувати блоки для валідацій. Це може бути корисно, якщо вам потрібно перевірити кілька умов одночасно.

class User < ApplicationRecord
  validates :name, presence: true
  validates :email, presence: true, uniqueness: true
  validate do
    if age.present? && age < 18
      errors.add(:age, "користувач повинен бути старше 18 років")
    end
  end
end

У цьому прикладі ми використовуємо блок для перевірки, чи є вік користувача менше 18 років. Якщо так, ми додаємо повідомлення про помилку.

Користувацькі валідації з параметрами

Іноді вам може знадобитися передати параметри у вашу валідацію. Це можна зробити, використовуючи метод validate з параметрами.

class User < ApplicationRecord
  validates :name, presence: true
  validates :email, presence: true, uniqueness: true
  validate :age_within_range, if: :age_present?

  def age_within_range
    if age < 18 || age > 65
      errors.add(:age, "вік повинен бути в межах від 18 до 65 років")
    end
  end

  private

  def age_present?
    age.present?
  end
end

У цьому прикладі ми перевіряємо, чи є вік користувача в межах від 18 до 65 років. Якщо ні, ми додаємо повідомлення про помилку.

Валідації на рівні бази даних

Користувацькі валідації в Rails не замінюють валідації на рівні бази даних. Важливо також реалізувати валідації на рівні бази даних, щоб запобігти збереженню некоректних даних. Наприклад, ви можете використовувати унікальні обмеження для полів, які повинні бути унікальними.

class AddUniqueIndexToUsers < ActiveRecord::Migration[6.0]
  def change
    add_index :users, :email, unique: true
  end
end

У цьому прикладі ми додаємо унікальний індекс до поля email у таблиці users. Це забезпечить, що в базі даних не буде двох користувачів з однаковою електронною поштою.

Тестування валідацій

Тестування валідацій є важливою частиною процесу розробки. Ви можете використовувати фреймворк тестування, такий як RSpec або Minitest, для перевірки ваших валідацій.

require 'rails_helper'

RSpec.describe User, type: :model do
  it "is valid with valid attributes" do
    user = User.new(name: "John", email: "john@example.com", age: 25)
    expect(user).to be_valid
  end

  it "is not valid without a name" do
    user = User.new(name: nil)
    expect(user).to_not be_valid
  end

  it "is not valid with an invalid email format" do
    user = User.new(email: "invalid_email")
    expect(user).to_not be_valid
  end

  it "is not valid if age is less than 18" do
    user = User.new(age: 17)
    expect(user).to_not be_valid
  end
end

У цьому прикладі ми перевіряємо, чи модель User є дійсною з правильними атрибутами, а також перевіряємо різні випадки, коли модель не є дійсною.

Висновок

Користувацькі валідації в Rails — це потужний інструмент для забезпечення якості даних у вашій базі даних. Вони дозволяють вам реалізувати специфічні правила валідації, які відповідають потребам вашого проекту. Використовуючи методи validate, регулярні вирази, блоки та параметри, ви можете створити гнучкі та ефективні валідації.

Не забувайте також про важливість тестування ваших валідацій, щоб переконатися, що ваш додаток працює так, як очікується. Сподіваємося, що ця стаття допомогла вам зрозуміти, як реалізувати користувацькі валідації в Rails, і надихнула вас на створення якісних веб-додатків!