跳至内容 跳至搜索

Railties – 将 Engine 绑定到 Rails ↑

Railties 负责将所有框架绑定在一起。总的来说，它

  • 负责 Rails 应用程序的引导过程；

  • 管理 rails 命令行界面；

  • 并提供 Rails 生成器核心。

下载 ↑

可以使用 RubyGems 安装最新版本的 Railties

  • gem install railties

源代码可以作为 Rails 项目的一部分在 GitHub 上下载。

许可证 ↑

Railties 在 MIT 许可证下发布

支持 ↑

API 文档位于

Ruby on Rails 项目的错误报告可在此处提交

功能请求应在此处的 rubyonrails-core 论坛上讨论：

命名空间
方法
A
B
C
E
G
P
R
V

Attributes

[RW] app_class
[W] application
[RW] cache
[RW] logger

类公共方法

application()

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 44
def application
  @application ||= (app_class.instance if app_class)
end

autoloaders()

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 133
def autoloaders
  application.autoloaders
end

backtrace_cleaner()

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 55
def backtrace_cleaner
  @backtrace_cleaner ||= Rails::BacktraceCleaner.new
end

configuration()

用于配置 Rails 环境的 Configuration 实例

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 51
def configuration
  application.config
end

env()

返回当前 Rails 环境。

Rails.env # => "development"
Rails.env.development? # => true
Rails.env.production? # => false
Rails.env.local? # => true              true for "development" and "test", false for anything else

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 74
def env
  @_env ||= ActiveSupport::EnvironmentInquirer.new(ENV["RAILS_ENV"].presence || ENV["RACK_ENV"].presence || "development")
end

env=(environment)

设置 Rails 环境。

Rails.env = "staging" # => "staging"

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 81
def env=(environment)
  @_env = ActiveSupport::EnvironmentInquirer.new(environment)
end

error()

返回当前 Rails 项目的 ActiveSupport::ErrorReporter，如果不存在项目则返回 nil。

Rails.error.handle(IOError) do
  # ...
end
Rails.error.report(error)

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 92
def error
  ActiveSupport.error_reporter
end

event()

返回当前 Rails 项目的 ActiveSupport::EventReporter，如果不存在项目则返回 nil。

Rails.event.notify("my_event", { message: "Hello, world!" })

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 100
def event
  ActiveSupport.event_reporter
end

gem_version()

以 Gem::Version 对象形式返回当前加载的 Rails 版本。

来源： 显示 | 在 GitHub 上

# File railties/lib/rails/gem_version.rb, line 5
def self.gem_version
  Gem::Version.new VERSION::STRING
end

groups(*groups)

根据以下条件返回加载的所有 Rails 组：

  • Rails 环境；

  • 环境变量 RAILS_GROUPS；

  • 作为参数提供的可选环境以及包含组依赖项的哈希；

Rails.groups assets: [:development, :test]
# => [:default, "development", :assets] for Rails.env == "development"
# => [:default, "production"]           for Rails.env == "production"

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 113
def groups(*groups)
  hash = groups.extract_options!
  env = Rails.env
  groups.unshift(:default, env)
  groups.concat ENV["RAILS_GROUPS"].to_s.split(",")
  groups.concat hash.map { |k, v| k if v.map(&:to_s).include?(env) }
  groups.compact!
  groups.uniq!
  groups
end

public_path()

返回当前 Rails 项目公共文件夹的 Pathname 对象，如果不存在项目则返回 nil。

Rails.public_path
  # => #<Pathname:/Users/someuser/some/path/project/public>

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 129
def public_path
  application && Pathname.new(application.paths["public"].first)
end

root()

返回当前 Rails 项目的 Pathname 对象，如果不存在项目则返回 nil。

Rails.root
  # => #<Pathname:/Users/someuser/some/path/project>

来源： 显示 | 在 GitHub 上

# File railties/lib/rails.rb, line 64
def root
  application && application.config.root
end

version()

以字符串形式返回当前加载的 Rails 版本。

来源： 显示 | 在 GitHub 上

# File railties/lib/rails/version.rb, line 7
def self.version
  VERSION::STRING
end