Snake.Net网络通讯模块 - POP3(二)

本页内容

简介
与POP3服务器的通讯
下载邮件
下载邮件到指定文件夹
下载邮件头部信息
删除邮件

　

　

简介

POP的全称是 Post Office Protocol ，即邮局协议，用于电子邮件的接收，它使用TCP的110端口，现在常用的是第三版 ，所以简称为 POP3。POP3仍采用Client/Server工作模式，。当客户机需要服务时，客户端的软件（OutlookExpress或FoxMail）将与POP3服务器建立TCP连接，此后要经过POP3协议的三种工作状态，首先是认证过程，确认客户机提供的用户名和密码，在认证通过后便转入处理状态，在此状态下用户可收取自己的邮件或做邮件的删除，在完成响应的操作后客户机便发出quit命令，此后便进入更新状态，将做删除标记的邮件从服务器端删除掉。到此为止整个POP过程完成。
在命名空间Eastasp.Framework.Net.Mail.Pop3下，Snake.Net提供一系列类和函数，可以为开发者提供全面而完善的使用POP3协议接受邮件的功能。现在主要介绍Pop3Client和Pop3Express两个类是如何实现发送邮件的功能。
　

与POP3服务器的通讯

让我们先来看一段代码，然后简单了解一下如何获取POP3服务器的信息。

//declare
Pop3Client client;
StatInfo statInfo;
ListInfo[] infoList;
UidInfo[] uidInfoList;

client = new Pop3Client(new Pop3Server("pop.mailserver.com", "user", "pass"));

try{
client.Open();

//send noop comand
client.Noop();

//get box stat
statInfo = client.Stat();

//list mail
infoList = client.List();
uidInfoList = client.UidList();
}
finally{
if (client != null){
client.Close();
client = null;
}
}
从上面的代码中，我们可以看到，Pop3Client先与服务器连接，然后依次调用了三个方法Stat，List和UidList以获取服务器信息。接下来我们就简单叙述一下这三个方法的功能。
Stat方法是获取服务器上所有邮件的信息，它将返回一个StatInfo结构体，用于描述服务器上当前所有邮件的总数和占用空间。
List方法是获取服务器上单个邮件的序号（整数型）和占用空间，它将返回一个ListInfo结构体的数组。
UidList方法和List方法类似，不过返回的是单个邮件的唯一标识符（字符型）和占用的空间，它将返回一个UidInfo结构体的数组。

下载邮件

在上一节中我们了解了如何获取Pop3信箱的摘要信息，现在我们就要步入正题，如何接受邮件，请看下列演示代码。

//declare
Pop3Client client;
string uid;
ListInfo[] infoList;
MailMessage.Message[] messages;

client = new Pop3Client(new Pop3Server("pop.mailserver.com", "user", "pass"));

try{
client.Open();
client.Noop();

infoList = client.List();

if (infoList.Length > 0){
messages = new MailMessage.Message[infoList.Length];
for(int i = 0; i < infoList.Length; i++){
uid = client.GetUid(infoList[i].Order);
messages[i] = client.GetMessage(infoList[i].Order);
}
}
}
finally{
if (client != null){
client.Close();
client = null;
}
}
上面的代码我们可以看到接受邮件的过程是，先询问服务器获取一个邮件编号列表，然后根据邮件的制定编号获取邮件内容。上面的代码演示了POP3服务通讯的基本过程，在实际应用中我们不需要每次都那么麻烦，可以使用Pop3Express对象，实现一种跟简单的接受邮件方式。请看下面的代码：
　

//declare
MailMessage.Message[] messages;

messages = Pop3Express.GetAllMessages(
new Pop3Server("pop.mailserver.com", "user", "pass"),
Pop3ReceiveMode.RecevieWithoutDelete);
利用Pop3Express只需调用GetAllMessages方法就可以简单实现，前段代码所实现的功能了。在这里我们要注意GetAllMessages方法的第二个参数recevieMode。它有三个值ReceiveAllThenDelete，ReceiveOneDeleteOne和RecevieWithoutDelete。顾名思义ReceiveAllThenDelete表示等下载完所有邮件在删除所有邮件，ReceiveOneDeleteOne表示下载一封邮件就删除一封邮件，RecevieWithoutDelete表示仅仅下载邮件并不对它执行删除行为。

下载邮件到指定文件夹

在上一节中我们讲述了如何下载邮件，我们可以发现Pop3Client的GetMessage方法返回的是一个MailMessage.Message对象实列，有时候我们并不需要返回这样一个对象，只需要将邮件的内容保存为单独的文件，让其他程序进行处理。因而Pop3Client还提供了另外一个方法SaveMessage用以将邮件内容保存为文件，请看下面代码。

//declare
string savePath;
Pop3Client client;
string uid;
ListInfo[] infoList;

savePath = @"c:\pop3mails";

client = new Pop3Server("pop.mailserver.com", "user", "pass");

try{
if (!Directory.Exists(savePath)) Directory.CreateDirectory(savePath);
client.Open();
client.Noop();

infoList = client.List();

if (infoList.Length > 0){
for(int i = 0; i < infoList.Length; i++){
uid = client.GetUid(infoList[i].Order).Replace(":", "");
client.SaveMessage(string.Format("{0}\\{1}.eml", savePath, infoList[i].Order), infoList[i].Order);
}
}
}
finally{
if (client != null){
client.Close();
client = null;
}
}
下载邮件头部信息

有些时候，我们并不想下载整个邮件，但有希望了解一下邮件大致内容。在这种情况下，我们可以先获取邮件的头部信息，然后根据标题、发件人等内容再决定是否需要下载整个邮件或者删除邮件。Pop3Client提供了GetMessageHeader方法用于获取邮件头部信息，请参照如下代码：

//declare
Pop3Client client;
ListInfo[] infoList;
Pop3MessageHeader[] headers;

try{
client = new Pop3Server("pop.mailserver.com", "user", "pass");

client.Open(); client.Noop();

infoList = client.List();
headers = new Pop3MessageHeader[infoList.Length];
for(int i = 0; i < headers.Length; i++){
headers[i] = client.GetMessageHeader(infoList[i].Order);
}
}
finally{
if (client != null){
client.Close();
client = null;
}
}
删除邮件

使用POP3下载邮件完后，邮件副本依旧保存在服务器，需要进行删除操作。Pop3Client提供Delete方法删除服务器上的邮件，请看下面代码。

//declare
Pop3Client client;
ListInfo[] infoList;
Pop3MessageHeader[] headers;

try{
client = new Pop3Server("pop.mailserver.com", "user", "pass");
client.Open(); client.Noop();
infoList = client.List();

headers = new Pop3MessageHeader[infoList.Length];
for(int i = 0; i < headers.Length; i++){
headers[i] = client. Delete (infoList[i].Order);
}
}
finally{
if (client != null){
client.Close();
client = null;
}
}
当然也可以使用Pop3Express，进行简化操作。

//declare
MailMessage.Message[] messages;

messages = Pop3Express.DeleteAllMessages (
new Pop3Server("pop.mailserver.com", "user", "pass"));