ruby ​​module_function vs modülü dahil

Question

Yakutta, modül işlevlerinin burada gösterildiği gibi module_function'u kullanarak modülde karıştırma olmadan kullanılabilir olduğunu anlıyorum. Bunun nasıl faydalı olduğunu görebiliyorum, böylece modülde karıştırma olmadan fonksiyonu kullanabilirsiniz.

module MyModule 
    def do_something 
    puts "hello world" 
    end 
    module_function :do_something 
end 

Sorglum, neden bu iki yolun her ikisini de tanımladığınıza sahip olmak isteyebilirsiniz.

Neden sadece

def MyModule.do_something 

YA durumlarda ne tür yılında

def do_something 

o karışık olması kullanılabilir işlevi olması veya statik bir yöntem olarak kullanılabilir faydalı olacaktır sahip ?

Answer 1

Enumerable'u düşünün.

Bu, bir modülde ne zaman eklemeniz gerektiğine dair mükemmel bir örnektir. Sınıfınız #each'u tanımlarsa, bir modül ekleyerek (#map, #select, vb.) Çok fazla iyilik elde edersiniz. Modülleri miks olarak kullandığım tek durum budur - modül, modülde dahil ettiğiniz sınıfta tanımlanan birkaç yöntem açısından işlevsellik sağlar. Bunun genel olarak tek durum olması gerektiğini söyleyebilirim. "Statik" yöntemleri tanımlayan gelince

, daha iyi bir yaklaşım olacaktır:

module MyModule 
    def self.do_something 
    end 
end 

Gerçekten #module_function aramaya gerek yoktur. Bence sadece tuhaf eski şeyler.

module MyModule 
    extend self 

    def do_something 
    end 
end 

... ama aynı zamanda bir yere modülü dahil etmek istiyorsanız iyi çalışmaz:

Hatta yapabilirsiniz. Ruby meta programlamasının inceliklerini öğrenene kadar bundan kaçınmanızı öneriyorum.

Son olarak, sadece yaparsanız:

def do_something 
end 

... küresel bir fonksiyonu olarak sona olmayacak, ama Object özel bir yöntem olarak (hayır fonksiyonlar, Ruby sadece yöntem vardır). İki olumsuz taraf var. İlk olarak, ad boşluğuna sahip değilsiniz - aynı ada sahip başka bir işlev tanımlarsanız, daha sonra değerlendirdiğiniz kişi budur. İkincisi, #method_missing açısından uygulanan bir işlevselliğe sahipseniz, Object'da özel bir yönteme sahip olmak onu gölgeleyecektir. Ve son olarak, Object yama maymunvari kötü iş :) olduğunu

DÜZENLEME:

module_functionprivate benzer bir şekilde kullanılabilir:

module Something 
    def foo 
    puts 'foo' 
    end 

    module_function 

    def bar 
    puts 'bar' 
    end 
end 

Bu şekilde, Something.bar çağırabilir, ancak Something.foo değil. Bu çağrıdan sonra module_function'a başka herhangi bir yöntem tanımlarsanız, bunlar karıştırılmadan da kullanılabilirlerdi.

İki nedenden dolayı beğenmiyorum.İlk olarak, hem karışık hem de "statik" yöntemlere sahip olan modüller biraz tehlikeli geliyor. Geçerli davalar olabilir, ama o kadar sık ​​olmayacak. Dediğim gibi, bir modülü bir ad alanı olarak kullanmayı veya karıştırmayı tercih ediyorum, ancak ikisini de değil. Bu örnekte bar,İkinci olarak, bu örnekte Something'da bulunan sınıflar/modüller için kullanılabilir. Yöntemin, self'u kullandığı ve karıştırılmasının gerekip gerekmediği ve karıştırılmasının gerekmediğinden emin olamadığımdan emin değilim.

module_function'u kullanmadan kullanmayı düşünüyorum. Yöntemin adı ile çok daha sık kullanılır. Aynı şey private ve protected için geçerlidir.

Answer 2

Bir Ruby kütüphanesinin dahili durumu (fazla) kullanmayan işlevler sunması iyi bir yoldur. Yani (örneğin) bir sin işlevini sunmak istiyorsanız ve "global" (Object) ad alanını kirletmek istemiyorsanız, onu bir sabit (Math) altında sınıf yöntemi olarak tanımlayabilirsiniz. Bununla birlikte, matematiksel bir uygulama yazmak isteyen bir uygulama geliştiricisi, her iki satıra da sin gerekebilir. Yöntem aynı zamanda bir yöntem ise, yalnızca Math (veya My::Awesome::Nested::Library) modülünü ekleyebilir ve artık doğrudan sin (stdlib örneği) olarak adlandırılabilir.

Kitaplığı, kullanıcıları için daha rahat bir hale getirmekle ilgilidir. Kütüphanenizin işlevselliğini en üst düzeyde istiyorlarsa, kendileri seçebilirler.

Bu arada, module_function gibi benzer bir işlevsellik kullanarak aşağıdakileri gerçekleştirebilirsiniz: extend self (modülün ilk satırında). Zihnime göre, daha iyi görünüyor ve anlamak için işleri biraz daha netleştiriyor.

Güncelleme:this blog article. Eğer bir çalışma örneği inceleyelim kronik gem kontrol etmek istiyorsanız

Answer 3

:

https://github.com/mojombo/chronic/blob/master/lib/chronic/parser.rb

O açıklanmıştır:

https://github.com/mojombo/chronic/blob/master/lib/chronic/handlers.rb

ve Tutucular burada Ayrıştırıcı sınıfına dahil ediliyor İşleyicilerinden, Handler öğesinin belirli örneklerine bu örneğin invoke yöntemini kullanarak göndermek için module_function yöntemini kullanma.