Class: HTTP::Accept::MediaTypes::Map

Inherits:
Object
  • Object
show all
Defined in:
lib/http/accept/media_types/map.rb

Overview

Map a set of mime types to objects.

Constant Summary collapse

WILDCARD = 
"*/*".freeze

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Map

Returns a new instance of Map.



28
29
30
 
# File 'lib/http/accept/media_types/map.rb', line 28

def initialize
	@media_types = {}
end

Instance Method Details

#<<(object) ⇒ Object

Add a converter to the collection. A converter can be anything that responds to #content_type. Objects will be considered in the order they are added, subsequent objects cannot override previously defined media types. ‘object` must respond to #split(’/‘, 2) which should give the type and subtype.



66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
 
# File 'lib/http/accept/media_types/map.rb', line 66

def << object
	type, subtype = object.split('/', 2)
	
	# We set the default if not specified already:
	@media_types[WILDCARD] = object if @media_types.empty?
	
	if type != '*'
		@media_types["#{type}/*"] ||= object
		
		if subtype != '*'
			@media_types["#{type}/#{subtype}"] ||= object
		end
	end
	
	return self
end

#[](media_range) ⇒ Object 



61
62
63
 
# File 'lib/http/accept/media_types/map.rb', line 61

def [] media_range
	@media_types[media_range]
end

#[]=(media_range, object) ⇒ Object 



57
58
59
 
# File 'lib/http/accept/media_types/map.rb', line 57

def []= media_range, object
	@media_types[media_range] = object
end

#for(media_types) ⇒ Object

Given a list of content types (e.g. from browser_preferred_content_types), return the best converter. Media types can be an array of MediaRange or String values.



42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/http/accept/media_types/map.rb', line 42

def for(media_types)
	media_types.each do |media_range|
		mime_type = case media_range
			when String then media_range
			else media_range.mime_type
		end
		
		if object = @media_types[mime_type]
			return object, media_range
		end
	end
	
	return nil
end

#freeze ⇒ Object 



32
33
34
35
36
37
38
39
 
# File 'lib/http/accept/media_types/map.rb', line 32

def freeze
	unless frozen?
		@media_types.freeze
		@media_types.each{|key,value| value.freeze}
		
		super
	end
end