module Catche module Tag class Object class << self @@objects = [] # Returns an existing (duplicate) or new tag object for the given arguments. # # Catche::Tag::Object.register!(Project, ProjectsController) def register!(model, object, options={}) tag_object = find_or_initialize(model, object, options) objects << tag_object objects.uniq! tag_object end alias :for :register! # Finds a previously declared (same) tag object or returns a new one. def find_or_initialize(model, object, options={}) new_object = self.new(model, object, options) objects.each do |tag_object| return tag_object if tag_object.same?(new_object) end new_object end def find_by_model(model) objects.select { |tag_object| tag_object.model == model } end def find_by_association(association) objects.select { |tag_object| tag_object.associations.include?(association) } end def clear @@objects = [] end def objects @@objects end end attr_reader :model, :object, :options attr_accessor :associations def initialize(model, object, options={}) @model = model @object = object association = options[:through] @options = { :resource_name => Catche::Tag::Resource.singularize(@model), :collection_name => Catche::Tag::Resource.pluralize(@model), :associations => [association].flatten.compact, :bubble => false, :expire_collection => true }.merge(options) @associations = @options[:associations] end # Returns the tags for the given object. # If `bubble` is set to true it will pass along the separate tag for each association. # This means the collection or resource is expired as soon as the association changes. # # object = Catche::Tag::Object.new(Task, TasksController, :through => [:user, :project]) # object.tags(controller.new) => ['users_1_projects_1_tasks_1'] def tags(initialized_object) tags = [] tags += association_tags(initialized_object) if bubble? tags += expiration_tags(initialized_object) tags end # The tags that should expire as soon as the resource or collection changes. def expiration_tags(initialized_object) resource = Catche::Tag::Resource.resource(initialized_object, options[:resource_name]) tags = [] # Add collection tags when enabled tags << Catche::Tag.join( association_tags(initialized_object), options[:collection_name] ) if resource.nil? && options[:expire_collection] tags << Catche::Tag.join( association_tags(initialized_object), identifier_tags(initialized_object) ) tags.uniq end # Identifying tag for the current resource or collection. # # object = Catche::Tag::Object.new(Task, TasksController) # object.identifier_tags(controller) => ['tasks', 1] def identifier_tags(initialized_object) Catche::Tag.join options[:collection_name], Catche::Tag::Resource.resource(initialized_object, options[:resource_name]).try(:id) end # Maps the given resources names to tags by fetching the resources from the given object. def resource_tags(*resources) resources.map { |resource| Catche::Tag.join(Catche::Tag::Resource.pluralize(resource.class), resource.id) } end # Maps association tags. # # object = Catche::Tag::Object.new(Task, TasksController, :through => [:user, :project]) # object.association_tags(controller) => ['users_1', 'projects_1'] def association_tags(initialized_object) resource_tags(*Catche::Tag::Resource.associations(initialized_object, associations)) end def bubble? options[:bubble] end def same?(object) self.model == object.model && self.object == object.object && self.options == object.options end end end end