Documentation – POP3 클라이언트 작업

Java: POP3 서버에 연결

Mon, 01 Jan 0001 00:00:00 +0000

다음은 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 및 포트 속성. 다음 코드 스니펫은 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은 우편국 프로토콜(Post Office Protocol)을 의미합니다. APOP은 인증된 우편국 프로토콜(Authenticated Post Office Protocol)을 의미합니다. 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() method를 사용해 이 작업을 수행합니다. 검증이 성공하면 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 서버와의 보안 인증 및 통신을 보장하기 위해, POP3 클라이언트에 허용되는 인증 방법으로 CRAM-MD5 사용을 지정하고 강제할 수 있습니다. 다음 코드 스니펫은 허용된 인증 유형을 구성하는 방법을 보여줍니다. Pop3Client:

popClient.setAllowedAuthentication(Pop3KnownAuthenticationType.CramMD5);

메일 작업에 대한 시간 제한 설정 방법

각 메일 작업은 네트워크 지연, 데이터 크기, 서버 성능 등 여러 요인에 따라 시간이 소요됩니다. 모든 메일 작업에 대한 시간 제한을 설정할 수 있습니다. 아래 코드 예제는 이를 …을 사용해 설정하는 방법을 보여줍니다. 시간 제한 속성. 참고: 애플리케이션에서 긴 대기 시간을 피하려면 큰 값을 설정하지 않아야 합니다.

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

    // some code...
}

Java: POP3 서버에서 메시지 삭제

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email는 특정 작업 후에 맞춤형 작업을 수행할 수 있는 강력한 구성 요소입니다. Aspose.Email는 사용자가 작업을 수행할 수 있는 다수의 이벤트를 발생시킵니다. 이 기능은 사용자가 애플리케이션을 보다 세밀하게 제어할 수 있게 합니다. 예를 들어, 사용자는 다음과 같은 상황에서 원하는 작업을 수행할 수 있습니다:

모든 대량 이메일이 전송되었습니다.
메시지가 전송될 예정입니다.
이메일이 완전히 전송되었습니다.
수신자가 SMTP 서버에 의해 거부될 때.

POP3 사서함은 POP3 서버에 존재합니다. 이러한 사서함의 이메일은 다음을 통해 PC로 가져올 수 있습니다: Pop3Client. The Pop3Client 클래스는 POP3 프로토콜을 사용하여 POP3 사서함의 메일을 PC로 복사합니다. 메일을 가져오면 인터넷에 연결된 상태를 유지할 필요 없이 PC에서 읽을 수 있습니다. POP3 서버에 메일을 보관할 필요가 없거나 원하지 않는 경우 해당 메일을 삭제합니다. 이 섹션에서는 다음을 사용하여 이메일을 삭제하는 방법을 보여줍니다. Pop3Client 클래스.

인덱스로 이메일 삭제

다음 코드는 인덱스를 기준으로 사서함의 모든 메일을 하나씩 삭제합니다. 인덱스는 절대 0 이하가 되어서는 안 됩니다. Pop3Client.deleteMessage.

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

