Skip to content
Newer
Older
100644 231 lines (199 sloc) 7.12 KB
6690d66 @josevalim Rename config.cookie_secret to config.secret_token and pass it as con…
josevalim authored
1 require 'active_support/core_ext/hash/reverse_merge'
772c2b0 @josevalim Use the new ActiveSupport::FileUpdateChecker instead of RoutesReloader.
josevalim authored
2 require 'active_support/file_update_checker'
02c5137 @josevalim Add view paths to Engine setup.
josevalim authored
3 require 'fileutils'
b17e358 @josevalim Move configuration to subfolders.
josevalim authored
4 require 'rails/plugin'
2fde9d7 @josevalim Solve some pendencies.
josevalim authored
5 require 'rails/engine'
dc677f7 tests pass with requiring the frameworks in rails.rb
Carlhuda authored
6
accd9b4 @josh Restore "Start Rails::Application object
josh authored
7 module Rails
781d0a9 @josevalim Add docs for Railtie, Engine, Plugin and Application.
josevalim authored
8 # In Rails 3.0, a Rails::Application object was introduced which is nothing more than
9 # an Engine but with the responsibility of coordinating the whole boot process.
10 #
11 # == Initialization
12 #
13 # Rails::Application is responsible for executing all railties, engines and plugin
14 # initializers. Besides, it also executed some bootstrap initializers (check
15 # Rails::Application::Bootstrap) and finishing initializers, after all the others
16 # are executed (check Rails::Application::Finisher).
17 #
18 # == Configuration
19 #
20 # Besides providing the same configuration as Rails::Engine and Rails::Railtie,
21 # the application object has several specific configurations, for example
22 # "allow_concurrency", "cache_classes", "consider_all_requests_local", "filter_parameters",
9b19a6f @josevalim A few changes were done in this commit:
josevalim authored
23 # "logger", "reload_plugins" and so forth.
781d0a9 @josevalim Add docs for Railtie, Engine, Plugin and Application.
josevalim authored
24 #
25 # Check Rails::Application::Configuration to see them all.
26 #
27 # == Routes
28 #
29 # The application object is also responsible for holding the routes and reloading routes
30 # whenever the files change in development.
31 #
45e6028 @wycats Removing Metal from Rails 3.
wycats authored
32 # == Middlewares
781d0a9 @josevalim Add docs for Railtie, Engine, Plugin and Application.
josevalim authored
33 #
45e6028 @wycats Removing Metal from Rails 3.
wycats authored
34 # The Application is also responsible for building the middleware stack.
9cfeefb @wycats Reorganized initializers a bit to enable better hooks for common case…
wycats authored
35 #
7fcf859 @josevalim Massive cleanup in Railties and load stack.
josevalim authored
36 class Application < Engine
4f03603 @josevalim Break application.rb file in smaller chunks.
josevalim authored
37 autoload :Bootstrap, 'rails/application/bootstrap'
f8bf198 @josevalim Add tests for explicit engines.
josevalim authored
38 autoload :Configurable, 'rails/application/configurable'
b17e358 @josevalim Move configuration to subfolders.
josevalim authored
39 autoload :Configuration, 'rails/application/configuration'
4f03603 @josevalim Break application.rb file in smaller chunks.
josevalim authored
40 autoload :Finisher, 'rails/application/finisher'
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
41 autoload :Railties, 'rails/application/railties'
80130d1 @josevalim Extract routes reloading responsibilities from application and load t…
josevalim authored
42
e4d7e50 Moving more initializers into the application object
Carl Lerche authored
43 class << self
94bb331 @jeremy Shift more responsibility from application class to its singleton ins…
jeremy authored
44 private :new
79b0b50 @wycats Aliasing class_eval makes JRuby ornery.
wycats authored
45
46 def configure(&block)
47 class_eval(&block)
48 end
80130d1 @josevalim Extract routes reloading responsibilities from application and load t…
josevalim authored
49
94bb331 @jeremy Shift more responsibility from application class to its singleton ins…
jeremy authored
50 def instance
db99324 @josevalim Ensure calling a method in Rails::Application does not instantiate a …
josevalim authored
51 if self == Rails::Application
53b34e8 @josevalim Avoid calls to Rails::Application since this is not the official API.
josevalim authored
52 if Rails.application
53 ActiveSupport::Deprecation.warn "Calling a method in Rails::Application is deprecated, " <<
54 "please call it directly in your application constant #{Rails.application.class.name}.", caller
55 end
db99324 @josevalim Ensure calling a method in Rails::Application does not instantiate a …
josevalim authored
56 Rails.application
9212652 @josh Add Rails::Application pointer to the default app to add symmetry to …
josh authored
57 else
db99324 @josevalim Ensure calling a method in Rails::Application does not instantiate a …
josevalim authored
58 @@instance ||= new
9212652 @josh Add Rails::Application pointer to the default app to add symmetry to …
josh authored
59 end
897164d Conceptually unify instance & global initializers
Yehuda Katz + Carl Lerche authored
60 end
61
7fcf859 @josevalim Massive cleanup in Railties and load stack.
josevalim authored
62 def inherited(base)
2fde9d7 @josevalim Solve some pendencies.
josevalim authored
63 raise "You cannot have more than one Rails::Application" if Rails.application
7fcf859 @josevalim Massive cleanup in Railties and load stack.
josevalim authored
64 super
788fce2 @josevalim Create configurable modules and ensure that they are added only on di…
josevalim authored
65 Rails.application = base.instance
6f83a50 @fxn renames load_(once_)paths to autoload_(once_)paths in dependencies an…
fxn authored
66 Rails.application.add_lib_to_load_path!
9cfeefb @wycats Reorganized initializers a bit to enable better hooks for common case…
wycats authored
67 ActiveSupport.run_load_hooks(:before_configuration, base.instance)
e4d7e50 Moving more initializers into the application object
Carl Lerche authored
68 end
6f6a589 Create the application object from config/environment.rb
Yehuda Katz + Carl Lerche authored
69
e7418ab @josevalim Add more tests to some key points in Railties.
josevalim authored
70 def respond_to?(*args)
71 super || instance.respond_to?(*args)
72 end
73
80130d1 @josevalim Extract routes reloading responsibilities from application and load t…
josevalim authored
74 protected
75
76 def method_missing(*args, &block)
77 instance.send(*args, &block)
426348b @josh Update routes.rb template to use App name
josh authored
78 end
897164d Conceptually unify instance & global initializers
Yehuda Katz + Carl Lerche authored
79 end
6f6a589 Create the application object from config/environment.rb
Yehuda Katz + Carl Lerche authored
80
45e6028 @wycats Removing Metal from Rails 3.
wycats authored
81 delegate :middleware, :to => :config
395d664 @josevalim Move application configuration to the application configuration objec…
josevalim authored
82
9e081ca @josevalim Improve documentation for add_lib_to_load_paths!
josevalim authored
83 # This method is called just after an application inherits from Rails::Application,
84 # allowing the developer to load classes in lib and use them during application
85 # configuration.
86 #
87 # class MyApplication < Rails::Application
88 # require "my_backend" # in lib/my_backend
89 # config.i18n.backend = MyBackend
90 # end
91 #
92 # Notice this method takes into consideration the default root path. So if you
93 # are changing config.root inside your application definition or having a custom
94 # Rails application, you will need to add lib to $LOAD_PATH on your own in case
95 # you need to load files in lib/ during the application configuration as well.
6f83a50 @fxn renames load_(once_)paths to autoload_(once_)paths in dependencies an…
fxn authored
96 def add_lib_to_load_path! #:nodoc:
5a0d73f @josevalim Add lib to load paths when application is inherited to be able to loa…
josevalim authored
97 path = config.root.join('lib').to_s
98 $LOAD_PATH.unshift(path) if File.exists?(path)
99 end
100
9e081ca @josevalim Improve documentation for add_lib_to_load_paths!
josevalim authored
101 def require_environment! #:nodoc:
1b816d5 @josevalim The rake task :environment now loads config/environment.rb instead of…
josevalim authored
102 environment = paths.config.environment.to_a.first
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
103 require environment if environment
d982fe2 Replace reopening the class with App.configure as an alias to class_eval
Carlhuda authored
104 end
105
9e081ca @josevalim Improve documentation for add_lib_to_load_paths!
josevalim authored
106 def eager_load! #:nodoc:
5a0d73f @josevalim Add lib to load paths when application is inherited to be able to loa…
josevalim authored
107 railties.all(&:eager_load!)
108 super
109 end
110
80130d1 @josevalim Extract routes reloading responsibilities from application and load t…
josevalim authored
111 def routes
9a5be2e Get Railties tests passing
Carlhuda authored
112 @routes ||= ActionDispatch::Routing::RouteSet.new
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
113 end
114
115 def railties
116 @railties ||= Railties.new(config)
897164d Conceptually unify instance & global initializers
Yehuda Katz + Carl Lerche authored
117 end
5f8e48c @josh Move route reloading into railties
josh authored
118
80130d1 @josevalim Extract routes reloading responsibilities from application and load t…
josevalim authored
119 def routes_reloader
772c2b0 @josevalim Use the new ActiveSupport::FileUpdateChecker instead of RoutesReloader.
josevalim authored
120 @routes_reloader ||= ActiveSupport::FileUpdateChecker.new([]){ reload_routes! }
5f8e48c @josh Move route reloading into railties
josh authored
121 end
122
123 def reload_routes!
0189fb7 @josevalim reload_routes! was still referencing old Rails::Application.
josevalim authored
124 _routes = self.routes
125 _routes.disable_clear_and_finalize = true
126 _routes.clear!
772c2b0 @josevalim Use the new ActiveSupport::FileUpdateChecker instead of RoutesReloader.
josevalim authored
127 routes_reloader.paths.each { |path| load(path) }
0189fb7 @josevalim reload_routes! was still referencing old Rails::Application.
josevalim authored
128 ActiveSupport.on_load(:action_controller) { _routes.finalize! }
772c2b0 @josevalim Use the new ActiveSupport::FileUpdateChecker instead of RoutesReloader.
josevalim authored
129 ensure
0189fb7 @josevalim reload_routes! was still referencing old Rails::Application.
josevalim authored
130 _routes.disable_clear_and_finalize = false
80130d1 @josevalim Extract routes reloading responsibilities from application and load t…
josevalim authored
131 end
5f8e48c @josh Move route reloading into railties
josh authored
132
80130d1 @josevalim Extract routes reloading responsibilities from application and load t…
josevalim authored
133 def initialize!
134 run_initializers(self)
135 self
5f8e48c @josh Move route reloading into railties
josh authored
136 end
137
94bb331 @jeremy Shift more responsibility from application class to its singleton ins…
jeremy authored
138 def load_tasks
788fce2 @josevalim Create configurable modules and ensure that they are added only on di…
josevalim authored
139 initialize_tasks
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
140 railties.all { |r| r.load_tasks }
e461e1b @josevalim Ensure application rake tasks and generators are loaded after the one…
josevalim authored
141 super
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
142 self
94bb331 @jeremy Shift more responsibility from application class to its singleton ins…
jeremy authored
143 end
144
4ca9765 @josevalim Allow railties to specify generators paths.
josevalim authored
145 def load_generators
788fce2 @josevalim Create configurable modules and ensure that they are added only on di…
josevalim authored
146 initialize_generators
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
147 railties.all { |r| r.load_generators }
e461e1b @josevalim Ensure application rake tasks and generators are loaded after the one…
josevalim authored
148 super
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
149 self
82b9b15 Refactor plugins
Yehuda Katz + Carl Lerche authored
150 end
151
fa98eca @josevalim Add console hook to force ActiveRecord::Base to be loaded when consol…
josevalim authored
152 def load_console(sandbox=false)
153 initialize_console(sandbox)
154 railties.all { |r| r.load_console }
155 super()
156 self
157 end
158
603d4fb @josh Build middleware stack and reload routes after app initializers run
josh authored
159 def app
19d8c8c @josevalim Remove the laziness from the middleware stack.
josevalim authored
160 @app ||= begin
161 config.middleware = config.middleware.merge_into(default_middleware_stack)
162 config.middleware.build(routes)
163 end
603d4fb @josh Build middleware stack and reload routes after app initializers run
josh authored
164 end
f816666 @josevalim Alias app to build_middleware_stack for clarity.
josevalim authored
165 alias :build_middleware_stack :app
603d4fb @josh Build middleware stack and reload routes after app initializers run
josh authored
166
897164d Conceptually unify instance & global initializers
Yehuda Katz + Carl Lerche authored
167 def call(env)
6690d66 @josevalim Rename config.cookie_secret to config.secret_token and pass it as con…
josevalim authored
168 app.call(env.reverse_merge!(env_defaults))
169 end
170
171 def env_defaults
172 @env_defaults ||= {
173 "action_dispatch.parameter_filter" => config.filter_parameters,
174 "action_dispatch.secret_token" => config.secret_token
175 }
6d6ae08 Start moving the initializers into the application object
Carl Lerche authored
176 end
177
98240c4 @josevalim Get rid of initializers global and create i18n railtie.
josevalim authored
178 def initializers
5d07869 @josevalim Ensure all initializers are collections.
josevalim authored
179 initializers = Bootstrap.initializers_for(self)
13d66cd @josevalim Extract Railtie load from application.
josevalim authored
180 railties.all { |r| initializers += r.initializers }
2d1f9fb @josh Plugins need to load before app initializers
josh authored
181 initializers += super
5d07869 @josevalim Ensure all initializers are collections.
josevalim authored
182 initializers += Finisher.initializers_for(self)
9f7874a @jeremy Move Collection responsibility from application to initializable
jeremy authored
183 initializers
98240c4 @josevalim Get rid of initializers global and create i18n railtie.
josevalim authored
184 end
788fce2 @josevalim Create configurable modules and ensure that they are added only on di…
josevalim authored
185
186 protected
187
19d8c8c @josevalim Remove the laziness from the middleware stack.
josevalim authored
188 def default_middleware_stack
189 ActionDispatch::MiddlewareStack.new.tap do |middleware|
190 middleware.use ::ActionDispatch::Static, paths.public.to_a.first if config.serve_static_assets
191 middleware.use ::Rack::Lock if !config.allow_concurrency
192 middleware.use ::Rack::Runtime
193 middleware.use ::Rails::Rack::Logger
194 middleware.use ::ActionDispatch::ShowExceptions, config.consider_all_requests_local if config.action_dispatch.show_exceptions
195 middleware.use ::ActionDispatch::RemoteIp, config.action_dispatch.ip_spoofing_check, config.action_dispatch.trusted_proxies
196 middleware.use ::Rack::Sendfile, config.action_dispatch.x_sendfile_header
197 middleware.use ::ActionDispatch::Callbacks, !config.cache_classes
198 middleware.use ::ActionDispatch::Cookies
199
200 if config.session_store
201 middleware.use config.session_store, config.session_options
202 middleware.use ::ActionDispatch::Flash
203 end
204
205 middleware.use ::ActionDispatch::ParamsParser
206 middleware.use ::Rack::MethodOverride
207 middleware.use ::ActionDispatch::Head
6767946 @wycats Improve best_standards_support to use only IE=Edge in development mode
wycats authored
208 middleware.use ::ActionDispatch::BestStandardsSupport, config.action_dispatch.best_standards_support if config.action_dispatch.best_standards_support
19d8c8c @josevalim Remove the laziness from the middleware stack.
josevalim authored
209 end
210 end
211
788fce2 @josevalim Create configurable modules and ensure that they are added only on di…
josevalim authored
212 def initialize_tasks
213 require "rails/tasks"
214 task :environment do
215 $rails_rake_task = true
1b816d5 @josevalim The rake task :environment now loads config/environment.rb instead of…
josevalim authored
216 require_environment!
788fce2 @josevalim Create configurable modules and ensure that they are added only on di…
josevalim authored
217 end
218 end
219
220 def initialize_generators
221 require "rails/generators"
222 end
fa98eca @josevalim Add console hook to force ActiveRecord::Base to be loaded when consol…
josevalim authored
223
224 def initialize_console(sandbox=false)
225 require "rails/console/app"
226 require "rails/console/sandbox" if sandbox
227 require "rails/console/helpers"
228 end
accd9b4 @josh Restore "Start Rails::Application object
josh authored
229 end
230 end
Something went wrong with that request. Please try again.