连接到 POP3 服务器

该 Pop3Client 类允许应用程序使用邮局协议第 3 版（POP3）管理邮箱。要连接到服务器，请使用 Pop3Client 类。该 Pop3Client 类是希望在 .NET 应用程序中添加 POP3 管理的开发者的主要入口。本文解释了如何使用它。要连接到 POP3 服务器：

创建该类的实例 Pop3Client 类。
在以下位置指定主机、用户名和密码： Pop3Client 实例。

以下代码片段展示了如何与 POP3 服务器连接。

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username, password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
System.out.println("Connected to POP3 server.");

连接到 SSL 服务器

连接到 POP3 服务器描述了如何用三个简单步骤连接到 POP3 服务器：

创建该类的实例 Pop3Client 类。
指定主机、用户名和密码。

连接到启用 SSL 的 POP3 服务器的过程类似，但需要设置另外几个属性：

SecurityOptions
端口

要连接到启用 SSL 的 POP3 服务器，请使用 Pop3Client 类并设置 SecurityOptions 以及 Port 属性。以下代码片段展示了如何连接到启用 SSL 的 POP3 服务器。

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client();

// Specify host, username and password, Port and SecurityOptions for your client
client.setHost("pop.gmail.com");
client.setUsername("your.username@gmail.com");
client.setPassword("your.password");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.Auto);
System.out.println("Connecting to POP3 server using SSL.");

使用 APOP 服务器连接

POP 代表邮局协议。APOP 代表已认证的邮局协议。APOP 是 POP3 服务器设置的扩展版本，它对用户名和密码进行加密，并使用一种身份验证机制来保护检查电子邮件时的 POP3 帐户密码。APOP 身份验证不需要将帐户密码以明文形式发送到 POP3 邮件服务器。

通过代理连接到服务器

代理服务器在与外部世界通信时非常常见。在此类情况下，邮件客户端使用代理地址通过互联网访问邮箱。Aspose.Email 提供对 SOCKS 代理协议 4、4a 和 5 版本的支持。本文提供了使用代理邮件服务器检索电子邮件的工作示例。通过代理服务器检索电子邮件：

初始化 Proxy 提供所需信息，即代理地址、端口和 SOCKS 版本。
初始化 Pop3Client 提供主机地址、用户名、密码以及其他设置。
将客户端的 Proxy 属性设置为 Proxy 上述创建的对象。

以下代码片段展示了如何通过代理服务器检索电子邮件。

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

// Create an instance of the Pop3Client class
Pop3Client client = new Pop3Client("pop.domain.com", "username", "password");

// Set proxy address, Port and Proxy
String proxyAddress = "192.168.203.142";
int proxyPort = 1080;
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);
client.setProxy(proxy);
Pop3MailboxInfo mailboxInfo = client.getMailboxInfo();

通过 HTTP 代理连接到服务器

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java

HttpProxy proxy = new HttpProxy("18.222.124.59", 8080);
try (Pop3Client client = new Pop3Client("imap.domain.com", "username", "password")) {
    client.setProxy(proxy);
    Pop3MailboxInfo mailboxInfo = client.getMailboxInfo();
}

自定义身份验证机制

使用以下方法检索 POP3 服务器支持的身份验证机制列表 getSupportedAuthentication 方法的 Pop3Client 类。此方法允许客户端确定哪些身份验证方法可用于与服务器建立安全连接。然后，使用 setAllowedAuthentication 方法用于获取（或设置）用户允许的身份验证类型枚举，选择最合适的客户端-服务器通信身份验证机制。这允许您明确设置邮件客户端的身份验证方式。

以下代码示例展示了如何自定义电子邮件客户端的身份验证：

pop3Client.setAllowedAuthentication(Pop3KnownAuthenticationType.Plain);

OAuth 2.0 协议支持授权

OAuth 2.0 提供授权

Pop3Client 支持 OAuth 2.0，为应用程序提供特定的授权方式。以下构造函数用于使用 OAuth 初始化 POP3Client：

public Pop3Client(

            String host, /*The host name*/

            int port, /*The port number*/ 

            String username, /*The user name*/

            ITokenProvider tokenProvider, /*TokenProvider allowing to retrieve access token*/

            /*SecurityOptions*/int securityOptions) /*Security mode for a mail client*/



public Pop3Client(

            String host, /*The host name*/

            int port, /*The port number*/

            String username, /*The user name*/

            String authInfo, /*The user password or XOAUTH2 access token*/

            boolean useOAuth, /*Defines whether SASL XOAUTH2 mechanism is used to login to the server*/

            /*SecurityOptions*/int securityOptions) /*Security mode for a mail client*/

在不发送电子邮件的情况下验证邮件服务器凭据

有时需要在不发送电子邮件的情况下验证凭据。Aspose.Email 提供了 validateCredentials() 方法用于执行此操作。如果验证成功，将执行 if 语句内的代码，通常用于执行进一步操作或从 IMAP 服务器检索数据。以下代码片段演示了在不发送电子邮件的情况下验证凭据：

try (Pop3Client pop3Client = new Pop3Client(
        server.Pop3Url, server.Pop3Port, "userName", "password", SecurityOptions.Auto)) {
    pop3Client.setTimeout(4000);

    if (pop3Client.validateCredentials()) {
        // to do something
    }
}

使用 CRAM-MD5 身份验证连接到服务器

为确保与 POP3 服务器的安全身份验证和通信，您可以指定并强制使用 CRAM-MD5 作为 POP3 客户端允许的身份验证方法。以下代码片段展示了如何为 Pop3Client:

popClient.setAllowedAuthentication(Pop3KnownAuthenticationType.CramMD5);

如何为邮件操作设置超时

每个邮件操作都需要一定时间，取决于多种因素（网络延迟、数据大小、服务器性能等）。您可以为所有邮件操作设置超时。下面的代码示例展示了如何使用超时属性。注意：不应设置过大的值，以免在应用程序中导致长时间等待。

try (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.setTimeout(60000); // 60 seconds

    // some code...
}

从 POP3 服务器删除邮件