《Effective C#》学习笔记（七）

using System;

using System.Net.Sockets;

using System.Net;

using System.Security.Cryptography;

using System.IO;

类名：Pop3        

功能：接收电子邮件         

/

namespace ZTSX.Email

{

 ///

 /// Pop3 的摘要说明。

 ///

 public class Pop3

 {

  private string mstrHost     = null;  //主机名称或IP地址

  private int mintPort     = 110;  //主机的端口号（默认为110）

  private TcpClient mtcpClient   = null;  //客户端

  private NetworkStream mnetStream  = null;  //网络基础数据流

  private StreamReader m_stmReader  = null;  //读取字节流

  private string mstrStatMessage   = null;  //执行STAT命令后得到的消息（从中得到邮件数）

  ///

  /// 构造函数

  ///

  /// 一个邮件接收对象

  public Pop3()

  {

  }

  ///

  /// 构造函数

  ///

  /// 主机名称或IP地址

  public Pop3(string host)

  {

   mstrHost = host;

  }

  ///

  /// 构造函数

  ///

  /// 主机名称或IP地址

  /// 主机的端口号

  /// 一个邮件接收对象

  public Pop3(string host,int port)

  {

   mstrHost = host;

   mintPort = port;

  }

  #region 属性

  ///

  /// 主机名称或IP地址

  ///

  /// 主机名称或IP地址

  public string HostName

  {

   get{return mstrHost;}

   set{mstrHost = value;}

  }

  ///

  /// 主机的端口号

  ///

  /// 主机的端口号

  public int Port

  {

   get{return mintPort;}

   set{mintPort = value;}

  }

  #endregion

  #region 私有方法

  ///

  /// 向网络访问的基础数据流中写数据（发送命令码）

  ///

  /// 可以用于网络访问的基础数据流

  /// 命令行

  /// 向网络访问的基础数据流中写数据（发送命令码）

  private void WriteToNetStream(ref NetworkStream netStream,String command)

  {

   string strToSend = command + "/r/n";

   byte[] arrayToSend = System.Text.Encoding.ASCII.GetBytes(strToSend.ToCharArray());

      netStream.Write(arrayToSend,0,arrayToSend.Length);

  }

  ///

  /// 检查命令行结果是否正确

  ///

  /// 命令行的执行结果

  /// 正确标志

  ///

  /// 类型：布尔

  /// 内容：true表示没有错误，false为有错误

  ///

  /// 检查命令行结果是否有错误

  private bool CheckCorrect(string message,string check)

  {

   if(message.IndexOf(check) == -1)

    return false;

   else

    return true;

  }

  ///

  /// 邮箱中的未读邮件数

  ///

  /// 执行完LIST命令后的结果

  ///

  /// 类型：整型

  /// 内容：邮箱中的未读邮件数

  ///

  /// 邮箱中的未读邮件数

  private int GetMailNumber(string message)

  {

   string[] strMessage = message.Split(' ');

   return Int32.Parse(strMessage[1]);

  }

  ///

  /// 得到经过解码后的邮件的内容

  ///

  /// 解码前的邮件的内容

  ///

  /// 类型：字符串

  /// 内容：解码后的邮件的内容

  ///

  /// 得到解码后的邮件的内容

  private string GetDecodeMailContent(string encodingContent)

  {

   string strContent = encodingContent.Trim();

   string strEncode = null;

   int iStart = strContent.IndexOf("Base64");

   if(iStart == -1)

    throw new Pop3Exception("邮件内容不是Base64编码，请检查");

   else

   {

    strEncode = strContent.Substring(iStart + 6,strContent.Length - iStart - 6);

    try

    {

     return SX.Encode.TransformToString(strEncode);

    }

    catch(SX.EncodeException exc)

    {

     throw new Pop3Exception(exc.Message);

    }

   }

  }

  #endregion

  ///

  /// 与主机建立连接

  ///

  ///

  /// 类型：布尔

  /// 内容：连接结果（true为连接成功，false为连接失败）

  ///

  /// 与主机建立连接

  public bool Connect()

  {

   if(mstrHost == null)

    throw new Exception("请提供SMTP主机名称或IP地址！");

   if(mintPort == 0)

    throw new Exception("请提供SMTP主机的端口号");

   try

   {

    mtcpClient = new TcpClient(mstrHost,mintPort);

    mnetStream = mtcpClient.GetStream();

    m_stmReader = new StreamReader(mtcpClient.GetStream());

    string strMessage = m_stmReader.ReadLine();

    if(CheckCorrect(strMessage,"+OK") == true)

     return true;

    else

     return false;

   }

   catch(SocketException exc)

   {

    throw new Pop3Exception(exc.ToString());

   }

   catch(NullReferenceException exc)

   {

    throw new Pop3Exception(exc.ToString());

   }

  }

  #region Pop3命令

  ///

  /// 执行Pop3命令，并检查执行的结果

  ///

  /// Pop3命令行

  ///

  /// 类型：字符串

