Çfarë bëjnë attr_accessor, attr_reader dhe attr_writer?

Question

Accepted Answer

Këto janë metoda Ruby që **gjenerohen automatikisht getter dhe/ose setter methods** për variablat e instancës — duke eleminuar kodin e përsëritur. Meqenëse variablat e instancës (`@name`) janë private dhe nuk janë drejtpërdrejtë të arritshëm nga jashtë, ju keni nevojë për metoda aksesori për t'i lexuar/shkruar ato, dhe `attr_*` i gjeneron këto në mënyrë të përgjithësuar.

## Problemi që ato zgjidhin

```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
```

## Tre gjeneratorët e aksesit

```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`** → vetëm getter (qasje leximi).
- **`attr_writer`** → vetëm setter (qasje shkrimi).
- **`attr_accessor`** → si getter ashtu edhe setter (qasje lexim-shkrim).

Secili merr simbole që emërojnë variablat e instancës, dhe gjeneron metodat përkatëse automatikisht — një rresht zëvendëson disa përkufizime manuale të metodës.

## Zgjedhja e asaj të duhur (enkapsulim)

```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
```

Zgjedhja e `attr_reader` (kundrejt `attr_accessor`) për fusha që nuk duhet të vendosen në mënyrë arbitrare nga jashtë është enkapsulim i mirë — duke ekspozuar vetëm qasjen që ju synoni.

## Pse ka rëndësi

Kuptimi i `attr_accessor`/`attr_reader`/`attr_writer` është njohuri themelore e përditshme Ruby, meqenëse ato shfaqen në pothuajse çdo klasë Ruby.

Arsenali themelor pse ekzistojnë: variablat e instancës (`@name`) janë **private dhe nuk janë drejtpërdrejtë të arritshëm** nga jashtë një objekti, kështu që ju keni nevojë për metoda aksesori për t'i lexuar ose shkruar ato — dhe shkruajta ato getters/setters manualisht për çdo atribut është kod i lodhshëm i përsëritur.

Këto metoda **gjenerohen aksesori automatikisht** (`attr_reader` për vetëm-lexim, `attr_writer` për vetëm-shkrim, `attr_accessor` për të dyja), duke zëvendësuar disa përkufizime metodash me një rresht të përgjithësuar — një shenjë e elegancës dhe të përgjithësuarës së Ruby.

Kuptimi se çfarë gjeneron secila dhe **zgjedhja e asaj të duhur** është gjithashtu çështje e mirë **enkapsulimi**: përdorimi i `attr_reader` (vetëm-lexim) për fusha që nuk duhet të ndryshohen në mënyrë arbitrare nga jashtë, dhe `attr_accessor` vetëm aty ku qasja lexim-shkrim është vërtet e synuar, kontrollon se si zbulohet gjendja e objektit (p.sh. duke bërë një bilanc banka të lexueshëm por të ndryshueshëm vetëm përmes metodash të kontrolluar).

Meqenëse këta aksesori janë të përhapur në klasat Ruby (dhe Rails models), të ditur se si funksionojnë, çfarë gjeneron secila, dhe si të zgjedhin për enkapsulim të duhur është thelbësor, njohuri që duhet të dini për të shkruar dhe lexuar klasat Ruby — është një nga gjërat e para që hasni kur përkufizoni klasat Ruby dhe pasqyron qasjen e gjuhës, të shprehur ndaj një nevojë të zakonshme (qasja e kontrolluar në gjendjen e objektit).