NAME

Mail::Message::Convert - conversions between message types

CLASS HIERARCHY

Mail::Message::Convert
is a Mail::Reporter

SYNOPSIS

use Mail::Message::Convert::SomeThing;

my $convert = Mail::Message::Convert::SomeThing->new;
my Mail::Message $msg   = Mail::Message->new;
my SomeThing     $other = $convert->export($msg);

my SomeThing     $other = SomeThing->new;
my Mail::Message $msg   = $convert->from($other);

use Mail::Box::Manager;
my $mgr     = Mail::Box::Manager->new;
my $folder  = $mgr->open(folder => 'Outbox');
$folder->addMessage($other);

DESCRIPTION

This class is the base for various message converters, which can be used to translate to and from Mail::Message objects.

You do not have to convert into a Mail::Message explicitly, when you want to add a foreign message to Mail::Box folder.

The following converters are currently available:

• Mail::Message::Convert::MailInternet

  Converts the simple Mail::Internet messages into Mail::Message objects.

• Mail::Message::Convert::MimeEntity

  Converts the more complicated MIME::Entity messages into Mail::Message objects.

METHOD INDEX

The general methods for Mail::Message::Convert objects:

MR errors                            MR new OPTIONS
   export MESSAGE, OPTIONS           MR report [LEVEL]
   from OBJECT, OPTIONS              MR reportAll [LEVEL]
MR log [LEVEL [,STRINGS]]            MR trace [LEVEL]

The extra methods for extension writers:

MR AUTOLOAD                          MR logPriority LEVEL
MR DESTROY                           MR logSettings
MR inGlobalDestruction               MR notImplemented

Prefixed methods are described in MR = Mail::Reporter.

METHODS

export MESSAGE, OPTIONS

Returns a new message object based on the information from a Mail::Message object. The MESSAGE specified is an instance of a Mail::Message.

Examples:

my $convert = Mail::Message::Convert::SomeThing->new;
my Mail::Message $msg   = Mail::Message->new;
my SomeThing     $other = $convert->export($msg);

from OBJECT, OPTIONS

Returns a new Mail::Message object based on the information from an message-type which is strange to the Mail::Box set of modules.

Examples:

my $convert = Mail::Message::Convert::SomeThing->new;
my SomeThing     $other = SomeThing->new;
my Mail::Message $msg   = $convert->from($other);

SEE ALSO

Mail::Box-Overview

AUTHOR

Mark Overmeer (mailbox@overmeer.net). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

VERSION

This code is beta, version 2.00_20.

Copyright (c) 2001 Mark Overmeer. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.