JavaMail API - POP3服务器

邮局协议(POP)是本地电子邮件客户端用于通过TCP/IP连接从远程服务器检索电子邮件的应用程序层Internet标准协议. POP支持访问远程邮箱的简单下载和删除要求. POP3服务器侦听众所周知的端口110.

Package com.sun.mail.pop3 是JavaMail API的POP3协议提供程序,提供对POP3邮件存储.下表列出了此包中的类:

名称描述
POP3Folder一个POP3文件夹(只能是"INBOX").
POP3MessagePOP3消息.
POP3SSLStore使用SSL的POP3消息存储.
POP3StorePOP3消息存储.

此提供商上方需要注意的一些要点:

  • POP3提供商仅支持一个名为 INBOX 的文件夹.由于POP3协议的限制,不允许使用许多JavaMail API功能,如事件通知,文件夹管理,标记管理等.

  • POP3提供程序通过JavaMail API使用协议名称 pop3 或格式为 pop3://user:password @ host:port/INBOX"的URL进行访问.

  • POP3不支持永久性标志.例如,永远不会为POP3消息设置 Flags.Flag.RECENT 标志.这取决于用于确定POP3邮箱中哪些邮件 new 的应用程序.

  • POP3不支持Folder.expunge()方法.要删除和删除邮件,请在邮件上设置Flags.Flag.DELETED标志,然后使用Folder.close(true)方法关闭文件夹.

  • POP3不提供收到的日期,因此getReceivedDate方法将返回null.

  • 当访问POP3消息的标题时, POP3提供商使用th e TOP命令用于获取所有标头,然后缓存这些标头.

  • 当访问POP3消息的内容时,POP3提供程序使用RETR命令获取整个消息.

  • POP3Message.invalidate 方法可用于在不关闭文件夹的情况下使缓存数据无效.

POP3协议提供程序支持以下属性,这些属性可以在JavaMail会话对象中设置.属性始终设置为字符串; Type列描述了如何解释字符串.

名称类型描述
mail.pop3.user字符串POP3的默认用户名.
mail.pop3.hostString要连接的POP3服务器.
mail.pop3.portint要连接的POP3服务器端口,如果connect()方法未明确指定一.默认为110.
mail.pop3.connectiontimeoutint套接字连接超时值,以毫秒为单位.默认为无限超时.
mail.pop3.timeoutint套接字I/O超时值毫秒.默认为无限超时.
mail.pop3.rsetbeforequitboolean关闭时发送POP3 RSET命令发送QUIT命令之前的文件夹.默认值为false.
mail.pop3.message.classString子类的类名com.sun.mail.pop3.POP3Message.子类可用于处理(例如)非标准Content-Type标头.子类必须具有MyPOP3Message形式的公共构造函数(Folder f,int msgno)抛出MessagingException.
mail.pop3.localaddressString创建POP3套接字时要绑定的本地地址(主机名).默认为Socket类选择的地址.
mail.pop3.localportint创建POP3套接字时要绑定的本地端口号.默认为Socket类选择的端口号.
mail.pop3.apop.enableboolean如果设置为true,如果POP3服务器支持APOP,则使用APOP而不是USER/PASS登录POP3服务器. APOP发送密码摘要而不是明文密码.默认为false.
mail.pop3.socketFactory套接字工厂如果设置为实现的类在javax.net.SocketFactory接口中,该类将用于创建POP3套接字.
mail.pop3.socketFactory.classString如果设置,则指定实现javax.net.SocketFactory接口的类的名称.此类将用于创建POP3套接字.
mail.pop3.socketFactory.fallbackboolean如果设置为true,则无法使用指定的套接字工厂类创建套接字将导致使用java.net.Socket类创建套接字.默认为true.
mail.pop3.socketFactory.portint指定要连接的端口使用指定的套接字工厂时.如果未设置,将使用默认端口.
mail.pop3.ssl.enableboolean如果设置为true,则默认情况下使用SSL连接并使用SSL端口. "pop3"协议默认为false,"pop3s"协议默认为true.
mail.pop3.ssl.checkserveridentityboolean如果设置为true,请检查RFC 2595指定的服务器标识.默认为false.
mail.pop3.ssl .trustString如果设置,并且尚未指定套接字工厂,则启用MailSSLSocketFactory.
如果设置为"*",则所有主机都是可信任的.
如果设置为以空格分隔的主机列表,则这些主机是受信任的.
否则,信任取决于服务器提供的证书.
mail.pop3.ssl.socketFactorySSL套接字工厂如果设置为扩展javax.net.ssl.SSLSocketFactory类的类,则此类将用于创建POP3 SSL套接字.
mail.pop3.ssl.socketFactory.classString如果设置,则指定名称扩展javax.net.ssl.SSLSocketFactory类的类.此类将用于创建POP3 SSL套接字.
mail.pop3.ssl.socketFactory.portint指定使用指定套接字工厂时要连接的端口.如果未设置,将使用默认端口.






mail.pop3.ssl.protocolsstring指定将为SSL连接启用的SSL协议.属性值是javax.net.ssl.SSLSocket.setEnabledProtocols方法可接受的以空格分隔的标记列表.
mail.pop3.starttls.enableboolean如果为true,则允许使用STLS命令(如果服务器支持)在发出任何登录命令之前将连接切换到受TLS保护的连接.默认为false.
mail.pop3.starttls.requiredboolean如果为true,则需要使用STLS命令.如果服务器不支持STLS命令,或者命令失败,则connect方法将失败.默认为false.
mail.pop3.socks.hoststring指定a的主机名SOCKS5代理服务器,用于连接邮件服务器.
mail.pop3.socks.portstring指定SOCKS5代理服务器的端口号.
mail.pop3.disabletopboolean如果设置为true,则POP3 TOP命令不会用于获取邮件标头.默认为false.
mail.pop3.forgettopheadersboolean如果设置为true,则标题为可能已使用POP3 TOP命令检索到的内容将被遗忘,并由作为POP3 RETR命令的一部分检索的标头替换.默认为false.
mail.pop3.filecache.enableboolean如果设置为true,则POP3提供程序将消息数据缓存在临时文件中而不是内存中.消息仅在访问消息内容时添加到缓存中.消息头始终缓存在内存中(按需).文件夹关闭或JVM终止时,将删除文件缓存.默认为false.
mail.pop3.filecache.dirString如果启用了文件缓存,此属性可用于覆盖JDK用于临时文件的默认目录.
mail.pop3.cachewritetoboolean控制POP3消息对象上writeTo方法的行为.如果设置为true,并且消息内容尚未缓存,并且ignoreList为null,则在写入之前缓存该消息.否则,消息将直接流式传输到输出流而不进行高速缓存.默认为false.
mail.pop3.keepmessagecontentboolean如果此属性设置为true,将保留对缓存内容的硬引用,防止在文件夹关闭或缓存内容显式无效之前重复使用内存(使用invalidate方法).默认为false.

通常,应用程序不应直接使用此包中的类.相反,他们应该使用由 javax.mail 包(和子包)定义的API.应用程序永远不应直接构造 POP3Store POP3Folder 的实例.相反,他们应该使用Session方法getStore来获取适当的Store对象,并从中获取Folder对象.

检查电子邮件一章中演示了使用POP3服务器的示例.