Module: MIME::DiscreteMediaFactory

Extended by:
ContentTypes
Defined in:
lib/mime/discrete_media_factory.rb

Overview

Module used only for initializing derived DiscreteMediaType objects.

Constant Summary

Constants included from ContentTypes

ContentTypes::CONTENT_TYPES

Class Method Summary collapse

Methods included from ContentTypes

file_type

Class Method Details

.create(file, content_type = nil) ⇒ Object

Creates a corresponding DiscreteMediaType subclass object for the given file based on file‘s filename extension. file can be a file path or File object.

content_type can be specified in order to override the auto detected content type. If the content_type cannot be detected, an UnknownContentError exception will be raised.

Creates and sets the singleton method path on the created object. The path method is utilized by other methods in the MIME library, therefore, eliminating redundant and explicit filename assignments.

Comparison Example

entity1 = open('/tmp/file1.txt')
entity2 = DiscreteMediaFactory.create('/tmp/file2.txt')

mixed_msg = Multipart::Mixed.new
mixed_msg.attach_entity(entity1.read, entity.path)
mixed_msg.attach_entity(entity2) # no path needed



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
 
# File 'lib/mime/discrete_media_factory.rb', line 34

def create file, content_type = nil
  if file.is_a? File
    cntnt = file.read
    ctype = content_type || file_type(file.path)
    fname = file.path
  else
    cntnt = IO.read(file)
    ctype = content_type || file_type(file)
    fname = file
  end

  type, subtype = ctype.to_s.split('/')
  if type.to_s.empty? || subtype.to_s.empty?
    raise UnknownContentError, "invalid content type: #{ctype}"
  end

  media_obj = 
    case type
    when 'application'; ApplicationMedia.new(cntnt, subtype)
    when 'audio'      ; AudioMedia.new(cntnt, subtype)
    when 'image'      ; ImageMedia.new(cntnt, subtype)
    when 'text'       ; TextMedia.new(cntnt, subtype)
    when 'video'      ; VideoMedia.new(cntnt, subtype)
    else raise UnknownContentError, "invalid content type: #{ctype}"
    end

  class << media_obj;  attr_accessor :path  end
  media_obj.path = fname
  media_obj
end