Class: Mime::Type
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 :text => post.to_ics, :mime_type => Mime::Type["text/calendar"] }
format.xml { render :xml => @people.to_xml }
end
end
end
Defined Under Namespace
Classes: AcceptItem
Class Method Summary collapse
- .lookup(string) ⇒ Object
- .lookup_by_extension(extension) ⇒ Object
- .parse(accept_header) ⇒ Object
- .register(string, symbol, mime_type_synonyms = [], extension_synonyms = [], skip_lookup = false) ⇒ Object
-
.register_alias(string, symbol, extension_synonyms = []) ⇒ Object
Registers an alias that’s not used on mime type lookup, but can be referenced directly.
Instance Method Summary collapse
- #==(mime_type) ⇒ Object
- #===(list) ⇒ Object
-
#initialize(string, symbol = nil, synonyms = []) ⇒ Type
constructor
A new instance of Type.
- #to_s ⇒ Object
- #to_str ⇒ Object
- #to_sym ⇒ Object
Constructor Details
#initialize(string, symbol = nil, synonyms = []) ⇒ Type
Returns a new instance of Type.
122 123 124 125 |
# File 'lib/action_controller/mime_type.rb', line 122 def initialize(string, symbol = nil, synonyms = []) @symbol, @synonyms = symbol, synonyms @string = string end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
#method_missing(method, *args) ⇒ Object (private)
155 156 157 158 159 160 161 162 |
# File 'lib/action_controller/mime_type.rb', line 155 def method_missing(method, *args) if method.to_s =~ /(\w+)\?$/ mime_type = $1.downcase.to_sym mime_type == @symbol || (mime_type == :html && @symbol == :all) else super end end |
Class Method Details
.lookup(string) ⇒ Object
47 48 49 |
# File 'lib/action_controller/mime_type.rb', line 47 def lookup(string) LOOKUP[string] end |
.lookup_by_extension(extension) ⇒ Object
51 52 53 |
# File 'lib/action_controller/mime_type.rb', line 51 def lookup_by_extension(extension) EXTENSION_LOOKUP[extension] end |
.parse(accept_header) ⇒ Object
70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 |
# File 'lib/action_controller/mime_type.rb', line 70 def parse(accept_header) # keep track of creation order to keep the subsequent sort stable list = [] accept_header.split(/,/).each_with_index do |header, index| params = header.split(/;\s*q=/) list << AcceptItem.new(index, *params) unless params.empty? end list.sort! # Take care of the broken text/xml entry by renaming or deleting it text_xml = list.index("text/xml") app_xml = list.index(Mime::XML.to_s) if text_xml && app_xml # set the q value to the max of the two list[app_xml].q = [list[text_xml].q, list[app_xml].q].max # make sure app_xml is ahead of text_xml in the list if app_xml > text_xml list[app_xml], list[text_xml] = list[text_xml], list[app_xml] app_xml, text_xml = text_xml, app_xml end # delete text_xml from the list list.delete_at(text_xml) elsif text_xml list[text_xml].name = Mime::XML.to_s end # Look for more specific xml-based types and sort them ahead of app/xml if app_xml idx = app_xml app_xml_type = list[app_xml] while(idx < list.length) type = list[idx] break if type.q < app_xml_type.q if type.name =~ /\+xml$/ list[app_xml], list[idx] = list[idx], list[app_xml] app_xml = idx end idx += 1 end end list.map! { |i| Mime::Type.lookup(i.name) }.uniq! list end |
.register(string, symbol, mime_type_synonyms = [], extension_synonyms = [], skip_lookup = false) ⇒ Object
61 62 63 64 65 66 67 68 |
# File 'lib/action_controller/mime_type.rb', line 61 def register(string, symbol, mime_type_synonyms = [], extension_synonyms = [], skip_lookup = false) Mime.instance_eval { const_set symbol.to_s.upcase, Type.new(string, symbol, mime_type_synonyms) } SET << Mime.const_get(symbol.to_s.upcase) ([string] + mime_type_synonyms).each { |string| LOOKUP[string] = SET.last } unless skip_lookup ([symbol.to_s] + extension_synonyms).each { |ext| EXTENSION_LOOKUP[ext] = SET.last } end |
.register_alias(string, symbol, extension_synonyms = []) ⇒ Object
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.
57 58 59 |
# File 'lib/action_controller/mime_type.rb', line 57 def register_alias(string, symbol, extension_synonyms = []) register(string, symbol, [], extension_synonyms, true) end |
Instance Method Details
#==(mime_type) ⇒ Object
147 148 149 150 151 152 |
# File 'lib/action_controller/mime_type.rb', line 147 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) ⇒ Object
139 140 141 142 143 144 145 |
# File 'lib/action_controller/mime_type.rb', line 139 def ===(list) if list.is_a?(Array) (@synonyms + [ self ]).any? { |synonym| list.include?(synonym) } else super end end |
#to_s ⇒ Object
127 128 129 |
# File 'lib/action_controller/mime_type.rb', line 127 def to_s @string end |
#to_str ⇒ Object
131 132 133 |
# File 'lib/action_controller/mime_type.rb', line 131 def to_str to_s end |
#to_sym ⇒ Object
135 136 137 |
# File 'lib/action_controller/mime_type.rb', line 135 def to_sym @symbol || @string.to_sym end |