封裝 MIME 類型的概念。可以在渲染時使用,例如,使用
class PostsController < ActionController::Base
def show
@post = Post.find(params[:id])
respond_to do |format|
format.html
format.ics { render body: @post.to_ics, mime_type: Mime::Type.lookup("text/calendar") }
format.xml { render xml: @post }
end
end
end
- #
- A
- E
- H
- L
- M
- N
- P
- R
- T
- U
常數
ACCEPT_HEADER_REGEXP | = | /[^,\s"](?:[^,"]|"[^"]*")*/ |
MIME_NAME | = | "[a-zA-Z0-9][a-zA-Z0-9#{Regexp.escape('!#$&-^_.+')}]{0,126}" |
MIME_PARAMETER | = | "\s*;\s*#{MIME_NAME}(?:=#{MIME_PARAMETER_VALUE})?" |
MIME_PARAMETER_VALUE | = | "(?:#{MIME_NAME}|\"[^\"\r\\\\]*\")" |
MIME_REGEXP | = | /\A(?:\*\/\*|#{MIME_NAME}\/(?:\*|#{MIME_NAME})(?>#{MIME_PARAMETER})*\s*)\z/ |
PARAMETER_SEPARATOR_REGEXP | = | /;\s*q="?/ |
所有媒體類型參數必須在 q 參數之前 www.rfc-editor.org/rfc/rfc7231#section-5.3.2 |
||
TRAILING_STAR_REGEXP | = | /^(text|application)\/\*/ |
屬性
[R] | hash | |
[R] | string | |
[R] | symbol | |
[R] | synonyms |
類別公開方法
lookup(string) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 164 def lookup(string) # fallback to the media-type without parameters if it was not found LOOKUP[string] || LOOKUP[string.split(";", 2)[0]&.rstrip] || Type.new(string) end
lookup_by_extension(extension) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 169 def lookup_by_extension(extension) EXTENSION_LOOKUP[extension.to_s] end
new(string, symbol = nil, synonyms = []) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 257 def initialize(string, symbol = nil, synonyms = []) unless MIME_REGEXP.match?(string) raise InvalidMimeType, "#{string.inspect} is not a valid MIME type" end @symbol, @synonyms = symbol, synonyms @string = string @hash = [@string, @synonyms, @symbol].hash end
parse(accept_header) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 193 def parse(accept_header) if !accept_header.include?(",") if (index = accept_header.index(PARAMETER_SEPARATOR_REGEXP)) accept_header = accept_header[0, index].strip end return [] if accept_header.blank? parse_trailing_star(accept_header) || Array(Mime::Type.lookup(accept_header)) else list, index = [], 0 accept_header.scan(ACCEPT_HEADER_REGEXP).each do |header| params, q = header.split(PARAMETER_SEPARATOR_REGEXP) next unless params params.strip! next if params.empty? params = parse_trailing_star(params) || [params] params.each do |m| list << AcceptItem.new(index, m.to_s, q) index += 1 end end AcceptList.sort! list end end
parse_data_with_trailing_star(type) 連結
對於輸入的 'text'
,傳回 [Mime[:json], Mime[:xml], Mime[:ics], Mime[:html], Mime[:css], Mime[:csv], Mime[:js], Mime[:yaml], Mime[:text]]
。
對於輸入的 'application'
,傳回 [Mime[:html], Mime[:js], Mime[:xml], Mime[:yaml], Mime[:atom], Mime[:json], Mime[:rss], Mime[:url_encoded_form]]
。
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 229 def parse_data_with_trailing_star(type) Mime::SET.select { |m| m.match?(type) } end
parse_trailing_star(accept_header) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 220 def parse_trailing_star(accept_header) parse_data_with_trailing_star($1) if accept_header =~ TRAILING_STAR_REGEXP end
register(string, symbol, mime_type_synonyms = [], extension_synonyms = [], skip_lookup = false) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 179 def register(string, symbol, mime_type_synonyms = [], extension_synonyms = [], skip_lookup = false) new_mime = Type.new(string, symbol, mime_type_synonyms) SET << new_mime ([string] + mime_type_synonyms).each { |str| LOOKUP[str] = new_mime } unless skip_lookup ([symbol] + extension_synonyms).each { |ext| EXTENSION_LOOKUP[ext.to_s] = new_mime } @register_callbacks.each do |callback| callback.call(new_mime) end new_mime end
register_alias(string, symbol, extension_synonyms = []) 連結
註冊一個別用於 MIME 類型查詢的別名,但可以直接參照。特別適用於根據使用者代理呈現不同的 HTML 版本,例如 iPhone。
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 175 def register_alias(string, symbol, extension_synonyms = []) register(string, symbol, [], extension_synonyms, true) end
register_callback(&block) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 160 def register_callback(&block) @register_callbacks << block end
unregister(symbol) 連結
此方法與 register 方法相反。
要取消註冊 MIME 類型
Mime::Type.unregister(:mobile)
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 238 def unregister(symbol) symbol = symbol.downcase if mime = Mime[symbol] SET.delete_if { |v| v.eql?(mime) } LOOKUP.delete_if { |_, v| v.eql?(mime) } EXTENSION_LOOKUP.delete_if { |_, v| v.eql?(mime) } end end
實例公開方法
==(mime_type) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 290 def ==(mime_type) return false unless mime_type (@synonyms + [ self ]).any? do |synonym| synonym.to_s == mime_type.to_s || synonym.to_sym == mime_type.to_sym end end
===(list) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 282 def ===(list) if list.is_a?(Array) (@synonyms + [ self ]).any? { |synonym| list.include?(synonym) } else super end end
=~(mime_type) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 304 def =~(mime_type) return false unless mime_type regexp = Regexp.new(Regexp.quote(mime_type.to_s)) @synonyms.any? { |synonym| synonym.to_s =~ regexp } || @string =~ regexp end
all?() 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 320 def all?; false; end
eql?(other) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 297 def eql?(other) super || (self.class == other.class && @string == other.string && @synonyms == other.synonyms && @symbol == other.symbol) end
html?() 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 316 def html? (symbol == :html) || @string.include?("html") end
match?(mime_type) 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 310 def match?(mime_type) return false unless mime_type regexp = Regexp.new(Regexp.quote(mime_type.to_s)) @synonyms.any? { |synonym| synonym.to_s.match?(regexp) } || @string.match?(regexp) end
ref() 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 278 def ref symbol || to_s end
to_s() 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 266 def to_s @string end
to_str() 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 270 def to_str to_s end
to_sym() 連結
來源:顯示 | 在 GitHub 上
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 274 def to_sym @symbol end