Question Comment utiliser les préoccupations dans Rails 4


Le générateur de projet Rails 4 par défaut crée maintenant le répertoire "préoccupations" sous les contrôleurs et les modèles. J'ai trouvé quelques explications sur la façon d'utiliser les problèmes de routage, mais rien sur les contrôleurs ou les modèles.

Je suis assez sûr que cela a à voir avec la "tendance DCI" actuelle dans la communauté et je voudrais essayer.

La question est: comment suis-je supposé utiliser cette fonctionnalité, y a-t-il une convention sur la façon de définir la hiérarchie de nommage / classe pour la faire fonctionner? Comment puis-je inclure une préoccupation dans un modèle ou un contrôleur?


578
2018-01-26 21:36


origine


Réponses:


Donc je l'ai trouvé par moi-même. C'est en fait un concept assez simple mais puissant. Cela a à voir avec la réutilisation du code comme dans l'exemple ci-dessous. Fondamentalement, l'idée est d'extraire des morceaux de code communs et / ou spécifiques au contexte afin de nettoyer les modèles et d'éviter qu'ils deviennent trop gros et salissants.

Par exemple, je vais mettre un modèle bien connu, le modèle taggable:

# app/models/product.rb
class Product
  include Taggable

  ...
end

# app/models/concerns/taggable.rb
# notice that the file name has to match the module name 
# (applying Rails conventions for autoloading)
module Taggable
  extend ActiveSupport::Concern

  included do
    has_many :taggings, as: :taggable
    has_many :tags, through: :taggings

    class_attribute :tag_limit
  end

  def tags_string
    tags.map(&:name).join(', ')
  end

  def tags_string=(tag_string)
    tag_names = tag_string.to_s.split(', ')

    tag_names.each do |tag_name|
      tags.build(name: tag_name)
    end
  end

  # methods defined here are going to extend the class, not the instance of it
  module ClassMethods

    def tag_limit(value)
      self.tag_limit_value = value
    end

  end

end

Ainsi, en suivant l'exemple de produit, vous pouvez ajouter Taggable à n'importe quelle classe que vous désirez et partager ses fonctionnalités.

Ceci est assez bien expliqué par DHP:

Dans Rails 4, nous allons inviter les programmeurs à utiliser les   applications / modèles / préoccupations par défaut et app / contrôleurs / répertoires de préoccupations   qui font automatiquement partie du chemin de chargement. Avec la   ActiveSupport :: Concern wrapper, c'est juste assez de support pour faire cela   éclat de mécanisme d'affacturage léger.


578
2018-02-25 22:50



J'ai lu à propos de l'utilisation préoccupations de modèle pour skin-nize les modèles de graisse ainsi que sécher vos codes de modèle. Voici une explication avec des exemples:

1) Séchage des codes modèles

Considérons un modèle d'article, un modèle d'événement et un modèle de commentaire. Un article ou un événement a beaucoup de commentaires. Un commentaire appartient à un article ou un événement.

Traditionnellement, les modèles peuvent ressembler à ceci:

Modèle de commentaire:

class Comment < ActiveRecord::Base
  belongs_to :commentable, polymorphic: true
end

Modèle d'article:

class Article < ActiveRecord::Base
  has_many :comments, as: :commentable 

  def find_first_comment
    comments.first(created_at DESC)
  end

  def self.least_commented
   #return the article with least number of comments
  end
end

Modèle d'événement

class Event < ActiveRecord::Base
  has_many :comments, as: :commentable 

  def find_first_comment
    comments.first(created_at DESC)
  end

  def self.least_commented
   #returns the event with least number of comments
  end
end

Comme nous pouvons le remarquer, il y a un morceau significatif de code commun à la fois à l'événement et à l'article. En utilisant les préoccupations, nous pouvons extraire ce code commun dans un module séparé Commentable.

Pour cela créez un fichier commentable.rb dans app / models / concerns.

module Commentable
  extend ActiveSupport::Concern

  included do
    has_many :comments, as: :commentable
  end

  # for the given article/event returns the first comment
  def find_first_comment
    comments.first(created_at DESC)
  end

  module ClassMethods
    def least_commented
      #returns the article/event which has the least number of comments
    end
  end
end

Et maintenant vos modèles ressemblent à ceci:

Modèle de commentaire:

class Comment < ActiveRecord::Base
  belongs_to :commentable, polymorphic: true
end

Modèle d'article:

class Article < ActiveRecord::Base
  include Commentable
end

Modèle d'événement:

class Event < ActiveRecord::Base
  include Commentable
end

2) modèles de graisse de nidation de peau.

Considérez un modèle d'événement. Un événement a de nombreux participants et commentaires.

En règle générale, le modèle d'événement peut ressembler à ceci

class Event < ActiveRecord::Base   
  has_many :comments
  has_many :attenders


  def find_first_comment
    # for the given article/event returns the first comment
  end

  def find_comments_with_word(word)
    # for the given event returns an array of comments which contain the given word
  end 

  def self.least_commented
    # finds the event which has the least number of comments
  end

  def self.most_attended
    # returns the event with most number of attendes
  end

  def has_attendee(attendee_id)
    # returns true if the event has the mentioned attendee
  end
end

Les modèles avec de nombreuses associations et autrement ont tendance à accumuler de plus en plus de code et deviennent ingérables. Les préoccupations fournissent un moyen de skin-nize modules de graisse, ce qui les rend plus modulaire et facile à comprendre.

Le modèle ci-dessus peut être refactorisé en utilisant les préoccupations ci-dessous: Créer un attendable.rb et commentable.rb fichier dans le dossier app / models / concerns / event

attenable.rb