// Create a POP3 client
Pop3Client client = new Pop3Client("mail.aspose.com", 110, "username", "psw");
try {
    // Delete all the message one by one
    int messageCount = client.getMessageCount();
    for (int i = 1; i <= messageCount; i++) {
        client.deleteMessage(i);
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}

모든 이메일 삭제

또한 다음을 호출할 수 있습니다 Pop3Client.deleteMessages 모든 메시지를 삭제하기 위해. 다음 코드 스니펫은 모든 이메일을 삭제하는 방법을 보여줍니다.

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

// Delete all the messages
client.deleteMessages();

삭제 작업 직후 POP3 서버와의 연결이 끊어지면 더 이상 호출할 수 없습니다. Pop3Client.cancelDeletes()를 사용하여 원하는 작업을 수행합니다.

삭제 취소

Pop3Client.undeleteMessages 이메일 메시지 삭제를 취소하는 데 사용할 수 있습니다. 다음 코드 스니펫은 삭제 취소 방법을 보여줍니다.

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

// Cancel deletes
client.undeleteMessages();

Java: Pop3Client를 사용한 서버 확장 목록

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email Pop3Client 서버가 지원하는 IDLE, UNSELECT, QUOTA 등과 같은 확장 기능을 검색할 수 있게 해줍니다. 이는 특정 기능을 사용하기 전에 확장의 가용성을 판단하는 데 도움이 됩니다. 해당 getCapabilities() method는 지원되는 확장 유형을 문자열 배열 형태로 반환합니다.

서버 확장 기능 검색

다음 코드 샘플은 Gmail 서버에 대해 Pop3Client를 사용하여 서버 확장을 가져오는 방법을 보여줍니다.

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

// Connect and log in to POP3
Pop3Client client = new Pop3Client("pop.gmail.com", "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);
client.setPort(995);
String[] getCaps = client.getCapabilities();
for (String item : getCaps) {
    System.out.println(item);
}

Java: 서버에서 메시지 작업

Mon, 01 Jan 0001 00:00:00 +0000

사서함 정보 가져오기

메시지 수와 사서함 크기와 같은 사서함 정보를 다음을 사용하여 가져올 수 있습니다. getMailBoxSize 및 getMailBoxInfo 의 메서드 Pop3Client 클래스.

다음은 getMailBoxSize 메서드는 사서함의 크기를 바이트 단위로 반환합니다.
다음은 getMailBoxInfo 메서드는 타입의 객체를 반환합니다. Pop3MailBoxInfo.

다음 방법을 사용하여 메시지 수를 가져올 수도 있습니다. MessageCount 속성 및 크기를 사용하여 OccupiedSize 속성 Pop3MailBoxInfo 클래스. 다음 샘플 코드는 사서함 정보를 가져오는 방법을 보여줍니다. 다음과 같이:

다음을 생성합니다 Pop3Client.
POP3 서버에 연결합니다.
사서함의 크기를 가져옵니다.
사서함 정보를 가져옵니다.
사서함의 메시지 수를 가져옵니다.
사용 중인 크기를 가져옵니다.

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

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

// Get the size of the mailbox, Get mailbox info, number of messages in the mailbox
long nSize = client.getMailboxSize();
System.out.println("Mailbox size is " + nSize + " bytes.");
Pop3MailboxInfo info = client.getMailboxInfo();
int nMessageCount = info.getMessageCount();
System.out.println("Number of messages in mailbox are " + nMessageCount);
long nOccupiedSize = info.getOccupiedSize();
System.out.println("Occupied size is " + nOccupiedSize);

사서함에서 이메일 수 가져오기

다음 코드 스니펫은 사서함에서 이메일 메시지 수를 계산하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
Pop3Client client = new Pop3Client("pop3.server.com", "username", "password");
try {
    client.setSecurityOptions(SecurityOptions.Auto);
    int i = client.getMessageCount();
    System.out.println("Message count: " + i);
} catch (Pop3Exception ex) {
    System.out.println("Error:" + ex.toString());
}

Aspose.Email은 개발자가 이메일을 다양한 방식으로 작업할 수 있도록 합니다. 예를 들어, 이메일을 다운로드할지 여부를 결정하기 전에 헤더 정보를 가져올 수 있습니다. 또는 서버에서 이메일을 가져와 파싱하지 않고 저장(빠르게)하거나 파싱한 후 저장(느리게)할 수 있습니다. 이 문서는 이메일을 검색하고 변환하는 방법을 보여줍니다.

이메일 헤더 정보 검색

이메일 헤더는 전체 이메일을 가져올지 여부를 판단하는 데 사용할 수 있는 이메일 메시지 정보를 제공합니다. 일반적으로 헤더 정보에는 발신자, 제목, 수신 날짜 등이 포함됩니다. (이메일 헤더에 대한 자세한 내용은 이메일 헤더 사용자 정의. 해당 주제는 SMTP를 사용한 이메일 전송에 관한 것이지만, 이메일 헤더 내용 정보는 POP3 이메일에도 유효합니다). 다음 예시는 메시지 순번으로 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);
try {
    HeaderCollection headers = client.getMessageHeaders(1);
    for (int i = 0; i < headers.size(); i++) {
        // Display key and value in the header collection
        System.out.print(headers.getKey(i));
        System.out.print(" : ");
        System.out.println(headers.get(i));
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

이메일 메시지 검색

다음은 Pop3Client 클래스 구성 요소는 POP3 서버에서 이메일 메시지를 검색하고, 이를 a 로 파싱하는 기능을 제공합니다 MailMessage 도움을 받아 인스턴스 MailMessage 구성 요소. MailMessage 클래스는 이메일 내용을 조작하기 위한 여러 속성과 메서드를 포함합니다. 사용하면 fetchMessage 메서드 Pop3Client 클래스에서, 다음을 얻을 수 있습니다: MailMessage POP3 서버에서 직접 인스턴스를 가져옵니다. 다음 코드 스니펫은 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);
try {
    int messageCount = client.getMessageCount();
    // Create an instance of the MailMessage class and Retrieve message
    MailMessage message;
    for (int i = 1; i <= messageCount; i++) {
        message = client.fetchMessage(i);
        System.out.println("From:" + message.getFrom());
        System.out.println("Subject:" + message.getSubject());
        System.out.println(message.getHtmlBody());
    }
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

고유 ID를 사용한 메시지 요약 정보 가져오기

API의 POP3 클라이언트는 메시지의 고유 ID를 사용하여 서버에서 메시지 요약 정보를 가져올 수 있습니다. 이를 통해 전체 메시지를 먼저 가져오지 않고도 메시지의 간략 정보를 빠르게 접근할 수 있습니다. 다음 코드 스니펫은 메시지 요약 정보를 가져오는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String uniqueId = "unique id of a message from server";
Pop3Client client = new Pop3Client("host.domain.com", 456, "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);
Pop3MessageInfo messageInfo = client.getMessageInfo(uniqueId);

if (messageInfo != null) {
    System.out.println(messageInfo.getSubject());
    System.out.println(messageInfo.getDate());
}

멀티 연결을 사용한 메시지 목록

Pop3Client 를 제공합니다. UseMultiConnection 무거운 작업을 위해 다중 연결을 생성하는 데 사용할 수 있는 속성입니다. 멀티연결 모드에서 사용할 연결 수는 다음을 사용하여 설정할 수 있습니다. Pop3Client.ConnectionsQuantity. 다음 코드 스니펫은 메시지 목록 작성을 위한 멀티 연결 모드 사용을 보여주며 단일 연결 모드와 성능을 비교합니다.

// 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 pop3Client = new Pop3Client();
pop3Client.setHost("<HOST>");
pop3Client.setPort(995);
pop3Client.setUsername("<USERNAME>");
pop3Client.setPassword("<PASSWORD>");

pop3Client.setConnectionsQuantity(5);
pop3Client.setUseMultiConnection(MultiConnectionMode.Enable);
long multiConnectionModeStartTime = System.currentTimeMillis();
Pop3MessageInfoCollection messageInfoCol1 = pop3Client.listMessages();
long multiConnectionModeTimeSpan = System.currentTimeMillis() - multiConnectionModeStartTime;

pop3Client.setUseMultiConnection(MultiConnectionMode.Disable);
long singleConnectionModeStartTime = System.currentTimeMillis();
Pop3MessageInfoCollection messageInfoCol2 = pop3Client.listMessages();
long singleConnectionModeTimeSpan = System.currentTimeMillis() - singleConnectionModeStartTime;

System.out.println("multyConnectionModeTimeSpan: " + multiConnectionModeTimeSpan);
System.out.println("singleConnectionModeTimeSpan: " + singleConnectionModeTimeSpan);
double performanceRelation = singleConnectionModeTimeSpan / multiConnectionModeTimeSpan;
System.out.println("Performance Relation: " + performanceRelation);

멀티 연결 모드 사용이 성능 향상을 보장하지는 않는다는 점에 유의하십시오.

서버에서 메시지를 가져와 디스크에 저장

파싱 없이 메시지를 디스크에 저장

POP3 서버에서 이메일을 파싱하지 않고 다운로드하려면, Pop3Client 클래스 saveMessage 함수. saveMessage 함수는 이메일을 파싱하지 않으므로 ~보다 빠릅니다. fetchMessage 함수. 다음 코드 스니펫은 시퀀스 번호(예: 1)를 사용해 메시지를 저장하는 방법을 보여줍니다. saveMessage 메서드는 메시지를 파싱하지 않고 원본 EML 형식으로 저장합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "pop3/";
String dstEmail = dataDir + "InsertHeaders.eml";

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

try {
    // Save message to disk by message sequence number
    client.saveMessage(1, dstEmail);
    client.dispose();
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}
System.out.println("Retrieved email messages using POP3 ");

저장하기 전에 메시지 파싱

다음 코드 스니펫은 ~를 사용합니다. Pop3Client fetchMessage 시퀀스 번호로 POP3 서버에서 메시지를 가져와 제목을 파일 이름으로 사용해 디스크에 저장하는 메서드.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "pop3/";

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

try {
    // Fetch the message by its sequence number and Save the message using its subject as the file name
    MailMessage msg = client.fetchMessage(1);
    msg.save(dataDir + "first-message_out.eml", SaveOptions.getDefaultEml());
    client.dispose();
} catch (Exception ex) {
    System.out.println(ex.getMessage());
} finally {
    client.dispose();
}

그룹 메시지 가져오기

Pop3Client 를 제공합니다. fetchMessages 시퀀스 번호 또는 고유 ID의 iterable을 받아 리스트를 반환하는 메서드. MailMessage. 다음 코드 스니펫은 ~의 사용을 보여줍니다. fetchMessages 시퀀스 번호와 고유 ID로 메시지를 가져오는 메서드.

// 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 pop3Client = new Pop3Client();
pop3Client.setHost("<HOST>");
pop3Client.setPort(995);
pop3Client.setUsername("<USERNAME>");
pop3Client.setPassword("<PASSWORD>");

Pop3MessageInfoCollection messageInfoCol = pop3Client.listMessages();
System.out.println("ListMessages Count: " + messageInfoCol.size());

List<Integer> sequenceNumberAr = new ArrayList<Integer>();
List<String> uniqueIdAr = new ArrayList<String>();
for (Pop3MessageInfo mi : messageInfoCol) {
    sequenceNumberAr.add(mi.getSequenceNumber());
    uniqueIdAr.add(mi.getUniqueId());
}

for (MailMessage m : pop3Client.fetchMessagesBySequences(sequenceNumberAr)) {
    System.out.println("FetchMessages-sequenceNumberAr : " + m.getSubject());
}

for (MailMessage m : pop3Client.fetchMessagesByUids(uniqueIdAr)) {
    System.out.println("FetchMessages-uniqueIdAr : " + m.getSubject());
}

발신자, 수신자 또는 날짜 기반 메시지 필터링

다음은 Pop3Client 클래스, 자세한 내용은 POP3 서버에 연결, 제공하는 listMessages 메서드는 사서함의 모든 메시지를 가져옵니다. 특정 조건에 일치하는 메시지만 얻으려면 오버로드된 메서드를 사용하십시오 listMessages 메서드는 ~를 받아들입니다 MailQuery 을 인수로 사용합니다. MailQuery 클래스는 날짜, 제목, 발신자, 수신자 등과 같은 쿼리 조건을 지정하기 위한 다양한 속성을 제공합니다. MailQueryBuilder 클래스는 검색 식을 구축하는 데 사용됩니다. 먼저 모든 조건과 제약을 설정하고 나서 MailQuery ~에 의해 개발된 쿼리로 채워집니다 MailQueryBuilder. The MailQuery 클래스 객체는 ~에 의해 사용됩니다 Pop3Client 서버에서 필터링된 정보를 추출합니다. 이 문서는 사서함에서 이메일 메시지를 필터링하는 방법을 보여줍니다. 첫 번째 예시는 날짜와 제목을 기준으로 메시지를 필터링하는 방법을 설명합니다. 또한 다른 기준으로 필터링하고 더 복잡한 쿼리를 구축하는 방법을 보여줍니다. 또한 날짜 및 시간 필터를 적용하여 사서함에서 특정 이메일을 검색하는 방법을 보여줍니다. 추가로 대소문자 구분 필터링 적용 방법도 설명합니다.

사서함에서 메시지 필터링

사서함에서 메시지를 필터링하려면:

POP3 서버에 연결하고 로그인합니다.
다음의 인스턴스를 생성합니다 MailQuery 그리고 원하는 속성을 설정합니다.
다음을 호출합니다. Pop3Client.listMessages(MailQuery query) method에 전달하고 MailQuery 매개변수에 지정하여 필터링된 메시지만 가져옵니다.

다음 코드 스니펫은 POP3 사서함에 연결하고 오늘 도착한 메시지 중 제목에 "newsletter"가 포함된 메시지를 가져오는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to POP3
String host = "host";
int port = 110;
String username = "user@host.com";
String password = "password";
Pop3Client client = new Pop3Client(host, port, username, password);

// Set conditions, Subject contains "Newsletter", Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());
// Build the query and Get list of messages
MailQuery query = builder.getQuery();
Pop3MessageInfoCollection messages = client.listMessages(query);
System.out.println("Pop3: " + messages.size() + " message(s) found.");

특정 기준에 부합하는 메시지 가져오기

위의 코드 샘플 이메일 제목과 날짜를 기준으로 메시지를 필터링합니다. 다른 속성을 사용해 지원되는 조건을 설정할 수도 있습니다. 아래는 를 사용하여 조건을 설정하는 몇 가지 예시입니다. MailQuery.

다음 코드 스니펫은 다른 기준으로 이메일을 필터링하는 방법을 보여줍니다:

오늘 전달된 이메일을 찾습니다.
특정 기간 내에 수신된 이메일을 찾습니다.
특정 발신자의 이메일을 찾습니다.
특정 도메인에서 보낸 이메일을 찾습니다.
특정 수신자에게 보낸 이메일을 찾습니다.

오늘 날짜

다음 코드 스니펫은 오늘 전달된 이메일을 찾는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().on(new Date());

날짜 범위

다음 코드 스니펫은 특정 기간 내에 수신된 이메일을 찾는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Emails that arrived in last 7 days
Calendar calendar = Calendar.getInstance();

builder.getInternalDate().before(calendar.getTime());
calendar.add(Calendar.DATE, -7);
builder.getInternalDate().since(calendar.getTime());

특정 발신자

다음 코드 스니펫은 특정 발신자에게서 온 이메일을 찾는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails from specific sender
builder.getFrom().contains("saqib.razzaq@127.0.0.1");

특정 도메인

다음 코드 스니펫은 특정 도메인에서 보낸 이메일을 찾는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails from specific domain
builder.getFrom().contains("SpecificHost.com");

특정 수신자

다음 코드 스니펫은 특정 수신자에게 보낸 이메일을 찾는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get emails sent to specific recipient
builder.getTo().contains("recipient");

복잡한 쿼리 구축

다른 경우 MailQueryBuilder 속성을 별도의 문장으로 설정하면 모든 조건이 일치합니다. 예를 들어, 날짜 범위와 특정 호스트에서 온 메시지를 가져오려면 세 개의 문장을 작성해야 합니다.

AND로 쿼리 결합

다음 코드 스니펫은 AND로 쿼리를 결합하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Emails from specific host, get all emails that arrived before today and all emails that arrived since 7 days ago
builder.getFrom().contains("SpecificHost.com");

Calendar calendar = Calendar.getInstance();

builder.getInternalDate().before(calendar.getTime());
calendar.add(Calendar.DATE, -7);
builder.getInternalDate().since(calendar.getTime());

OR로 쿼리 결합

MailQueryBuilder 제공합니다 또는 두 개를 받는 메서드 MailQuery 인스턴스를 매개변수로 전달합니다. 지정된 두 조건 중 하나에 일치하는 메시지를 가져옵니다. 다음 코드 스니펫은 제목에 "test"가 있거나 발신자가 "noreply@host.com"인 메시지를 필터링하는 방법을 보여줍니다. 다음 코드 스니펫은 OR로 쿼리를 결합하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Specify OR condition
builder.or(builder.getSubject().contains("test"), builder.getFrom().contains("noreply@host.com"));

대소문자 구분 필터 적용

API는 또한 대소문자 구분 기준에 따라 사서함의 이메일을 필터링하는 기능을 제공합니다. 다음 메서드들은 대소문자 구분 플래그를 지정하여 이메일을 검색할 수 있는 기능을 제공합니다.

Method StringComparisonField.contains(String value, boolean ignoreCase)
Method StringComparisonField.equals(String value, boolean ignoreCase)
Method StringComparisonField.notContains(String boolean, bool ignoreCase)
Method StringComparisonField.notEquals(String boolean, bool ignoreCase)

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// IgnoreCase is True
MailQueryBuilder builder1 = new MailQueryBuilder();
builder1.getFrom().contains("tesT", true);
MailQuery query1 = builder1.getQuery();
Pop3MessageInfoCollection messageInfoCol1 = client.listMessages(query1);

Java: Pop3Client 비동기 작업

Mon, 01 Jan 0001 00:00:00 +0000

Pop3Client 비동기 작업

Aspose.Email을 사용하여 사서함에서 메시지를 비동기적으로 가져올 수도 있습니다. Pop3Client. 이 문서는 사서함에서 메시지를 비동기적으로 검색하는 방법을 보여줍니다. 또한 검색 기준을 제공하여 메시지를 나열하는 방법을 보여줍니다. MailQuery.

비동기 메시지 검색

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

Pop3Client client = new Pop3Client();
client.setHost("pop.gmail.com");
client.setPort(995);
client.setSecurityOptions(SecurityOptions.SSLImplicit);
client.setUsername("username");
client.setPassword("password");

try {
    Pop3MessageInfoCollection messages = client.listMessages();
    System.out.println("Total Number of Messages in inbox:" + messages.size());
    IAsyncResult asyncResult = client.beginFetchMessage(messages.get_Item(0).getSequenceNumber());
    MailMessage message = client.endFetchMessage(asyncResult);
} catch (Exception ex) {
    System.out.println(ex.getMessage());
}

MailQuery를 사용한 비동기 메시지 목록

다음은 MailQuery 클래스는 다음 코드 샘플에 표시된 대로 비동기적으로 메시지 목록을 검색하기 위한 검색 기준을 지정하는 데 사용할 수 있습니다.

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

MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Subject");
MailQuery query = builder.getQuery();
IAsyncResult asyncResult = client.beginListMessages(query);
Pop3MessageInfoCollection messages = client.endListMessages(asyncResult);