Tai yra Ruby metodai, kurie automatiškai generuoja getter ir/arba setter metodus instance kintamiesiems — išvengiant šabloninio kodo. Kadangi instance kintamieji (@name) yra privatus ir nėra tiesiogiai pasiekiami iš išorės, jums reikalingi accessor metodai jiems skaityti/rašyti, o attr_* juos generuoja glaustai.
()
= name
()
= value
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 → getter tik (tik skaitymo prieiga).attr_writer → setter tik (tik rašymo prieiga).attr_accessor → abu getter ir setter (skaitymo ir rašymo prieiga).Kiekvienas iš jų priima simbolius, pavadindančius instance kintamuosius, ir automatiškai generuoja atitinkamus metodus — viena eilutė pakeičia kelis rankiniu būdu parašytus metodo apibrėžimus.
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
Pasirinkti attr_reader (vietoj attr_accessor) laukas, kurie neturėtų būti keičiami savavališkai iš išorės, yra gera inkapsuliacija — rodote tik tą prieigą, kurią ketinate suteikti.
Supratimas apie attr_accessor/attr_reader/attr_writer yra fundamentali kasdienė Ruby žinias, nes jie pasirodo beveik kiekvioje Ruby klasėje.
Pagrindinis jų egzistavimo tikslas: instance kintamieji (@name) yra privatus ir nėra tiesiogiai pasiekiami iš objekto išorės, todėl jums reikalingi accessor metodai jiems skaityti arba rašyti — ir šių getter/setter metodų rankinis parašymas kiekvienam atributui yra nuobodus šabloninis kodas.
Šie metodai automatiškai generuoja accessor (attr_reader tik skaityti, attr_writer tik rašyti, attr_accessor abiem), pakeisdami kelis metodo apibrėžimus viena glausta eilute — tai yra Ruby elegantumo ir glaustuko ženklas.
Supratimas, ką generuoja kiekvienas iš jų ir pasirinkti tinkamą taip pat yra geros inkapsuliiacijos klausimas: attr_reader (tik skaitymas) naudojimas laukams, kurie neturėtų būti savavališkai keičiami iš išorės, ir attr_accessor tik ten, kur skaitymo ir rašymo prieiga yra tikrai numatyta, kontroliuoja, kaip objekto būsena yra rodoma (pvz., banko likutis yra skaitomas, bet keičiamas tik per kontroliuojamus metodus).
Kadangi šie accessor yra visur paplitę Ruby klasėse (ir Rails modeliuose), žinojimas, kaip jie veikia, ką kiekvienas generuoja ir kaip pasirinkti dėl tinkamos inkapsuliiacijos, yra esminė, privaloma Ruby klasių rašymo ir skaitymo žinias — tai vienas iš pirmų dalykų, su kuriais susiduriate apibrėždami Ruby klases, ir tai atspindi kalbos glaustų, išraiškingą požiūrį į bendrą poreikį (kontroliuojamą prieigą prie objekto būsenos).