module Attendable
  extend ActiveSupport::Concern

  included do 
    has_many :attenders
  end

  def has_attender(attender_id)
    # returns true if the event has the mentioned attendee
  end

  module ClassMethods
    def most_attended
      # returns the event with most number of attendes
    end
  end
end

commentable.rb

module Commentable
  extend ActiveSupport::Concern

  included do 
    has_many :comments
  end

  def find_first_comment
    # for the given article/event returns the first comment
  end

  def find_comments_with_word(word)
    # for the given event returns an array of comments which contain the given word
  end

  module ClassMethods
    def least_commented
      # finds the event which has the least number of comments
    end
  end
end

Et maintenant en utilisant Concerns, votre modèle d'événement réduit à

class Event < ActiveRecord::Base
  include Commentable
  include Attendable
end

* Lors de l'utilisation, il est conseillé d'opter pour un regroupement basé sur le domaine plutôt que pour un groupement "technique". Le regroupement basé sur un domaine est similaire à 'Commentable', 'Photoable', 'Attendable'. Le regroupement technique signifiera «ValidationMethods», «FinderMethods», etc.


349
2017-09-15 22:50



Il vaut la peine de mentionner que l'utilisation de préoccupations est considérée comme une mauvaise idée par beaucoup.

  1. comme ce mec
  2. et celui-là

Certaines raisons:

  1. Il y a de la magie noire qui se passe dans les coulisses - Concern est en train de patcher include méthode, il y a tout un système de gestion des dépendances - beaucoup trop de complexité pour quelque chose qui est trivial bon vieux modèle Rubin Mixin.
  2. Vos cours ne sont pas moins secs. Si vous mettez 50 méthodes publiques dans différents modules et les incluez, votre classe a toujours 50 méthodes publiques, c'est juste que vous cachez l'odeur du code, sorte de mettre vos ordures dans les tiroirs.
  3. Codebase est en fait plus difficile à naviguer avec toutes ces préoccupations autour.
  4. Êtes-vous sûr que tous les membres de votre équipe ont la même compréhension de ce qui devrait vraiment remplacer la préoccupation?

Les soucis sont un moyen facile de se tirer une balle dans la jambe, faites attention avec eux.


86
2018-03-23 14:11



Ce post m'a aidé à comprendre les préoccupations.

# app/models/trader.rb
class Trader
  include Shared::Schedule
end

# app/models/concerns/shared/schedule.rb
module Shared::Schedule
  extend ActiveSupport::Concern
  ...
end

55
2018-03-17 19:20



J'ai ressenti la plupart des exemples ici démontrant le pouvoir de module plutôt que comment ActiveSupport::Concern ajoute de la valeur à module.

Exemple 1: Des modules plus lisibles.

Donc, sans se soucier de cette façon typique module sera.

module M
  def self.included(base)
    base.extend ClassMethods
    base.class_eval do
      scope :disabled, -> { where(disabled: true) }
    end
  end

  def instance_method
    ...
  end

  module ClassMethods
    ...
  end
end

Après refactoring avec ActiveSupport::Concern.

require 'active_support/concern'

module M
  extend ActiveSupport::Concern

  included do
    scope :disabled, -> { where(disabled: true) }
  end

  class_methods do
    ...
  end

  def instance_method
    ...
  end
end

Vous voyez les méthodes d'instance, les méthodes de classe et le bloc inclus sont moins salissants. Les préoccupations les injecteront de manière appropriée pour vous. Thats un avantage d'utiliser ActiveSupport::Concern.


Exemple 2: Gérez les dépendances du module avec élégance.

module Foo
  def self.included(base)
    base.class_eval do
      def self.method_injected_by_foo_to_host_klass
        ...
      end
    end
  end
end

module Bar
  def self.included(base)
    base.method_injected_by_foo_to_host_klass
  end
end

class Host
  include Foo # We need to include this dependency for Bar
  include Bar # Bar is the module that Host really needs
end

Dans cet exemple Bar est le module qui Host a vraiment besoin. Mais depuis Bar a une dépendance avec Foo la Host classe doit include Foo (mais attendez pourquoi Host veux savoir sur Foo ? peut-il être évité?).

Alors Bar ajoute la dépendance partout où ça va. Et l'ordre d'inclusion compte également ici. Cela ajoute beaucoup de complexité / dépendance à l'énorme base de code.

Après refactoring avec ActiveSupport::Concern

require 'active_support/concern'

module Foo
  extend ActiveSupport::Concern
  included do
    def self.method_injected_by_foo_to_host_klass
      ...
    end
  end
end

module Bar
  extend ActiveSupport::Concern
  include Foo

  included do
    self.method_injected_by_foo_to_host_klass
  end
end

class Host
  include Bar # It works, now Bar takes care of its dependencies
end

Maintenant, cela semble simple.

Si vous pensez pourquoi ne pouvons-nous ajouter Foo dépendance dans Bar module lui-même? Cela ne marchera pas depuis method_injected_by_foo_to_host_klass doivent être injectés dans la classe qui comprend Bar pas sur Bar module lui-même.

La source:  Rails ActiveSupport :: Préoccupation


29
2017-12-03 09:11



En ce qui concerne faire le fichier filename.rb

Par exemple, je veux dans mon application où l'attribut create_by existe mettre à jour sa valeur par 1, et 0 par update_by

module TestConcern 
  extend ActiveSupport::Concern

  def checkattributes   
    if self.has_attribute?(:created_by)
      self.update_attributes(created_by: 1)
    end
    if self.has_attribute?(:updated_by)
      self.update_attributes(updated_by: 0)
    end
  end

end

après cela inclure dans votre modèle comme ceci:

class Role < ActiveRecord::Base
  include TestConcern
end

6
2018-01-15 08:45