Jak stworzyć i używać modułu używając Ruby on Rails 3?

Używam Ruby on Rails 3 i chciałbym przenieść niestandardowy i współdzielony kod do modułu.

1. Jakiej składni powinienem użyć do napisania kodu modułu?
2. W którym folderze mojej aplikacji mam umieścić plik modułu?
3. Jak mam dołączyć ten moduł do jednej lub więcej klas kontrolerów?
4. Jakie inne czynności muszę wykonać, aby użyć modułu niestandardowego w dowolnym miejscu w mojej aplikacji?
5. Jak mogę wywołać metody w module z mojej aplikacji?

Z góry dziękuję.

Aby 1. Utworzyć / otworzyć moduł, mówiąc po prostu:

module MyModule
  def first_module_method
  end
end

Do 2. libfolderu. Jeśli chcesz uporządkować swoje moduły w libfolderze, możesz je same umieścić w modułach. Na przykład, jeśli chcesz mieć podfolder, super_modulesTwoje moduły będą zdefiniowane w następujący sposób:

module SuperModules
  module MyModule
    def first_module_method
    end
  end
end

Do 3./5. Włączając moduł do klasy, możesz po prostu wywołać metody modułów tak, jakby były zdefiniowane w klasie:

class MyClass
  include MyModule
  def some_method
    first_module_method #calls module method
  end
end

Do 4. Najpierw upewnij się, że Twój moduł jest naprawdę potrzebny w każdej klasie Twojej aplikacji. Jeśli nie jest, sensowne jest umieszczanie go tylko tam, gdzie jest to potrzebne, aby nie nadużywać klas, które i tak go nie potrzebują. Jeśli naprawdę chcesz, aby moduł był wszędzie, spójrz na hierarchię klas swoich klas w aplikacji. Czy chcesz mieć moduł we wszystkich modelach? Możesz otworzyć ActiveRecord :: Base i dodać tam swój moduł.

A> 1. Możesz użyć tej samej składni, co w przypadku każdej innej klasy ruby. Na przykład definiuję moduł VehicleClassifer, który będzie używał metody classify_vehicle do klasyfikowania pojazdu na podstawie liczby kół, które otrzyma jako dane wejściowe.

module VehicleClassifer
  def classify_vehicle(number_of_wheels)
    VehicleType.where("number_of_wheels = ?", number_of_wheels)
  end
end

A> 2. Moduły są zwykle przechowywane w folderze / lib.

pytania 3,4,5 mają mniej więcej taką samą odpowiedź. możesz użyć

class SomeController < ApplicationController
  include VehicleClassfier

  def index 
    classify_vehicle(4)  
  end
end

w klasie, w której używasz modułu, będziesz mieć dostęp do wszystkich metod modułu.

Ponadto, jeśli potrzebujesz użyć modułu w swojej aplikacji, możesz dołączyć go do kontrolera aplikacji.