Anslut till POP3‑server

Den Pop3Client klass låter applikationer hantera brevlådor med Post Office Protocol, version 3 (POP3). För att ansluta till en server, använd Pop3Client klass. Den Pop3Client klass är den huvudsakliga ingångspunkten för utvecklare som vill lägga till POP3‑hantering i sina .NET‑applikationer. Denna artikel förklarar hur du använder den. Så här ansluter du till en POP3‑server:

Skapa en instans av Pop3Client klass.
Ange värd, användarnamn och lösenord i Pop3Client instans.

Följande kodexempel visar hur du ansluter till POP3‑servern.

// 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.");

Ansluta till SSL‑server

Ansluta till en POP3‑server beskriver hur du ansluter till en POP3‑server i tre enkla steg:

Skapa en instans av Pop3Client klass.
Ange värd, användarnamn och lösenord.

Processen för att ansluta till en SSL‑aktiverad POP3‑server är liknande men kräver att du sätter några ytterligare egenskaper:

SecurityOptions
Port

För att ansluta till en SSL‑aktiverad POP3‑server, använd Pop3Client klass och ange SecurityOptions och Port‑egenskaper. Följande kodexempel visar hur du ansluter till en SSL‑aktiverad POP3‑server.

// 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.");

Ansluta till en APOP‑server

POP står för Post Office Protocol. APOP står för Authenticated Post Office Protocol. APOP är en utökad version av POP3‑inställningen som krypterar ditt användarnamn och lösenord och använder en autentiseringsmekanism som skyddar ditt POP3‑kontolösenord när du kontrollerar e‑post. APOP‑autentisering kräver inte att kontolösenordet skickas som klartext till POP3‑mailservern.

Ansluta till server via proxy

Proxyservrar är mycket vanliga för att kommunicera med omvärlden. I sådana fall används proxyadresser för att e‑postklienter ska kunna nå brevlådor via Internet. Aspose.Email stödjer versionerna 4, 4a och 5 av SOCKS‑proxy‑protokollet. Denna artikel ger ett fungerande exempel på att hämta e‑post med en proxy‑mailserver. Så här hämtar du e‑post via en proxyserver:

Initiera Proxy med den nödvändiga informationen, dvs. proxyadress, port och SOCKS‑version.
Initiera Pop3Client med värdadress, användarnamn, lösenord och eventuella andra inställningar.
Ställ in klientens Proxy‑egenskap till Proxy objekt skapat ovan.

Följande kodexempel visar hur du hämtar e‑post via en proxyserver.

// 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();

Ansluta till en server via HTTP‑proxy

// 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();
}

Anpassa autentiseringsmekanism

Hämta listan över autentiseringsmekanismer som stöds av POP3‑servern med hjälp av getSupportedAuthentication metod för Pop3Client klass. Denna metod låter klienten avgöra vilka autentiseringsmetoder som är tillgängliga för att upprätta en säker anslutning till servern. Därefter, med hjälp av setAllowedAuthentication metod som hämtar (eller sätter) en uppräkning av de autentiseringstyper som är tillåtna av användaren, välj den mest lämpliga autentiseringsmekanismen för klient‑server‑kommunikationen. Detta låter dig explicit ange autentiseringsmetoden för e‑postklienten.

Följande kodexempel visar hur du anpassar e‑postklientens autentisering:

pop3Client.setAllowedAuthentication(Pop3KnownAuthenticationType.Plain);

OAuth 2.0‑protokollstöd för auktorisation

OAuth 2.0 tillhandahåller auktorisation

Pop3Client stödjer OAuth 2.0 och erbjuder specifika auktoriseringsmetoder för applikationer. Följande konstruktorer används för att initiera POP3Client med OAuth:

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*/

Validera e‑postserverns autentiseringsuppgifter utan att skicka e‑post

Ibland är det nödvändigt att verifiera autentiseringsuppgifter utan att skicka ett e‑postmeddelande. Aspose.Email tillhandahåller validateCredentials() metod för att utföra denna operation. Om valideringen lyckas körs koden inuti if‑satsen, vilket vanligtvis används för att utföra ytterligare åtgärder eller hämta data från IMAP‑servern. Följande kodexempel demonstrerar validering av autentiseringsuppgifter utan att skicka ett e‑postmeddelande:

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

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

Använda CRAM‑MD5‑autentisering för att ansluta till en server

För att säkerställa säker autentisering och kommunikation med POP3‑servern kan du ange och kräva användning av CRAM‑MD5 som den tillåtna autentiseringsmetoden för POP3‑klienten. Följande kodexempel visar hur du konfigurerar den tillåtna autentiseringstypen för Pop3Client:

popClient.setAllowedAuthentication(Pop3KnownAuthenticationType.CramMD5);

Hur du anger timeout för e‑postoperationer

Varje e‑postoperation tar tid beroende på många faktorer (nätverksfördröjningar, datastorlek, serverprestanda osv.). Du kan sätta en timeout för alla e‑postoperationer. Kodexemplet nedan visar hur du gör det med Timeout egenskap. Obs: du bör inte sätta stora värden för att undvika långa väntetider i din applikation.

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

    // some code...
}

Radera meddelanden från POP3‑server