Что делают attr_accessor, attr_reader и attr_writer?

Question

Accepted Answer

Это методы Ruby, которые **автоматически генерируют методы-геттеры и/или сеттеры** для переменных экземпляра — избавляя от шаблонного кода. Поскольку переменные экземпляра (`@name`) являются приватными и недоступны напрямую снаружи, вам нужны методы доступа для чтения/записи, а `attr_*` генерирует их лаконично.

## Проблема, которую они решают

```ruby
# ❌ without attr_* — manually writing getters/setters (tedious boilerplate)
class Person
  def initialize(name)
    @name = name
  end
  def name           # manual getter
    @name
  end
  def name=(value)   # manual setter
    @name = value
  end
end
```

## Три генератора доступа

```ruby
class Person
  attr_reader :name      # generates a GETTER only (read-only): person.name
  attr_writer :email     # generates a SETTER only (write-only): person.email = ...
  attr_accessor :age     # generates BOTH getter and setter: person.age / person.age = ...

def initialize(name, age)
    @name = name
    @age = age
  end
end

person = Person.new("Ann", 30)
person.name        # "Ann" — reader
person.age = 31     # writer
person.age          # 31 — reader
person.name = "X"   # ❌ NoMethodError — name is read-only (attr_reader, no setter)
```

- **`attr_reader`** → только геттер (доступ на чтение).
- **`attr_writer`** → только сеттер (доступ на запись).
- **`attr_accessor`** → оба: и геттер, и сеттер (доступ на чтение и запись).

Каждый принимает символы, называющие переменные экземпляра, и генерирует соответствующие методы автоматически — одна строка заменяет несколько ручных определений методов.

## Выбор правильного варианта (инкапсуляция)

```ruby
class BankAccount
  attr_reader :balance     # ✅ balance is readable but NOT directly settable (protect it)

def initialize
    @balance = 0
  end
  def deposit(amount)       # changes go through a controlled method, not a raw setter
    @balance += amount if amount > 0
  end
end
```

Выбор `attr_reader` (вместо `attr_accessor`) для полей, которые не должны устанавливаться произвольно снаружи, — это хорошая инкапсуляция — вы предоставляете только тот доступ, который намеревались.

## Почему это важно

Понимание `attr_accessor`/`attr_reader`/`attr_writer` — это фундаментальное, повседневное знание Ruby, поскольку они встречаются почти в каждом Ruby-классе.

Основная причина их существования: переменные экземпляра (`@name`) **являются приватными и не доступны напрямую** снаружи объекта, поэтому вам нужны методы доступа для чтения или записи — а написание этих геттеров/сеттеров вручную для каждого атрибута — это утомительный шаблонный код.

Эти методы **генерируют методы доступа автоматически** (`attr_reader` для доступа только на чтение, `attr_writer` для доступа только на запись, `attr_accessor` для обоих), заменяя несколько определений методов одной лаконичной строкой — это отличительная черта изящества и лаконичности Ruby.

Понимание того, что генерирует каждый из них, и **выбор подходящего** — это также вопрос хорошей **инкапсуляции**: использование `attr_reader` (только для чтения) для полей, которые не должны произвольно устанавливаться снаружи, и `attr_accessor` только там, где доступ на чтение-запись действительно предусмотрен, контролирует то, как состояние объекта предоставляется (например, сальдо банковского счёта можно читать, но изменять только через контролируемые методы).

Поскольку эти методы доступа встречаются повсеместно в Ruby-классах (и моделях Rails), знание того, как они работают, что генерирует каждый из них, и как выбрать для правильной инкапсуляции — это необходимое, обязательное знание для написания и чтения Ruby-классов — это одно из первых, с чем вы сталкиваетесь при определении Ruby-классов, и отражает лаконичный, выразительный подход языка к частой необходимости (контролируемый доступ к состоянию объекта).