用vmime收取邮件/解析邮件 教程

用vmime收取邮件

vmime对邮件格式和邮件协议做了很好的封装，使用起来还是非常方便的。
vmime对于邮件协议都封装在vmime::net名字空间中，主要要用到的对象，有：
vmime::net::session，主要用于维护和服务器之间的连接
vmime::net::store，表示一个邮件存储，这是一个基类，没种邮件协议都有自己的store（如POP3Store，IMAPStore）
vmime::net::folder，表示邮件存储上的文件夹，和store一样，每种邮件协议，都有自己的folder实现
vmime::net::message，表示一封网络邮件，和vmime::message不同，vmime::net::message可能只有邮件的一部分，如邮件头等信息（由使用的邮件协议决定）。
vmime会根据session中设置的邮件协议，创建对应的store。
一些常用操作的实现（POP3协议）：
连接邮箱：
vmime::utility::ref session = vmime::create(); //创建session
vmime::utility::ref store = session->getStore(vmine_url); //获得store
store->connect();//连接
vmime::utility::reffolder = store->getDefaultFolder();//创建folder，路径是默认路径(inbox)
folder->open(vmime::net::folder::MODE_READ_WRITE);//以读写的形式打开
获取邮件：
std::vector > allMessages = folder->getMessages();
folder->fetchMessages(allMessages, vmime::net::folder::FETCH_ENVELOPE);  //获取所有邮件的头部信息，包含sender, recipients, date, subject
vmime::string mailContent;
vmime::utility::outputStreamStringAdapter out(mailContent);
resultMsg->extract(out);  //找到需要的邮件后，下载到本地，保存到string中，这里vmime::string是std::string的typedef
删除邮件：
folder->deleteMessage(resultMsg->getNumber()); //执行删除指令
folder->close(true);//关闭文件夹，真正对邮件进行删除
使用当中出现的问题：
按照vmime-book中的例子，在获取邮件的时候，增加了vmime::net::folder::FETCH_FLAGS标签后，会抛出异常，提示不支持该操作。
还有执行了folder->deleteMessage函数之后，邮件没有真正删除。通过抓包和查看源代码后发现，deleteMessage函数是对邮件服务器发送了DELE指令，但是邮件服务器不会立即执行，需要QUIT之后才会真正的删除。而在folder的析构函数中，调用的是folder->close(false)函数来关闭文件夹的，这样在发送QUIT命令之前，会向邮件服务器发送一个RSET命令，将已经被标记为删除的邮件状态充值，所以不会真正的删除邮件。目前只有在执行了删除命令后，显式执行close(true)函数，确保马上发送QUIT命令，让服务器删除邮件。
上述命令真正执行的POP3命令为：
#连接
USER xxx    #用户名
PASS xxx    #密码
STAT         #查询邮件数量和大小
TOP 1 0     #查看序号为1的邮件的头部
RETR 1      #接受第一封邮件的所有内容
DELE 1      #删除第一封邮件
QUIT          #退出，服务器执行删除操作

vmime解析邮件

解析邮件相对比较简单，需要将收取的邮件，重新从字符串转换成vmime::message格式，然后就可以获取到自己需要部分的内容了。
首先将vmime::string格式转换为vmime::message：
vmime::utility::ref mail = vmime::create();
mail->parse(mailContent);
vmime还提供了一个简单的帮助类vmime::messageParser方便对message进行解析。
message主要包含了邮件头和邮件内容，内容又因为multi-part的邮件格式规定，被拆分成了多个vmime::textPart。通常使用到的textPart的子类，有vmime::htmlTextPart和vmime::plainTextPart，分别对应邮件body中的content-type为text/html和text/plain。
代码：
vmime::messageParser mp(mail);
    for (int i = 0; i < mp.getTextPartCount(); ++i)  //遍历所有的textPart
    {
        vmime::utility::ref text = mp.getTextPartAt(i);
        if (text->getType().getSubType() == vmime::mediaTypes::TEXT_HTML) //text/html
        {
   vmime::utility::ref htmlText = text.dynamicCast();   
  
   vmime::utility::outputStreamStringAdapter htmlOut(htmlContent);
   vmime::utility::charsetFilteredOutputStream utf8Out(htmlText->getCharset(), vmime::charset(“utf-8″), htmlOut); //强制转换正文为utf8编码
   htmlText->getText()->extract(utf8Out);
   utf8Out.flush();
        }
        else if (text->getType().getSubType() == vmime::mediaTypes::TEXT_PLAIN) //text/plain
{
   vmime::utility::ref plainText = text.dynamicCast();
   vmime::utility::outputStreamStringAdapter plainOut(plainTextContent);
   vmime::utility::charsetFilteredOutputStream utf8Out(plainText->getCharset(), vmime::charset(“utf-8″), plainOut);
   plainText->getText()->extract(utf8Out);
   utf8Out.flush();
}
    }

对于html个是的邮件正文，还可以遍历获取里面的embeddedObject，如嵌入的附件图片等，不过目前没有这样的需求，就没有去尝试了。
在真正执行的时候，又发现了一个问题，必须在开始使用前，调用vmime::platform::setHandler();设置平台相关的handler，这里设置的是符合posix的平台，windows貌似也有对应的handler。