1 功能说明

POP3是Post Office Protocol 3的简称，即邮局协议的第3个版本；【POP3收取邮件】便是通过该协议，从电子邮件服务提供商的服务器上下载邮件，并可进行邮件过滤、删除。

1) 使用该组件时，需确定邮箱开启了“POP/SMTP服务”服务，否则无法正常执行； 2) 该组件从收件箱由上往下（即从接收时间最近的邮件开始）一次性获取全部邮件，不存在获取未读邮件，故获取到未读的邮件后，该邮件状态依旧为未读； 3) 删除邮件的方法只能在大部分服务器上起作用(并不是全部，如腾讯企业邮箱便不支持), 且删除是在客户端删除。

2 基本使用说明

根据所使用的邮箱，配置好相应的参数再运行，组件执行未报错则成功收取邮件，打印邮件主题后并返回邮件信息对象组成的列表。

1).若是没有获取到符合条件的邮件，则返回一个空列表；

2).邮件信息对象包括邮件的发送人（sender）、发送时间（received_time）、邮件主题（subject）、内容（body）以及附件（attachments：附件保存在本地的路径组成的列表）等；

3).此处“选择书目”为5，故获取五封邮件。

3 参数配置说明

组件中的参数，除“密码”参数外，均可传入变量进行设置，其中“服务器”、“端口”以及“ssl”参数取决于获取邮件的目的邮箱，可进入邮箱设置的POP3/SMTP服务查询。

以下以QQ邮箱为例进行参数的说明示范：

• “服务器”参数 收取邮件的邮箱所对应的POP3接收服务器，输入为字符串； 例如QQ邮箱的POP3服务器为 'pop.qq.com'：

• “端口”参数 邮箱所对应POP3接收服务器的端口号； QQ邮箱的POP3服务器端口号为 995 ：

• “账户姓名”参数 即收取邮件的邮箱地址，输入为字符串，内容为邮箱地址；

• “密码”参数 即邮箱的密码，以密文显示，因此无法使用变量传递，直接输入密码即可；

有些邮箱出于安全设置，如QQ邮箱，在第三方登陆邮箱时，需要生成授权码，使用授权码作为密码登录。

• “ssl”参数 ssl(secure sockets layer 安全套接层)是保护网络通信安全及数据完整的一种安全协议； 该参数有两个选项，“True”表示该端口遵从ssl协议；默认为“False”，“False”表示端口非ssl，不过大多数邮箱，如QQ邮箱的端口是ssl。

• “附件保存路径”参数 用以邮件附件下载后保存在本地的路径，输入为字符串，可点击后面的文件夹图标进行选择；

• “发送邮箱过滤”参数 根据邮件发送人的邮箱地址进行过滤，输入为字符串，只有邮箱地址中包含该字符串才被收取。

1). 默认为空，匹配所有发送者的邮件； 如下图所示，组件返回5个邮件信息对象为元素组成的列表，通过循环遍历列表依次打印各个邮件的发件人邮箱地址（MailObj.sender）：

2). 输入字符串，收取前n（即设置的邮件选择数目）封邮箱中发件人邮箱地址包含该字符串的邮件。 例如输入'163'，则收取发件人邮箱账号中包含“163”这个字符串的邮件，故只打印了一个网易邮箱地址：

此处“选择数目”默认为4，即最多获取4封邮件；

下图为邮箱收件箱中的前几封邮件截图，参数配置说明中的示范未说明的情况下均是以此为例：

• “主题过滤”参数 根据邮件的主题进行过滤，输入为字符串，收取邮件主题中包含该字符串的邮件。

1). 默认为空，匹配所有主题的邮件； 如下图所示，依次打印了4封邮件的主题（MailObj.subject）：

2). 输入字符串，收取前n（设置的邮件选择数目）封邮箱中主题包含该字符串的邮件，例如'测试',获取主题中包含字符串“测试”的邮件：

• “内容过滤”参数 根据邮件的正文进行过滤，输入为字符串，收取邮件正文中包含该字符串的邮件。

1). 默认为空，匹配所有主题的邮件；

2). 输入字符串，收取前n（设置的邮件选择数目）封邮箱中正文包含该字符串的邮件。例如'浮名',收取正文中包含字符串“浮名”的邮件，故只获取到一封邮件的正文（MailObj.body）：

• “附件过滤”参数 根据邮件的附件进行过滤，输入为字符串，邮件附件名称（包括文件扩展名）中包含该字符串则被收取。

1). 默认为空，匹配所有主题的邮件； 如下图所示，输出打印了4封邮件的附件名（MailObj.attachments）：（没有附件的则打印为空的列表）

2). 输入字符串，收取前n（设置的邮件选择数目）封邮箱中附件名称包含该字符串的邮件。 例如输入'csv',收取附件名称中包含字符串“csv”的邮件，故只获取到一封邮件：

• “删除消息”参数 设置是否对收取到的邮件进行删除，默认为False，即不删除； 设置为True，则收取到邮件后删除邮件。

• “选择数目”参数 从上往下（邮件在收件箱中的位置，时间近的在上），设置收取邮件的最大数量。默认为5，输入为int整型。

1). 所有过滤条件均为空的情况，获取前n封满足条件的邮件

2). 过滤条件中任一参数非空，从前n封邮件中获取满足条件的邮件。

• 返回值 返回邮件信息对象组成的列表。