class Mime::Type
Описывает понятие 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
Константы
- ACCEPT_HEADER_REGEXP
- MIME_NAME
- MIME_PARAMETER
- MIME_PARAMETER_VALUE
- MIME_REGEXP
- PARAMETER_SEPARATOR_REGEXP
-
все параметры типа медиа должны быть перед параметром q www.rfc-editor.org/rfc/rfc7231#section-5.3.2
- TRAILING_STAR_REGEXP
Атрибуты
Публичные методы класса
# 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 # File actionpack/lib/action_dispatch/http/mime_type.rb, line 169 def lookup_by_extension(extension) EXTENSION_LOOKUP[extension.to_s] end
# 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 # 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]
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 # 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 Для входных данных '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]].
# 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
# 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 # 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
Регистрирует псевдоним, который не используется при поиске MIME типа, но может быть использован напрямую. Особенно полезно для отображения различных версий HTML в зависимости от пользователя, например, для iPhone.
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 160 def register_callback(&block) @register_callbacks << block end
# 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 Этот метод противоположен методу register.
Чтобы удалить MIME тип:
Mime::Type.unregister(:mobile)
Публичные методы экземпляра
# 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 # 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 # 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 # File actionpack/lib/action_dispatch/http/mime_type.rb, line 320 def all?; false; end
# 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 # File actionpack/lib/action_dispatch/http/mime_type.rb, line 316
def html?
(symbol == :html) || @string.include?("html")
end # 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 # File actionpack/lib/action_dispatch/http/mime_type.rb, line 278 def ref symbol || to_s end
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 266 def to_s @string end
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 270 def to_str to_s end
# File actionpack/lib/action_dispatch/http/mime_type.rb, line 274 def to_sym @symbol end
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.