Parent

Methods

Included Modules

ActionMailer::Part

Represents a subpart of an email message. It shares many similar attributes of ActionMailer::Base. Although you can create parts manually and add them to the parts list of the mailer, it is easier to use the helper methods in ActionMailer::PartContainer.

Public Class Methods

new(params) click to toggle source

Create a new part from the given params hash. The valid params keys correspond to the accessors.

# File lib/action_mailer/part.rb, line 38
def initialize(params)
  @content_type = params[:content_type]
  @content_disposition = params[:disposition] || "inline"
  @charset = params[:charset]
  @body = params[:body]
  @filename = params[:filename]
  @transfer_encoding = params[:transfer_encoding] || "quoted-printable"
  @headers = params[:headers] || {}
  @parts = []
end

Public Instance Methods

to_mail(defaults) click to toggle source

Convert the part to a mail object which can be included in the parts list of another mail object.

# File lib/action_mailer/part.rb, line 51
def to_mail(defaults)
  part = TMail::Mail.new

  real_content_type, ctype_attrs = parse_content_type(defaults)

  if @parts.empty?
    part.content_transfer_encoding = transfer_encoding || "quoted-printable"
    case (transfer_encoding || "").downcase
      when "base64" then
        part.body = TMail::Base64.folding_encode(body)
      when "quoted-printable"
        part.body = [normalize_new_lines(body)].pack("M*")
      else
        part.body = body
    end

    # Always set the content_type after setting the body and or parts!
    # Also don't set filename and name when there is none (like in
    # non-attachment parts)
    if content_disposition == "attachment"
      ctype_attrs.delete "charset"
      part.set_content_type(real_content_type, nil,
        squish("name" => filename).merge(ctype_attrs))
      part.set_content_disposition(content_disposition,
        squish("filename" => filename).merge(ctype_attrs))
    else
      part.set_content_type(real_content_type, nil, ctype_attrs)
      part.set_content_disposition(content_disposition) 
    end        
  else
    if String === body
      @parts.unshift Part.new(:charset => charset, :body => @body, :content_type => 'text/plain')
      @body = nil
    end
      
    @parts.each do |p|
      prt = (TMail::Mail === p ? p : p.to_mail(defaults))
      part.parts << prt
    end
    
    if real_content_type =~ /multipart/
      ctype_attrs.delete 'charset'
      part.set_content_type(real_content_type, nil, ctype_attrs)
    end
  end

  headers.each { |k,v| part[k] = v }

  part
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.