Dawn huma metodi Ruby li jiġġeneraw awtomatikament metodi getter u/jew setter għal varjabbli ta' istanza — u jeliminaw il-boilerplate. Billi l-varjabbli ta' istanza (@name) huma privati u mhux aċċessibbli direttament minn barra, għandek bżonn metodi accessor biex taqra/tikteb lilhom, u attr_* jiġġenerahahom b'mod kunċiż.
()
= 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 biss (aċċess read-only).attr_writer → setter biss (aċċess write-only).attr_accessor → kemm getter kif setter (aċċess read-write).Kull waħda tieħu simboli li jismu l-varjabbli ta' istanza, u tiġġenera l-metodi korrispondenti awtomatikament — linja waħda tissostitwixxi diversi definizzjonijiet ta' metodi manuali.
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
L-għażla ta' attr_reader (kontra attr_accessor) għal oqsma li m'għandhomx ikunu stabbiliti arbitrarjament minn barra hija encapsulation tajba — inti tesponi biss l-aċċess li tintendi.
L-għarfien ta' attr_accessor/attr_reader/attr_writer huwa għarfien fundamentali ta' kuljum f'Ruby, billi dawn jidħlu fi kważi kull klassi Ruby.
"><raġuni ewlenija għaliex jeżistu: varjabbli ta' istanza (@name) huma privati u mhux aċċessibbli direttament minn barra minn oġġett, allokwa għandek bżonn metodi accessor biex taqra jew tikteb lilhom — u kitba ta' dawk il-getters/setters manwalment għal kull attribut hija boilerplate tediosa.
Dawn il-metodi jiġġeneraw l-accessori awtomatikament (attr_reader għal read-only, attr_writer għal write-only, attr_accessor għall-iż-żewġ), u jissostitwixxi diversi definizzjonijiet ta' metodi b'linja waħda kunċiza — sennħa tal-eleganza u l-kunċizjoni ta' Ruby.
L-għarfien ta' x'inhu li kull waħda tiġġenera u l-għażla tal-aktar waħda approprjata hija wkoll kwistjoni ta' encapsulation tajba: l-użu ta' attr_reader (read-only) għal oqsma li m'għandhomx ikunu arbitrarjament imibdula minn barra, u attr_accessor biss fejn l-aċċess read-write huwa genuwinament intenzjonat, ikontrolja kif l-istat ta' oġġett jiġi esponiut (pereżempju, ġnar ta' bank li jinqara iżda jista' jinbidel biss minn ħlief metodi kontrollati).
Billi dawn l-accessori huma onnipreszenti fil-klassi Ruby (u mudelli ta' Rails), il-għarfien ta' kif jaħdmu, x'inhu li kull waħda tiġġenera, u kif tagħżel għal encapsulation xierqa hija għarfien essenzjali u li għandek bżonn taf, għal kitba u qari ta' klassi Ruby — huwa waħda mill-ewwel ħagħat li tiltaqa' magħha meta tiddefinixxi klassi Ruby u jirrifletti l-approċċ tal-lingwa ta' kunċiza u espressiva għal ħtieġa komuni (aċċess kontrollat għall-istat ta' oġġett).