Mime::Type - Ruby on Rails 中文

封装了 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

命名空间

类 Mime::Type::InvalidMimeType

方法

#

==,
===,
=~

A

all?

E

eql?

H

html?

L

lookup,
lookup_by_extension

M

match?

N

P

parse,
parse_data_with_trailing_star,
parse_trailing_star

R

ref,
register,
register_alias,
register_callback

T

to_s,
to_str,
to_sym

U

unregister

常量

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 167
def lookup(string)
  return LOOKUP[string] if LOOKUP.key?(string)

  # fallback to the media-type without parameters if it was not found
  string = string.split(";", 2)[0]&.rstrip
  LOOKUP[string] || Type.new(string)
end

lookup_by_extension(extension) 链接

来源: 显示 | 在 GitHub 上

# File actionpack/lib/action_dispatch/http/mime_type.rb, line 175
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 264
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 200
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 236
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 227
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 186
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 182
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 163
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 245
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 297
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 289
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 311
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 327
def all?; false; end

eql?(other) 链接

来源: 显示 | 在 GitHub 上

# File actionpack/lib/action_dispatch/http/mime_type.rb, line 304
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 323
def html?
  (symbol == :html) || @string.include?("html")
end

match?(mime_type) 链接

来源: 显示 | 在 GitHub 上

# File actionpack/lib/action_dispatch/http/mime_type.rb, line 317
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 285
def ref
  symbol || to_s
end

to_s() 链接

来源: 显示 | 在 GitHub 上

# File actionpack/lib/action_dispatch/http/mime_type.rb, line 273
def to_s
  @string
end

to_str() 链接

来源: 显示 | 在 GitHub 上

# File actionpack/lib/action_dispatch/http/mime_type.rb, line 277
def to_str
  to_s
end

to_sym() 链接

来源: 显示 | 在 GitHub 上

# File actionpack/lib/action_dispatch/http/mime_type.rb, line 281
def to_sym
  @symbol
end

类 Mime::Type < Object

常量

属性

类公共方法

lookup(string) 链接

lookup_by_extension(extension) 链接

new(string, symbol = nil, synonyms = []) 链接

parse(accept_header) 链接

parse_data_with_trailing_star(type) 链接

parse_trailing_star(accept_header) 链接

register(string, symbol, mime_type_synonyms = [], extension_synonyms = [], skip_lookup = false) 链接

register_alias(string, symbol, extension_synonyms = []) 链接

register_callback(&block) 链接

unregister(symbol) 链接

实例公共方法

==(mime_type) 链接

===(list) 链接

=~(mime_type) 链接

all?() 链接

eql?(other) 链接

html?() 链接

match?(mime_type) 链接

ref() 链接

to_s() 链接

to_str() 链接

to_sym() 链接