NAME
    MMS::Mail::Message - A class representing an MMS (or picture) message
    sent via email.

VERSION
    Version 0.06

SYNOPSIS
    This class is used by MMS::Mail::Parser to provide an itermediate data
    storage class after the MMS has been parsed by the "parse" method but
    before it has been through the second stage of parsing (the
    MMS::Mail::Parser "provider_parse" method). If this doesn't make sense
    then take a look at MMS::Mail::Parser to get an idea where this module
    fits in before progressing any further.

METHODS
    The following are the top-level methods of the MMS::Mail::Message class.

  Constructor
    "new()"
        Return a new MMS::Mail::Message object. Valid attributes are any
        public accessor outlined in the Regular Methods section below.

  Regular Methods
    "header_datetime" STRING
        Instance method - Returns the time and date the MMS was received
        when invoked with no supplied parameter. When supplied with a
        parameter it sets the object property to the supplied parameter.

    "header_from" STRING
        Instance method - Returns the sending email address the MMS was sent
        from when invoked with no supplied parameter. When supplied with a
        parameter it sets the object property to the supplied parameter.

    "header_to" STRING
        Instance method - Returns the recieving email address the MMS was
        sent to when invoked with no supplied parameter. When supplied with
        a parameter it sets the object property to the supplied parameter.

    "header_subject" STRING
        Instance method - Returns the MMS subject when invoked with no
        supplied parameter. When supplied with a parameter it sets the
        object property to the supplied parameter.

    "header_received_from" STRING
        Instance method - Returns the email server that (last) sent the mms
        when invoked with no supplied parameter. When supplied with a
        parameter it sets the object property to the supplied parameter.

    "body_text" STRING
        Instance method - Returns the MMS bodytext when invoked with no
        supplied parameter. When supplied with a paramater it sets the
        object property to the supplied parameter.

    "strip_characters" STRING
        Instance method - The supplied string should be a set of characters
        valid for use in a regular expression character class "s/[]//g".
        When set with a value the property is used by the "header_from",
        "header_to", "header_datetime", "body_text" and "header_subject"
        methods to remove these characters from their respective properties
        (in both the "MMS::Mail::Message" and "MMS::Mail::Message::Parsed"
        classes).

    "cleanse_map" HASHREF
        Instance method - This method allows a regular expression or
        subroutine reference to be applied when an accessor sets a value,
        allowing message values to be cleansed or modified. These accessors
        are "header_from", "header_to", "body_text", "header_datetime" and
        "header_subject".

        The method expects a hash reference with key values as one of the
        above public accessor method names and values as a scalar in the
        form of a regular expression or as a subroutine reference.

    "attachments" ARRAYREF
        Instance method - Returns an array reference to the array of MMS
        message attachments. When supplied with a parameter it sets the
        object property to the supplied parameter.

    "add_attachment" MIME::Entity
        Instance method - Adds the supplied "MIME::Entity" attachment to the
        attachment stack for the message. This method is mainly used by the
        "MMS::Mail::Parser" class to add attachments while parsing.

    "is_valid"
        Instance method - Returns true or false depending if the
        "header_datetime", "header_from" and "header_to" fields are all
        populated or not.

    "set"
        Instance method - Overides the Class::Accessor superclass set method
        to apply cleanse_map and strip_character functionality to accessors.

AUTHOR
    Rob Lee, "<robl at robl.co.uk>"

BUGS
    Please report any bugs or feature requests to
    "bug-mms-mail-message@rt.cpan.org", or through the web interface at
    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MMS-Mail-Message>. I
    will be notified, and then you'll automatically be notified of progress
    on your bug as I make changes.

NOTES
    Please read the Perl artistic license ('perldoc perlartistic') :

    10. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
    WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
    MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

ACKNOWLEDGEMENTS
    As per usual this module is sprinkled with a little Deb magic.

COPYRIGHT & LICENSE
    Copyright 2005 Rob Lee, all rights reserved.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

SEE ALSO
    MMS::Mail::Message, MMS::Mail::Message::Parsed, MMS::Mail::Provider