включены

Обратный вызов вызывается всякий раз, когда получатель включен в другой модуль или класс.

Каждый разработчик Ruby знаком с #include , которое позволяет вам внедрять методы экземпляра модуля в класс. Точно так же, чтобы включить методы класса модуля, вы должны использовать #extend . Итак, если бы у вас был модуль с методами экземпляра и класса, вам нужно было бы сделать что-то вроде следующего, чтобы получить весь модуль в вашем классе:

	class MyClass
	include Mymodule # instance methods
	extend Mymodule # class methods
	end

view raw
gistfile1.rb
hosted with by GitHub

Это подводит нас к следующему хуку, который позволяет нам выполнять произвольный код всякий раз, когда модуль входит в класс. Он определен в модуле , и с его использованием связаны некоторые идиомы. Чтобы выполнить предыдущий пример, вы можете просто определить #included :

	module MyModule
	def self.included(base)
	base.extend(ClassMethods)
	end
	def hellofrominstance
	puts «hello from #{self}«
	end
	# Conventionally named ClassMethods
	module ClassMethods
	def hellofromclass
	puts «Hello from #{self}«
	end
	end
	end
	# including MyModule will call the hook (#included) which
	# extends the class methods
	class Blah
	include MyModule
	end
	pry(main)> Blah.hellofromclass
	#=> «Hello from Blah»
	pry(main)> Blah.new.hellofrominstance
	#=> «hello from #»

view raw
gistfile1.rb
hosted with by GitHub

Это только одно использование #included . Любой код может быть выполнен во включенном хуке, но это обычная идиома, которую вы увидите. Когда мы включили MyModule в класс Blah , мы увидели, как срабатывает ловушка, вызовы которой распространяются на «base». В этом случае аргумент «base» представляет текущее « self которое в конечном итоге становится Blah называется (да, мы поговорим о self в другом посте). Милый Бэтмен, верно?

расширенный

Я не буду вдаваться в подробности из-за его сходства с #included . Он будет запускать произвольный код при расширении модуля. По моему мнению, выполнение обратной (включенной) идиомы менее приемлемо. Тем не менее, я думаю, что это все еще удивительный инструмент. Полностью надуманный пример может выглядеть так:

	# execute this snippet
	module MyModule
	def self.extended(base)
	puts «Howdy!»
	end
	end
	class Blah
	extend MyModule
	end
	=> Howdy!
	=> Blah

view raw
gistfile1.rb
hosted with by GitHub

Если вы выполните приведенный выше фрагмент, вы увидите, что #extended когда Blah расширяет его. Довольно аккуратно. Двигаюсь дальше.

extend_object

Расширяет указанный объект, добавляя константы и методы этого модуля (которые добавляются как одноэлементные методы).

Когда вы вызываете Object # extension extension_object, вызывается обратный вызов. Это особенно полезно, когда вы хотите расширить объект, но только если у него есть определенные характеристики.

	module MyModule
	def self.extend_object(obj)
	puts «Hello from #{self}«
	super # important
	end
	def self.hello
	puts «Hello from #{self}«
	end
	end
	pry(main)> (myextendedstring = «blah»).extend(MyModule)
	#=> Hello from MyModule
	#=> «blah»
	pry(main)> s.hello
	#=> «Hello from blah»

view raw
gistfile1.rb
hosted with by GitHub

Это фактически расширит переменную my_extended_string , которая является строкой «blah», с MyModule.

const_missing

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

	class MyCustomError < StandardError; end
	# super terribad
	def Object.const_missing(name)
	raise MyCustomError, «You attempted to use a constant that wasn’t defined: #{name}«
	end
	pry(main)> WTF
	#=> MyCustomError: You attempted to use a constant that wasn’t defined: WTF from :3:in `const_missing’

view raw
gistfile1.rb
hosted with by GitHub

Выводы

Эти хуки часто используются в некоторых из самых умных частей Ruby-кода. Использование их может помочь вам написать лучший код. Кроме того, использование этих методов также поможет вам лучше понять, как Ruby выполняет / загружает / управляет каждой написанной вами программой.

В своем выступлении в 2007 году @pragdave объяснил некоторые причины, по которым расширение Ruby с помощью метапрограммирования является одной из основ языка. Он говорил о том, как метапрограммирование в Ruby поднимает уровень абстракции. По сути, это означает увеличение расстояния между машиной / языком и вашим кодом. Это хорошо по нескольким причинам. С одной стороны, код в конечном итоге выглядит гораздо более читабельным как для кодеров, так и для клиентов. Кроме того, после того, как заложен основной код, новый разработчик должен понимать меньше, чтобы иметь возможность внести свой вклад. Этот повышенный уровень абстракции является удивительной частью Ruby, и он широко представлен в некоторых из его крупнейших проектов (особенно в Rails). Я надеюсь, что вы обнаружите, что изучаете хуки, упомянутые выше, в своем собственном коде. Я уверен, что если вы это сделаете, вы начнете думать о Руби чуть более нежно. Спасибо за прочтение.

Это первое издание «Автостопом по метапрограммированию». В следующем выпуске будут рассмотрены основы метапрограммирования в Ruby. Узнайте больше о метапрограммировании в моем блоге, где я разместил несколько ссылок, которые я нашел полезными при написании этого поста. ^ _ ^