跳至内容 跳至搜索
命名空间
方法
C
T

类公共方法

cache_timestamp_format

指示在关闭版本控制的情况下，用于生成缓存键中时间戳的格式。接受Time::DATE_FORMATS中的任何符号。

默认情况下，这是:usec。

来源：显示 | 在 GitHub 上

# File activerecord/lib/active_record/integration.rb, line 16
class_attribute :cache_timestamp_format, instance_writer: false, default: :usec

cache_versioning

指示是否使用稳定的 cache_key 方法，该方法伴随 cache_version 方法中的更改版本。

默认情况下，在 Rails 5.2 及更高版本中，此值为true。

来源：显示 | 在 GitHub 上

# File activerecord/lib/active_record/integration.rb, line 24
class_attribute :cache_versioning, instance_writer: false, default: false

collection_cache_versioning

指示是否在集合上使用稳定的 cache_key 方法，该方法伴随 cache_version 方法中的更改版本。

默认情况下，在 Rails 6.1 之前，此值为false。

来源：显示 | 在 GitHub 上

# File activerecord/lib/active_record/integration.rb, line 32
class_attribute :collection_cache_versioning, instance_writer: false, default: false

实例公共方法

cache_key()

返回一个稳定的缓存键，可用于标识此记录。

Product.new.cache_key     # => "products/new"
Product.find(5).cache_key # => "products/5"

如果 ActiveRecord::Base.cache_versioning 被关闭，就像在 Rails 5.1 及更早版本中一样，缓存键也将包含一个版本。

Product.cache_versioning = false
Product.find(5).cache_key  # => "products/5-20071224150000" (updated_at available)

来源：显示 | 在 GitHub 上

# File activerecord/lib/active_record/integration.rb, line 72
def cache_key
  if new_record?
    "#{model_name.cache_key}/new"
  else
    if cache_version
      "#{model_name.cache_key}/#{id}"
    else
      timestamp = max_updated_column_timestamp

      if timestamp
        timestamp = timestamp.utc.to_fs(cache_timestamp_format)
        "#{model_name.cache_key}/#{id}-#{timestamp}"
      else
        "#{model_name.cache_key}/#{id}"
      end
    end
  end
end

cache_key_with_version()

返回一个缓存键以及版本。

来源：显示 | 在 GitHub 上

# File activerecord/lib/active_record/integration.rb, line 114
def cache_key_with_version
  if version = cache_version
    "#{cache_key}-#{version}"
  else
    cache_key
  end
end

cache_version()

返回一个缓存版本，该版本可与缓存键一起使用，以形成可回收的缓存方案。默认情况下，updated_at 列用于 cache_version，但此方法可以被覆盖以返回其他内容。

请注意，如果 ActiveRecord::Base.cache_versioning 设置为false，则此方法将返回 nil。

来源：显示 | 在 GitHub 上

# File activerecord/lib/active_record/integration.rb, line 97
def cache_version
  return unless cache_versioning

  if has_attribute?("updated_at")
    timestamp = updated_at_before_type_cast
    if can_use_fast_cache_version?(timestamp)
      raw_timestamp_to_cache_version(timestamp)

    elsif timestamp = updated_at
      timestamp.utc.to_fs(cache_timestamp_format)
    end
  elsif self.class.has_attribute?("updated_at")
    raise ActiveModel::MissingAttributeError, "missing attribute 'updated_at' for #{self.class}"
  end
end

to_param()

返回一个String，Action Pack 使用它来构建指向此对象的 URL。默认实现将此记录的 id 作为String返回，或者如果此记录未保存则返回nil。

例如，假设您有一个 User 模型，并且您有一个resources :users 路由。通常，user_path 将使用用户对象的“id”构建路径

user = User.find_by(name: 'Phusion')
user_path(user)  # => "/users/1"

您可以在模型中覆盖to_param，以使user_path 使用用户名而不是用户 id 构建路径

class User < ActiveRecord::Base
  def to_param  # overridden
    name
  end
end

user = User.find_by(name: 'Phusion')
user_path(user)  # => "/users/Phusion"

来源：显示 | 在 GitHub 上

# File activerecord/lib/active_record/integration.rb, line 57
def to_param
  return unless id
  Array(id).join(self.class.param_delimiter)
end