integration.rb 3.9 KB
Newer Older
1 2
require 'active_support/core_ext/string/filters'

3 4
module ActiveRecord
  module Integration
5 6 7 8 9
    extend ActiveSupport::Concern

    included do
      ##
      # :singleton-method:
10 11 12 13
      # Indicates the format used to generate the timestamp in the cache key.
      # Accepts any of the symbols in <tt>Time::DATE_FORMATS</tt>.
      #
      # This is +:nsec+, by default.
14 15 16 17
      class_attribute :cache_timestamp_format, :instance_writer => false
      self.cache_timestamp_format = :nsec
    end

18 19 20 21 22 23 24 25
    # Returns a String, which Action Pack uses for constructing an URL to this
    # object. The default implementation returns this record's id as a String,
    # or nil if this record's unsaved.
    #
    # For example, suppose that you have a User model, and that you have a
    # <tt>resources :users</tt> route. Normally, +user_path+ will
    # construct a path with the user object's 'id' in it:
    #
26
    #   user = User.find_by(name: 'Phusion')
27 28 29 30 31 32 33 34 35 36 37
    #   user_path(user)  # => "/users/1"
    #
    # You can override +to_param+ in your model to make +user_path+ construct
    # a path using the user's name instead of the user's id:
    #
    #   class User < ActiveRecord::Base
    #     def to_param  # overridden
    #       name
    #     end
    #   end
    #
38
    #   user = User.find_by(name: 'Phusion')
39 40 41 42 43 44 45 46 47 48 49
    #   user_path(user)  # => "/users/Phusion"
    def to_param
      # We can't use alias_method here, because method 'id' optimizes itself on the fly.
      id && id.to_s # Be sure to stringify the id for routes
    end

    # Returns a cache key that can be used to identify this record.
    #
    #   Product.new.cache_key     # => "products/new"
    #   Product.find(5).cache_key # => "products/5" (updated_at not available)
    #   Person.find(5).cache_key  # => "people/5-20071224150000" (updated_at available)
C
Carlos Antonio da Silva 已提交
50
    #
51 52 53 54 55
    # You can also pass a list of named timestamps, and the newest in the list will be
    # used to generate the key:
    #
    #   Person.find(5).cache_key(:updated_at, :last_reviewed_at)
    def cache_key(*timestamp_names)
56 57
      case
      when new_record?
58
        "#{model_name.cache_key}/new"
59
      when timestamp_names.any?
60 61
        timestamp = max_updated_column_timestamp(timestamp_names)
        timestamp = timestamp.utc.to_s(cache_timestamp_format)
62
        "#{model_name.cache_key}/#{id}-#{timestamp}"
63
      when timestamp = max_updated_column_timestamp
64
        timestamp = timestamp.utc.to_s(cache_timestamp_format)
65
        "#{model_name.cache_key}/#{id}-#{timestamp}"
66
      else
67
        "#{model_name.cache_key}/#{id}"
68 69
      end
    end
70 71 72 73 74 75 76 77 78 79 80 81 82 83

    module ClassMethods
      # Defines your model's +to_param+ method to generate "pretty" URLs
      # using +method_name+, which can be any attribute or method that
      # responds to +to_s+.
      #
      #   class User < ActiveRecord::Base
      #     to_param :name
      #   end
      #
      #   user = User.find_by(name: 'Fancy Pants')
      #   user.id         # => 123
      #   user_path(user) # => "/users/123-fancy-pants"
      #
84 85 86
      # Values longer than 20 characters will be truncated. The value
      # is truncated word by word.
      #
87 88 89 90
      #   user = User.find_by(name: 'David HeinemeierHansson')
      #   user.id         # => 125
      #   user_path(user) # => "/users/125-david"
      #
91 92 93 94 95
      # Because the generated param begins with the record's +id+, it is
      # suitable for passing to +find+. In a controller, for example:
      #
      #   params[:id]               # => "123-fancy-pants"
      #   User.find(params[:id]).id # => 123
J
Javan Makhmali 已提交
96 97 98 99 100
      def to_param(method_name = nil)
        if method_name.nil?
          super()
        else
          define_method :to_param do
101 102 103 104
            if (default = super()) &&
                 (result = send(method_name).to_s).present? &&
                   (param = result.squish.truncate(20, separator: /\s/, omission: nil).parameterize).present?
              "#{default}-#{param}"
J
Javan Makhmali 已提交
105 106 107
            else
              default
            end
108 109 110 111
          end
        end
      end
    end
112 113
  end
end