Class: Mapi::Attachment

Inherits:
Item
  • Object
show all
Defined in:
lib/mapi/base.rb,
lib/mapi/convert/note-mime.rb,
lib/mapi/convert/note-tmail.rb

Overview

a general attachment class. is subclassed by Msg and Pst attachment classes

Direct Known Subclasses

Msg::Attachment, Pst::Attachment

Instance Attribute Summary

Attributes inherited from Item

#properties

Instance Method Summary collapse

Methods inherited from Item

#initialize

Constructor Details

This class inherits a constructor from Mapi::Item

Instance Method Details

#data ⇒ Object 



22
23
24
 
# File 'lib/mapi/base.rb', line 22

def data
  @embedded_msg || @embedded_ole || props.attach_data
end

#filename ⇒ Object 



18
19
20
 
# File 'lib/mapi/base.rb', line 18

def filename
  props.attach_long_filename || props.attach_filename
end

#inspect ⇒ Object 



37
38
39
40
41
 
# File 'lib/mapi/base.rb', line 37

def inspect
  "#<#{self.class.to_s[/\w+$/]}" +
    (filename ? " filename=#{filename.inspect}" : '') +
    (@embedded_ole ? " embedded_type=#{@embedded_ole.embedded_type.inspect}" : '') + ">"
end

#save(io) ⇒ Object

with new stream work, its possible to not have the whole thing in memory at one time, just to save an attachment

a = msg.attachments.first a.save open(File.basename(a.filename || ‘attachment’), ‘wb’)



31
32
33
34
35
 
# File 'lib/mapi/base.rb', line 31

def save io
  raise "can only save binary data blobs, not ole dirs" if @embedded_ole
  data.rewind
  io << data.read(8192) until data.eof?
end

#to_mime ⇒ Object 



225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
 
# File 'lib/mapi/convert/note-mime.rb', line 225

def to_mime
  # TODO: smarter mime typing.
  mimetype = props.attach_mime_tag || 'application/octet-stream'
  mime = Mime.new "Content-Type: #{mimetype}\r\n\r\n"
  mime.headers['Content-Disposition'] = [%{attachment; filename="#{filename}"}]
  mime.headers['Content-Transfer-Encoding'] = ['base64']
  mime.headers['Content-Location'] = [props.attach_content_location] if props.attach_content_location
  mime.headers['Content-ID'] = [props.attach_content_id] if props.attach_content_id
  # data.to_s for now. data was nil for some reason.
  # perhaps it was a data object not correctly handled?
  # hmmm, have to use read here. that assumes that the data isa stream.
  # but if the attachment data is a string, then it won't work. possible?
  data_str = if @embedded_msg
    mime.headers['Content-Type'] = 'message/rfc822'
    # lets try making it not base64 for now
    mime.headers.delete 'Content-Transfer-Encoding'
    # not filename. rather name, or something else right?
    # maybe it should be inline?? i forget attach_method / access meaning
    mime.headers['Content-Disposition'] = [%{attachment; filename="#{@embedded_msg.subject}"}]
    @embedded_msg.to_mime.to_s
  elsif @embedded_ole
    # kind of hacky
    io = StringIO.new
    Ole::Storage.new io do |ole|
      ole.root.type = :dir
      Ole::Storage::Dirent.copy @embedded_ole, ole.root
    end
    io.string
  else
    # FIXME: shouldn't be required
    data.read.to_s rescue ''
  end
  mime.body.replace @embedded_msg ? data_str : Base64.encode64(data_str).gsub(/\n/, "\r\n")
  mime
end

#to_tmail ⇒ Object 



237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
 
# File 'lib/mapi/convert/note-tmail.rb', line 237

def to_tmail
  # TODO: smarter mime typing.
  mimetype = props.attach_mime_tag || 'application/octet-stream'
  part = TMail::Mail.parse "Content-Type: #{mimetype}\r\n\r\n"
  part['Content-Disposition'] = %{attachment; filename="#{filename}"}
  part['Content-Transfer-Encoding'] = 'base64'
  part['Content-Location'] = props.attach_content_location if props.attach_content_location
  part['Content-ID'] = props.attach_content_id if props.attach_content_id
  # data.to_s for now. data was nil for some reason.
  # perhaps it was a data object not correctly handled?
  # hmmm, have to use read here. that assumes that the data isa stream.
  # but if the attachment data is a string, then it won't work. possible?
  data_str = if @embedded_msg
    raise NotImplementedError
    mime.headers['Content-Type'] = 'message/rfc822'
    # lets try making it not base64 for now
    mime.headers.delete 'Content-Transfer-Encoding'
    # not filename. rather name, or something else right?
    # maybe it should be inline?? i forget attach_method / access meaning
    mime.headers['Content-Disposition'] = [%{attachment; filename="#{@embedded_msg.subject}"}]
    @embedded_msg.to_mime.to_s
  elsif @embedded_ole
    raise NotImplementedError
    # kind of hacky
    io = StringIO.new
    Ole::Storage.new io do |ole|
      ole.root.type = :dir
      Ole::Storage::Dirent.copy @embedded_ole, ole.root
    end
    io.string
  else
    data.read.to_s
  end
  part.body = @embedded_msg ? data_str : Base64.encode64(data_str).gsub(/\n/, "\r\n")
  part
end