  /// 内容：Pop3命令的执行结果

  ///

  private string ExecuteCommand(string command)

  {

   string strMessage = null;  //执行Pop3命令后返回的消息

   try

   {

    //发送命令

    WriteToNetStream(ref mnetStream,command);

    //读取多行

    if(command.Substring(0,4).Equals("LIST") || command.Substring(0,4).Equals("RETR") || command.Substring(0,4).Equals("UIDL")) //记录STAT后的消息（其中包含邮件数）

    {

     strMessage = ReadMultiLine();

     if(command.Equals("LIST")) //记录LIST后的消息（其中包含邮件数）

      mstrStatMessage = strMessage;

    }

     //读取单行

    else

     strMessage = m_stmReader.ReadLine();

    //判断执行结果是否正确

    if(CheckCorrect(strMessage,"+OK"))

     return strMessage;

    else

     return "Error";

   }

   catch(IOException exc)

   {

    throw new Pop3Exception(exc.ToString());

   }

  }

  ///

  /// 在Pop3命令中，LIST、RETR和UIDL命令的结果要返回多行，以点号（.）结尾，

  /// 所以如果想得到正确的结果，必须读取多行

  ///

  ///

  /// 类型：字符串

  /// 内容：执行Pop3命令后的结果

  ///

  private string ReadMultiLine()

  {

   string strMessage = m_stmReader.ReadLine();

   string strTemp = null;

   while(strMessage != ".")

   {

    strTemp = strTemp + strMessage;

    strMessage = m_stmReader.ReadLine();

   }

   return strTemp;

  }

  //USER命令

  private string USER(string user)

  {

   return ExecuteCommand("USER " + user) + "/r/n";

  }

  //PASS命令

  private string PASS(string password)

  {

   return ExecuteCommand("PASS " + password) + "/r/n";

  }

  //LIST命令

  private string LIST()

  {

   return ExecuteCommand("LIST") + "/r/n";

  }

  //UIDL命令

  private string UIDL()

  {

   return ExecuteCommand("UIDL") + "/r/n";

  }

  //NOOP命令

  private string NOOP()

  {

   return ExecuteCommand("NOOP") + "/r/n";

  }

  //STAT命令

  private string STAT()

  {

   return ExecuteCommand("STAT") + "/r/n";

  }

  //RETR命令

  private string RETR(int number)

  {

   return ExecuteCommand("RETR " + number.ToString()) + "/r/n";

  }

  //DELE命令

  private string DELE(int number)

  {

   return ExecuteCommand("DELE " + number.ToString()) + "/r/n";

  }

  //QUIT命令

  private void Quit()

  {

   WriteToNetStream(ref mnetStream,"QUIT");

  }

  ///

  /// 收取邮件

  ///

  /// 用户名

  /// 口令

  ///

  /// 类型：字符串数组

  /// 内容：解码前的邮件内容

  ///

  private string[] ReceiveMail(string user,string password)

  {

   int iMailNumber = 0;  //邮件数

   if(USER(user).Equals("Error"))

    throw new Pop3Exception("用户名不正确！");

   if(PASS(password).Equals("Error"))

    throw new Pop3Exception("用户口令不正确！");

   if(STAT().Equals("Error"))

    throw new Pop3Exception("准备接收邮件时发生错误！");

   if(LIST().Equals("Error"))

    throw new Pop3Exception("得到邮件列表时发生错误！");

   try

   {

    iMailNumber = GetMailNumber(mstrStatMessage);

    //没有新邮件

    if(iMailNumber == 0)

     return null;

    else

    {

     string[] strMailContent = new string[iMailNumber];

     for(int i = 1 ; i

    throw new Pop3Exception(exc.ToString());

   }

  }

  #endregion

  ///

  /// 收取邮件    

  ///

  /// 用户名

  /// 口令

  ///

  /// 类型：字符串数组

  /// 内容：解码前的邮件内容

  ///

  ///收取邮箱中的未读邮件

  public string[] Receive(string user,string password)

  {

   try

   {

    return ReceiveMail(user,password);

   }

   catch(Pop3Exception exc)

   {

    throw new Pop3Exception(exc.ToString());

   }

  }

  ///

  /// 断开所有与服务器的会话

  ///

  /// 断开所有与服务器的会话

  public void DisConnect()

  {

   try

   {

    Quit();

    if(m_stmReader != null)

     m_stmReader.Close();

    if(mnetStream != null)

     mnetStream.Close();

    if(mtcpClient != null)

     mtcpClient.Close();

   }

   catch(SocketException exc)

   {

    throw new Pop3Exception(exc.ToString());

   }

  }

  ///

  /// 删除邮件

  ///

  /// 邮件号

  public void DeleteMail(int number)

  {

   //删除邮件

   int iMailNumber = number + 1;

   if(DELE(iMailNumber).Equals("Error"))

    throw new Pop3Exception("删除第" + iMailNumber.ToString() + "时出现错误！");

  }

 }

}