Como criar e usar um módulo usando Ruby on Rails 3?

Estou usando Ruby on Rails 3 e gostaria de mover algum código personalizado e compartilhado em um módulo.

1. Qual sintaxe devo usar para escrever o código do módulo?
2. Em qual pasta do meu aplicativo devo colocar o arquivo do módulo?
3. Como devo incluir esse módulo em uma ou mais classes de controlador?
4. Que outra ação, se houver, devo usar o módulo personalizado em qualquer lugar do meu aplicativo?
5. Como posso chamar métodos no módulo de meu aplicativo?

Desde já, obrigado.

Para 1. Um módulo é criado / aberto simplesmente dizendo:

module MyModule
  def first_module_method
  end
end

Para 2. A libpasta. Se você deseja organizar seus módulos na libpasta, pode colocá-los nos próprios módulos. Por exemplo, se você quiser uma subpasta, super_modulesseus módulos serão definidos da seguinte forma:

module SuperModules
  module MyModule
    def first_module_method
    end
  end
end

Para 3./5. Ao incluir o módulo em uma classe, você pode simplesmente chamar os métodos dos módulos como se fossem definidos na classe:

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

Para 4. Primeiro, certifique-se de que seu módulo seja realmente necessário em todas as classes de seu aplicativo. Caso contrário, faz sentido incluí-lo apenas onde for necessário para não sobrecarregar as classes que não precisam dele de qualquer maneira. Se você realmente deseja o módulo em todos os lugares, inclua uma olhada na hierarquia de classes de suas classes no aplicativo. Você quer o módulo em todos os modelos? Você pode abrir ActiveRecord :: Base e adicionar seu módulo lá.

A> 1. Você pode usar a mesma sintaxe de qualquer outra classe ruby. Por exemplo, estou definindo um módulo VehicleClassifer que vai usar o método classify_vehicle para classificar um veículo com base no número de rodas que ele recebe como entrada.

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

A> 2. Os módulos geralmente são armazenados na pasta / lib.

as questões 3,4,5 têm mais ou menos a mesma resposta. você pode usar

class SomeController < ApplicationController
  include VehicleClassfier

  def index 
    classify_vehicle(4)  
  end
end

na aula você está usando o módulo e terá acesso a todos os métodos do módulo.

Além disso, caso precise usar um módulo em todo o seu aplicativo, você pode incluí-lo no controlador de aplicativo.