هذه هي طرق Ruby التي تولد تلقائياً طرق getter و/أو setter لمتغيرات النسخة — مما يلغي الكود المتكرر. بما أن متغيرات النسخة (@name) خاصة وغير قابلة للوصول المباشر من الخارج، فأنت بحاجة إلى طرق وصول لقراءة/كتابة البيانات، وattr_* يولد هذه الطرق بإيجاز.
()
= 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 فقط (وصول للقراءة فقط).attr_writer → setter فقط (وصول للكتابة فقط).attr_accessor → كل من getter و setter (وصول القراءة والكتابة).كل واحد منها يأخذ رموزاً تسمي متغيرات النسخة، ويولد الطرق المقابلة تلقائياً — سطر واحد يحل محل عدة تعريفات طرق يدوية.
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) خاصة وغير قابلة للوصول المباشر من خارج الكائن، لذا تحتاج إلى طرق وصول لقراءة أو كتابة البيانات — وكتابة تلك getters/setters يدوياً لكل خاصية هو كود متكرر مملل.
هذه الطرق تولد طرق الوصول تلقائياً (attr_reader للقراءة فقط، attr_writer للكتابة فقط، attr_accessor لكليهما)، مما يحل محل عدة تعريفات طرق بسطر واحد موجز — وهي سمة من سمات أناقة Ruby واختصارها.
فهم ما يولده كل واحد واختيار الواحد المناسب هو أيضاً مسألة تغليف جيد: استخدام attr_reader (القراءة فقط) للحقول التي لا يجب تعيينها بشكل عشوائي من الخارج، وattr_accessor فقط حيث يكون وصول القراءة والكتابة مقصوداً فعلاً، يتحكم في كيفية كشف حالة الكائن (مثل جعل رصيد البنك قابلاً للقراءة لكن قابلاً للتغيير فقط من خلال طرق مراقبة).
بما أن هذه طرق الوصول موجودة في كل مكان في فئات Ruby (ونماذج Rails)، فإن معرفة كيفية عملها، وما يولده كل واحد، وكيفية الاختيار لتحقيق التغليف المناسب هو معرفة أساسية وضرورية لكتابة وقراءة فئات Ruby — وهي من أول الأشياء التي تواجهها عند تعريف فئات Ruby وتعكس نهج اللغة الموجز والتعبيري لتلبية احتياج شائع (الوصول المراقب إلى حالة الكائن).