aboutsummaryrefslogtreecommitdiffstats
path: root/actionpack/lib
diff options
context:
space:
mode:
authorJeremy Kemper <jeremy@bitsweat.net>2007-02-18 06:44:20 +0000
committerJeremy Kemper <jeremy@bitsweat.net>2007-02-18 06:44:20 +0000
commit90c1207c384a39567777bc58f2de38eb7df236d7 (patch)
treece8564a6ab9ab2b1954cc0c91e6865c02e333423 /actionpack/lib
parent4fd84aae90e940b1a33429c4c5f9872fec777b80 (diff)
downloadrails-90c1207c384a39567777bc58f2de38eb7df236d7.tar.gz
rails-90c1207c384a39567777bc58f2de38eb7df236d7.tar.bz2
rails-90c1207c384a39567777bc58f2de38eb7df236d7.zip
Work around the two connection per host browser limit: use asset%d.myapp.com to distribute asset requests among asset[0123].myapp.com. Use a DNS wildcard or CNAMEs to map these hosts to your asset server. See http://www.die.net/musings/page_load_time/ for background.
git-svn-id: http://svn-commit.rubyonrails.org/rails/trunk@6161 5ecf4fe2-1ee6-0310-87b1-e25e094e27de
Diffstat (limited to 'actionpack/lib')
-rw-r--r--actionpack/lib/action_view/helpers/asset_tag_helper.rb98
1 files changed, 66 insertions, 32 deletions
diff --git a/actionpack/lib/action_view/helpers/asset_tag_helper.rb b/actionpack/lib/action_view/helpers/asset_tag_helper.rb
index b2a0d5344a..8d62f07b8c 100644
--- a/actionpack/lib/action_view/helpers/asset_tag_helper.rb
+++ b/actionpack/lib/action_view/helpers/asset_tag_helper.rb
@@ -11,13 +11,25 @@ module ActionView
# linking to them.
#
# ActionController::Base.asset_host = "http://assets.example.com"
- # image_tag("rails.png")
+ # image_tag("rails.png")
# => <img src="http://assets.example.com/images/rails.png" alt="Rails" />
# stylesheet_include_tag("application")
# => <link href="http://assets.example.com/stylesheets/application.css" media="screen" rel="Stylesheet" type="text/css" />
+ #
+ # Since browsers typically open at most two connections to a single host,
+ # your assets often wait in single file for their turn to load.
+ #
+ # Use a %d wildcard in asset_host (asset%d.myapp.com) to automatically
+ # distribute asset requests among four hosts (asset0-asset3.myapp.com)
+ # so browsers will open eight connections rather than two. Use wildcard
+ # DNS to CNAME the wildcard to your real asset host.
+ #
+ # Note: this is purely a browser performance optimization and is not meant
+ # for server load balancing. See http://www.die.net/musings/page_load_time/
+ # for background.
module AssetTagHelper
# Returns a link tag that browsers and news readers can use to auto-detect
- # an RSS or ATOM feed. The +type+ can either be <tt>:rss</tt> (default) or
+ # an RSS or ATOM feed. The +type+ can either be <tt>:rss</tt> (default) or
# <tt>:atom</tt>. Control the link options in url_for format using the
# +url_options+. You can modify the LINK tag itself in +tag_options+.
#
@@ -36,7 +48,7 @@ module ActionView
# <link rel="alternate" type="application/rss+xml" title="My RSS" href="http://www.curenthost.com/controller/feed" />
def auto_discovery_link_tag(type = :rss, url_options = {}, tag_options = {})
tag(
- "link",
+ "link",
"rel" => tag_options[:rel] || "alternate",
"type" => tag_options[:type] || Mime::Type.lookup_by_extension(type.to_s).to_s,
"title" => tag_options[:title] || type.to_s.upcase,
@@ -53,7 +65,7 @@ module ActionView
# javascript_path "dir/xmlhr.js" # => /javascripts/dir/xmlhr.js
# javascript_path "/dir/xmlhr" # => /dir/xmlhr.js
def javascript_path(source)
- compute_public_path(source, 'javascripts', 'js')
+ compute_public_path(source, 'javascripts', 'js')
end
JAVASCRIPT_DEFAULT_SOURCES = ['prototype', 'effects', 'dragdrop', 'controls'] unless const_defined?(:JAVASCRIPT_DEFAULT_SOURCES)
@@ -64,10 +76,10 @@ module ActionView
# that exist in your public/javascripts directory for inclusion into the
# current page or you can pass the full path relative to your document
# root. To include the Prototype and Scriptaculous javascript libraries in
- # your application, pass <tt>:defaults</tt> as the source. When using
- # :defaults, if an <tt>application.js</tt> file exists in your public
- # javascripts directory, it will be included as well. You can modify the
- # html attributes of the script tag by passing a hash as the last argument.
+ # your application, pass <tt>:defaults</tt> as the source. When using
+ # :defaults, if an <tt>application.js</tt> file exists in your public
+ # javascripts directory, it will be included as well. You can modify the
+ # html attributes of the script tag by passing a hash as the last argument.
#
# javascript_include_tag "xmlhr" # =>
# <script type="text/javascript" src="/javascripts/xmlhr.js"></script>
@@ -84,29 +96,29 @@ module ActionView
def javascript_include_tag(*sources)
options = sources.last.is_a?(Hash) ? sources.pop.stringify_keys : { }
- if sources.include?(:defaults)
- sources = sources[0..(sources.index(:defaults))] +
- @@javascript_default_sources.dup +
+ if sources.include?(:defaults)
+ sources = sources[0..(sources.index(:defaults))] +
+ @@javascript_default_sources.dup +
sources[(sources.index(:defaults) + 1)..sources.length]
- sources.delete(:defaults)
- sources << "application" if defined?(RAILS_ROOT) && File.exists?("#{RAILS_ROOT}/public/javascripts/application.js")
+ sources.delete(:defaults)
+ sources << "application" if defined?(RAILS_ROOT) && File.exists?("#{RAILS_ROOT}/public/javascripts/application.js")
end
sources.collect do |source|
- source = javascript_path(source)
+ source = javascript_path(source)
content_tag("script", "", { "type" => "text/javascript", "src" => source }.merge(options))
end.join("\n")
end
-
+
# Register one or more additional JavaScript files to be included when
# <tt>javascript_include_tag :defaults</tt> is called. This method is
- # only intended to be called from plugin initialization to register additional
+ # only intended to be called from plugin initialization to register additional
# .js files that the plugin installed in <tt>public/javascripts</tt>.
def self.register_javascript_include_default(*sources)
@@javascript_default_sources.concat(sources)
end
-
+
def self.reset_javascript_include_default #:nodoc:
@@javascript_default_sources = JAVASCRIPT_DEFAULT_SOURCES.dup
end
@@ -165,14 +177,14 @@ module ActionView
end
# Returns an html image tag for the +source+. The +source+ can be a full
- # path or a file that exists in your public images directory. Note that
+ # path or a file that exists in your public images directory. Note that
# specifying a filename without the extension is now deprecated in Rails.
# You can add html attributes using the +options+. The +options+ supports
# two additional keys for convienence and conformance:
#
- # * <tt>:alt</tt> - If no alt text is given, the file name part of the
+ # * <tt>:alt</tt> - If no alt text is given, the file name part of the
# +source+ is used (capitalized and without the extension)
- # * <tt>:size</tt> - Supplied as "{Width}x{Height}", so "30x45" becomes
+ # * <tt>:size</tt> - Supplied as "{Width}x{Height}", so "30x45" becomes
# width="30" and height="45". <tt>:size</tt> will be ignored if the
# value is not in the correct format.
#
@@ -184,10 +196,10 @@ module ActionView
# <img src="/icons/icon.gif" width="16" height="16" alt="Icon" />
def image_tag(source, options = {})
options.symbolize_keys!
-
+
options[:src] = image_path(source)
options[:alt] ||= File.basename(options[:src], '.*').split('.').first.capitalize
-
+
if options[:size]
options[:width], options[:height] = options[:size].split("x") if options[:size] =~ %r{^\d+x\d+$}
options.delete(:size)
@@ -195,24 +207,46 @@ module ActionView
tag("img", options)
end
-
+
private
+ # Add the .ext if not present. Return full URLs otherwise untouched.
+ # Prefix with /dir/ if lacking a leading /. Account for relative URL
+ # roots. Rewrite the asset path for cache-busting asset ids. Include
+ # a single or wildcarded asset host if configured.
def compute_public_path(source, dir, ext)
- source = source.dup
- source << ".#{ext}" if File.extname(source).blank?
- unless source =~ %r{^[-a-z]+://}
+ source += ".#{ext}" if File.extname(source).blank?
+ if source =~ %r{^[-a-z]+://}
+ source
+ else
source = "/#{dir}/#{source}" unless source[0] == ?/
- asset_id = rails_asset_id(source)
- source << '?' + asset_id if defined?(RAILS_ROOT) && !asset_id.blank?
- source = "#{ActionController::Base.asset_host}#{@controller.request.relative_url_root}#{source}"
+ source = "#{@controller.request.relative_url_root}#{source}"
+ rewrite_asset_path!(source)
+ "#{compute_asset_host(source)}#{source}"
+ end
+ end
+
+ # Pick an asset host for this source. Returns nil if no host is set,
+ # the host if no wildcard is set, or the host interpolated with the
+ # numbers 0-3 if it contains %d. The number is the source hash mod 4.
+ def compute_asset_host(source)
+ if host = ActionController::Base.asset_host
+ host % (source.hash % 4)
end
- source
end
-
+
+ # Use the RAILS_ASSET_ID environment variable or the source's
+ # modification time as its cache-busting asset id.
def rails_asset_id(source)
- ENV["RAILS_ASSET_ID"] ||
+ ENV["RAILS_ASSET_ID"] ||
File.mtime("#{RAILS_ROOT}/public/#{source}").to_i.to_s rescue ""
end
+
+ # Break out the asset path rewrite so you wish to put the asset id
+ # someplace other than the query string.
+ def rewrite_asset_path!(source)
+ asset_id = rails_asset_id(source)
+ source << "?#{asset_id}" if defined?(RAILS_ROOT) && !asset_id.blank?
+ end
end
end
end