123456789_123456789_123456789_123456789_123456789_

Class: Mime::Type

Relationships & Source Files
Namespace Children
Classes:
Exceptions:
Extension / Inclusion / Inheritance Descendants
Subclasses:
Inherits: Object
Defined in: actionpack/lib/action_dispatch/http/mime_type.rb

Overview

Encapsulates the notion of a MIME type. Can be used at render time, for example, with:

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

Constant Summary

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(string, symbol = nil, synonyms = []) ⇒ Type

[ 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

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method) (private)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 336

def method_missing(method, ...)
  if method.end_with?("?")
    method[0..-2].downcase.to_sym == to_sym
  else
    super
  end
end

Class Method Details

.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

.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)

For an input of ‘text’, returns ‘[Mime, Mime, Mime, Mime, Mime, Mime, Mime, Mime, Mime]`.

For an input of ‘application’, returns ‘[Mime, Mime, Mime, Mime, Mime, Mime, Mime, Mime]`.

[ 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 = [])

Registers an alias that’s not used on MIME type lookup, but can be referenced directly. Especially useful for rendering different HTML versions depending on the user agent, like an 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)

This method is opposite of register method.

To unregister a MIME type:

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

Instance Attribute Details

#all?Boolean (readonly)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 327

def all?; false; end

#hash (readonly)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 255

attr_reader :hash

#html?Boolean (readonly)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 323

def html?
  (symbol == :html) || @string.include?("html")
end

#string (readonly, protected)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 330

attr_reader :string, :synonyms

#symbol (readonly)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 85

attr_reader :symbol

#synonyms (readonly, protected)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 330

attr_reader :string, :synonyms

Instance Method Details

#==(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

#eql?(other) ⇒ Boolean

[ 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

#match?(mime_type) ⇒ Boolean

[ 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

#respond_to_missing?(method, include_private = false) ⇒ Boolean (private)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 344

def respond_to_missing?(method, include_private = false)
  method.end_with?("?") || super
end

#to_a (private)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 334

def to_a; end

#to_ary (private)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/mime_type.rb', line 333

def to_ary; 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