Example 29 presents a complete program that creates a multipart MIME message. The program creates a multipart message that contains the same text in three formats: unencoded, base 64 encoded, and quoted-printable encoded. Source code for this program is located in MultipartMimeMessageComposition.cpp in the examples\mime directory.
Sample programs are located in the examples directory created for your installation. For more information, see Installing and Building Your SourcePro C++ Products and Building Your Applications.
#include <rw/mime/RWMimeMultipart.h>
#include <rw/mime/RWMimeMultipartType.h>
#include <rw/mime/RWMimePart.h>
#include <rw/mime/RWMimeTextType.h>
#include <rw/mime/RWMimeContentTransferEncodingHeader.h>
#include <rw/mime/RWMimeUtils.h>
#include <rw/mime/RWMimeGenericHeader.h>
#include <rw/mime/RWMimeVersionHeader.h>
#if defined(RW_NO_IOSTD)
# include <iostream.h>
#else
# include <iostream>
using std::cout;
using std::endl;
#endif
int main(void)
{
// Generate the headers that we will use for the inner parts
// of the message. All parts will be in plain text.
RWMimeTextType textType("plain"); //1
// We need Content-Transfer-Encoding headers for the two
// messages that are encoded.
RWMimeContentTransferEncodingHeader
base64CTE(RWMimeUtils::Base64); //2
RWMimeContentTransferEncodingHeader
qpCTE(RWMimeUtils::QuotedPrintable); //3
// The parts will need a body to be sent.
RWCString partBody("This is a part in a (multipart) message "
"generated with the Rogue Wave SourcePro "
"Net product.\n"
"\n"
"All of the parts of this message are "
"identical, however they've been encoded "
"for transport using different methods."
"\n"); //4
// convert the body of the message to canonical form before
// transmitting or encoding.
partBody = RWMimeUtils::replaceLineDelimiter(partBody); //5
// Now we need to encode the body of the message from
// transport. For this example, we'll encode the same message
// using base64 and quoted-printable encodings.
RWCString partBodyBase64 =
RWMimeUtils::encode(partBody, RWMimeUtils::Base64); //6
RWCString partBodyQP =
RWMimeUtils::encode(partBody,
RWMimeUtils::QuotedPrintable); //7
// Now we are ready to create the individual parts of the
// message. For this example, there will be three parts. One
// unencoded, one encoded using base64, and one encoded
// using quoted-printable.
RWMimePart part1(textType),
part2(textType),
part3(textType); //8
// unencoded part
part1.setBody(partBody); //9
// base64 encoded
part2.insertHeader(base64CTE); //10
part2.setBody(partBodyBase64); //11
// quoted-printable encoded
part3.insertHeader(qpCTE); //12
part3.setBody(partBodyQP); //13
RWMimeMultipartType multipartType("mixed"); //14
// Create the basic message object. This will hold all of the message
// parts, and format them according to the MIME specification.
RWMimeMultipart message(multipartType); //15
// Generate the headers required for the main message.
// Use a generic header to create headers that don't have a
// derived header type.
RWMimeGenericHeader toHeader("To",
"<developer@yourcompany.com>"); //16
RWMimeGenericHeader fromHeader("From",
"<developer@roguewave.com>");
RWMimeGenericHeader subjectHeader("Subject",
"Sample MIME Multipart Message from Rogue Wave");
// Add each of the headers to the message.
message.insertHeader(RWMimeVersionHeader()); //17
message.insertHeader(toHeader); //18
message.insertHeader(fromHeader);
message.insertHeader(subjectHeader);
// We'll also want to send a preamble to the message for
// user agents that don't recognize MIME.
RWCString preamble(
"This is a MIME 1.0 compliant message.\n"
"\n"
"If you are able to see this message, your\n"
"user agent is not MIME compliant. You will\n"
"need an alternative mail viewer to read this\n"
"message in its entirety.\n"); //19
preamble = RWMimeUtils::replaceLineDelimiter(preamble); //20
message.setPreamble(preamble); //21
// Insert each of the parts into the multipartBody.
message.insertPart(part1); //22
message.insertPart(part2);
message.insertPart(part3);
// The message is ready to go. Normally you would send this
// through a protocol (SMTP, HTTP), but for this example we
// will just print it to stdout.
cout << message.asString() << endl; //23
return 0;
}
|
| //1 | Creates an RWMimeTextType for the value "text/plain". |
| //2 | Constructs a Content-Transfer-Encoding header for base 64 encoding. |
| //3 | Constructs a Content-Transfer-Encoding header for quoted-printable encoding. |
| //4 | Constructs the string that forms the basic content for each part of the multipart message. |
| //5 | Converts the content string to canonical form. |
| //6 | Encodes the content string using base 64 encoding and stores the result in a new string. |
| //7 | Encodes the content string using quoted-printable encoding and stores the result in a new string. |
| //8 | Constructs three new RWMimePart objects. Each object has a Content-Type header with the value textType. |
| //9 | Sets the body of the first MIME part to the unencoded content. |
| //10 | Inserts the Content-Transfer-Encoding header for base 64 encoding into the second MIME part. |
| //11 | Sets the body of the second MIME part to the base 64 encoded content. |
| //12 | Inserts the Content-Type header for text/plain into the third MIME part. |
| //13 | Inserts the Content-Transfer-Encoding header for quoted-printable encoding into the third MIME part. |
| //14 | Constructs an RWMimeMultipartType for multipart/mixed content. The constructor automatically generates a boundary string. |
| //15 | Constructs an RWMimeMultipart with the multipart/mixed C-ontent-Type created on line //14. |
| //16 | Each of the next three lines creates an email header for the MIME message. The headers are instances of RWMimeGenericHeader. The MIME package provides RWMimeGenericHeader for headers that are not part of the MIME specification. |
| //17 | Inserts a MIME-Version header into the part. A MIME message requires a MIME-Version header. A default-constructed RWMimeVersionHeader contains the correct version number. |
| //18 | Each of the next three lines inserts a header into the part. |
| //19 | Creates a preamble for the multipart message. Although the MIME specification doesn't require a multipart message to contain a preamble, most multipart messages provide one. |
| //20 | Converts the preamble to canonical form. |
| //21 | Sets the preamble of the multipart body. |
| //22 | Each of the next three lines inserts a MIME part into the multipart body. |
| //23 | Prints the message to standard output. A production application would typically enclose the asString() function in a try block, since the function throws an RWMimeError if it can't create a MIME string with the correct syntax. Since this example uses a constant string, we've left out the try block for clarity. |
The exact output of the program varies since the automatically-generated boundary string includes a timestamp. Further, we've wrapped some of the longer lines. Taking those differences into account, the output of the program is similar to:
Content-Type: multipart/mixed; boundary="_=_next_part_-560821453_=_" MIME-Version: 1.0 To: <developer@yourcompany.com> From: <developer@roguewave.com> Subject: Sample MIME Multipart Message from Rogue Wave This is a MIME 1.0 compliant message. If you are able to see this message, your user agent is not MIME compliant. You will need an alternative mail viewer to read this message in its entirety. --_=_next_part_-560821453_=_ Content-Type: text/plain This is a part in a (multipart) message generated with the Rogue Wave SourcePro Net product. All of the parts of this message are identical, however they've been encoded for transport using different methods. --_=_next_part_-560821453_=_ Content-Type: text/plain Content-Transfer-Encoding: base64 VGhpcyBpcyBhIHBhcnQgaW4gYSAobXVsdGlwYXJ0KSBtZXNzYWdlIGdlbmVyYXRlZCB3aXRo IHRoZSBSb2d1ZSBXYXZlIFNvdXJjZVBybyBOZXQgcHJvZHVjdC4NCg0KQWxsIG9mIHRoZSBw YXJ0cyBvZiB0aGlzIG1lc3NhZ2UgYXJlIGlkZW50aWNhbCwgaG93ZXZlciB0aGV5J3ZlIGJl ZW4gZW5jb2RlZCBmb3IgdHJhbnNwb3J0IHVzaW5nIGRpZmZlcmVudCBtZXRob2RzLg0K --_=_next_part_-560821453_=_ Content-Type: text/plain Content-Transfer-Encoding: quoted-printable This is a part in a (multipart) message generated with the Rogue Wave Sour= cePro Net product. All of the parts of this message are identical, however they've been encod= ed for transport using different methods. --_=_next_part_-560821453_=_-- |
Copyright © Rogue Wave Software, Inc. All Rights Reserved.
The Rogue Wave name and logo, and SourcePro, are registered trademarks of Rogue Wave Software. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.