Documentation – IMAP 클라이언트 작업

Java: IMAP 서버에 연결

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

다음은 ImapClient 클래스는 애플리케이션이 IMAP 프로토콜을 사용하여 IMAP 메일함을 관리하도록 허용합니다. ImapClient 클래스는 IMAP 메일 서버에 연결하고 IMAP 이메일 폴더에서 이메일을 관리하는 데 사용됩니다. IMAP 서버에 연결하려면

다음의 인스턴스를 생성합니다. ImapClient 클래스.
호스트 이름, 사용자 이름 및 비밀번호를 지정합니다 ImapClient constructor.

일단 ImapClient 인스턴스가 초기화되면, 이 인스턴스를 사용한 다음 호출은 서버에 연결됩니다. 다음 코드 스니펫은 위 단계들을 사용하여 IMAP 서버에 연결하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

SSL이 활성화된 IMAP 서버와 연결

IMAP 서버와 연결 IMAP 서버에 연결하는 네 단계에 대해 설명했습니다:

다음의 인스턴스를 생성합니다. ImapClient 클래스.
호스트 이름, 사용자 이름 및 비밀번호를 지정합니다.
포트를 지정합니다.
지정하세요 보안 옵션.

SSL이 활성화된 IMAP 서버에 연결하는 과정은 유사하지만 몇 개의 추가 속성을 설정해야 합니다:

설정 보안 옵션 SSLImplicit 로.

다음 코드 스니펫은 방법을 보여줍니다

사용자 이름, 비밀번호 및 포트를 설정합니다.
보안 옵션 설정.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of the ImapClient class
ImapClient client = new ImapClient("imap.domain.com", 993, "user@domain.com", "pwd");

// Set the security mode to implicit
client.setSecurityOptions(SecurityOptions.SSLImplicit);

프록시를 통해 서버에 연결

프록시 서버는 외부와 통신할 때 일반적으로 사용됩니다. 이러한 경우 메일 클라이언트는 프록시 주소를 지정하지 않으면 인터넷에 접속할 수 없습니다. Aspose.Email은 SOCKS 프록시 프로토콜 버전 4, 4a 및 5를 지원합니다. 이 문서는 프록시 메일 서버를 사용하여 메일함에 접근하는 작동 예제를 제공합니다. 프록시 서버를 통해 메일함에 접근하려면:

초기화 SocksProxy 필수 정보인 프록시 주소, 포트 및 SOCKS 버전을 지정합니다.
초기화 ImapClient 호스트 주소, 사용자 이름, 비밀번호 및 기타 설정과 함께.
클라이언트를 설정합니다 SocksProxy 속성을 SocksProxy 위에서 생성된 객체.

다음 코드 스니펫은 프록시 서버를 통해 메일함을 검색하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP and set SecurityOptions
ImapClient client = new ImapClient("imap.domain.com", "username", "password");
client.setSecurityOptions(SecurityOptions.Auto);

String proxyAddress = "192.168.203.142"; // proxy address
int proxyPort = 1080; // proxy port
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);

// Set the proxy
client.setProxy(proxy);

try {
    client.selectFolder("Inbox");
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

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);
final ImapClient client = new ImapClient("imap.domain.com", "username", "password");
try {
    client.setProxy(proxy);
    client.selectFolder("Inbox");
} finally {
    if (client != null)
        client.dispose();
}

인증 메커니즘 맞춤 설정

IMAP 서버가 지원하는 인증 메커니즘 목록을 를 사용하여 검색합니다 getSupportedAuthentication 메서드 ImapClient 클래스. 이 메서드는 클라이언트가 서버와 보안 연결을 수립하는 데 사용할 수 있는 인증 방법을 확인하도록 허용합니다. 그런 다음, setAllowedAuthentication 사용자가 허용한 인증 유형 열거형을 가져오거나(또는 설정하는) 메서드로, 클라이언트-서버 통신에 가장 적합한 인증 메커니즘을 선택합니다. 이를 통해 메일 클라이언트의 인증 방법을 명시적으로 설정할 수 있습니다.

다음 코드 샘플은 이메일 클라이언트 인증을 커스터마이즈하는 방법을 보여줍니다:

imapClient.setAllowedAuthentication(ImapKnownAuthenticationType.Plain);

읽기 전용 모드로 서버에 연결

다음은 ImapClient 클래스는 ReadOnly 속성으로, true 로 설정하면 메일함의 영구 상태에 변경이 없어야 함을 나타냅니다. 다음 코드 샘플은 사용법을 보여줍니다 ImapClient.ReadOnly 속성입니다. 읽지 않은 메시지 수를 가져온 다음 하나의 메시지를 가져오고, 읽기 전용 모드에서 다시 읽지 않은 메시지 수를 가져옵니다. 읽지 않은 메시지 수가 동일하게 유지되어 메일함의 영구 상태가 변경되지 않았음을 나타냅니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapQueryBuilder imapQueryBuilder = new ImapQueryBuilder();
imapQueryBuilder.hasNoFlags(ImapMessageFlags.isRead()); /* get unread messages. */
MailQuery query = imapQueryBuilder.getQuery();

imapClient.setReadOnly(true);
imapClient.selectFolder("Inbox");
ImapMessageInfoCollection messageInfoCol = imapClient.listMessages(query);
System.out.println("Initial Unread Count: " + messageInfoCol.size());
if (messageInfoCol.size() > 0) {
    imapClient.fetchMessage(messageInfoCol.get_Item(0).getSequenceNumber());

    messageInfoCol = imapClient.listMessages(query);
    // This count will be equal to the initial count
    System.out.println("Updated Unread Count: " + messageInfoCol.size());
} else {
    System.out.println("No unread messages found");
}

서버에 연결하기 위해 CRAM-MD5 인증 사용

IMAP 서버와의 안전한 인증 및 통신을 보장하기 위해, IMAP 클라이언트에 허용되는 인증 방법으로 CRAM-MD5 사용을 지정하고 적용할 수 있습니다. 다음 코드 스니펫은 허용된 인증 유형을 구성하는 방법을 보여줍니다. ImapClient:

imapClient.setAllowedAuthentication(ImapKnownAuthenticationType.CramMD5);

이메일 전송 없이 메일 서버 자격 증명 검증

때때로 이메일을 보내지 않고 자격 증명을 확인해야 할 필요가 있습니다. Aspose.Email은 이를 제공합니다 validateCredentials() method를 사용해 이 작업을 수행합니다. 검증이 성공하면 if 문 내부의 코드가 실행되며, 일반적으로 추가 작업을 수행하거나 IMAP 서버에서 데이터를 가져오는 데 사용됩니다. 다음 코드 스니펫은 이메일을 보내지 않고 자격 증명을 검증하는 예시를 보여줍니다.

try (ImapClient imapClient = new ImapClient(
        server.ImapUrl, server.ImapPort, "username", "password", SecurityOptions.Auto)) {
    imapClient.setTimeout(4000);

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

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

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

try (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.setTimeout(60000); // 60 seconds

    // some code...
}

Greeting Timeout 제한 방법

IMAP 클라이언트는 자동 모드를 사용하여 연결을 설정할 수 있습니다. 이 모드에서는 IMAP 클라이언트가 연결이 설정될 때까지 모든 가능한 연결 매개변수를 시도합니다. 올바른 연결이 이루어지면 IMAP 서버는 클라이언트에 인사 문자열을 보냅니다. 서버는 암시적 또는 명시적(START TLS) SSL/TLS 연결을 시작할 수 있습니다. 연결 모드가 일치하지 않을 경우(예: 서버가 암시적 SSL 연결을 기다리는데 클라이언트가 비보안 또는 명시적 SSL 연결을 시도하는 경우) 서버는 인사 문자열을 보내지 않으며, 사용자는 제한 시간이 초과될 때까지 오랫동안 대기하게 됩니다. 이 문제를 피하기 위해 GreetingTimeout이 도입되었습니다. 이 속성을 사용하면 인사 문자열에 대한 시간 제한을 설정하고 자동 연결 설정 시간을 줄일 수 있습니다.

ImapClient imapClient = new ImapClient();
imapClient.setGreetingTimeout(4000);

Java: IMAP 서버의 메시지 작업

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

서버에서 MIME 메시지 ID 나열

ImapMessageInfo MIME을 제공합니다 MessageId 전체 메시지를 추출하지 않고 메시지를 식별하기 위해 사용됩니다. 다음 코드 스니펫은 MIME messageId를 나열하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");

try {
    ImapMessageInfoCollection messageInfoCol = client.listMessages("Inbox");
    for (ImapMessageInfo info : messageInfoCol) {
        // Display MIME Message ID
        System.out.println("Message Id = " + info.getMessageId());
    }
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

서버에서 메시지 나열

Aspose.Email은 2개의 멤버를 오버로드한 변형을 제공합니다. listMessages() 쿼리를 기반으로 지정된 수의 메시지를 검색합니다. 다음 코드 스니펫은 메시지를 나열하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

// Select the inbox folder and Get the message info collection
ImapQueryBuilder builder = new ImapQueryBuilder();
MailQuery query = builder
        .or(builder.or(builder.or(builder.or(builder.getSubject().contains(" (1) "), builder.getSubject().contains(" (2) ")), builder.getSubject().contains(" (3) ")),
                builder.getSubject().contains(" (4) ")), builder.getSubject().contains(" (5) "));
ImapMessageInfoCollection messageInfoCol4 = client.listMessages(query, 4);
System.out.println((messageInfoCol4.size() == 4) ? "Success" : "Failure");

서버에서 재귀적으로 메시지 나열

IMAP 프로토콜은 메일함 폴더에서 메시지를 재귀적으로 나열하는 것을 지원합니다. 이는 폴더의 하위 폴더에서도 메시지를 나열하는 데 도움이 됩니다. 다음 코드 스니펫은 메시지를 재귀적으로 나열하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an imapclient with host, user and password
ImapClient client = new ImapClient();
client.setHost("domain.com");
client.setUsername("username");
client.setPassword("password");
client.selectFolder("InBox");
ImapMessageInfoCollection msgsColl = client.listMessages(true);
System.out.println("Total Messages: " + msgsColl.size());

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

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

imapClient.selectFolder("Inbox");
imapClient.setConnectionsQuantity(5);
imapClient.setUseMultiConnection(MultiConnectionMode.Enable);
long multiConnectionModeStartTime = System.currentTimeMillis();
ImapMessageInfoCollection messageInfoCol1 = imapClient.listMessages(true);
long multiConnectionModeTimeSpan = System.currentTimeMillis() - multiConnectionModeStartTime;

imapClient.setUseMultiConnection(MultiConnectionMode.Disable);
long singleConnectionModeStartTime = System.currentTimeMillis();
ImapMessageInfoCollection messageInfoCol2 = imapClient.listMessages(true);
long singleConnectionModeTimeSpan = System.currentTimeMillis() - singleConnectionModeStartTime;

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

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

내림차순으로 메시지 가져오기

Aspose.Email은 ImapClient.listMessagesByPage 메서드 - 페이지 지원으로 메시지를 나열하는 메서드. 일부 오버로드는 ImapClient.listMessagesByPage 받아들입니다 PageSettings 매개변수로. PageSettings 을 제공합니다 AscendingSorting 속성으로, false 로 설정하면 이메일을 내림차순으로 반환합니다.

다음 예제 코드는 다음 사용을 보여줍니다 AscendingSorting 속성 PageSettings 이메일 순서를 변경하는 클래스.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

PageSettings pageSettings = new PageSettings();
pageSettings.setAscendingSorting(false);
ImapPageInfo pageInfo = imapClient.listMessagesByPage(5, pageSettings);
ImapMessageInfoCollection messages = pageInfo.getItems();

for (ImapMessageInfo message : messages) {
    System.out.println(message.getSubject() + " -> " + message.getDate().toString());
}

서버에서 메시지 가져오기 및 디스크에 저장

다음은 ImapClient 클래스는 IMAP 서버에서 메시지를 가져와 EML 형식으로 로컬 디스크에 저장할 수 있습니다. 메시지를 디스크에 저장하려면 다음 단계가 필요합니다:

다음의 인스턴스를 생성합니다. ImapClient 클래스.
ImapClient에 호스트 이름, 포트, 사용자 이름 및 비밀번호를 지정합니다 생성자.
다음으로 폴더를 선택합니다 selectFolder() 메서드.
다음을 호출합니다. listMessages 메서드로 가져옵니다 ImapMessageInfoCollection 객체.
다음에 대해 반복합니다 ImapMessageInfoCollection 컬렉션에서, 다음을 호출합니다 saveMessage() 메서드를 호출하고 출력 경로와 파일 이름을 제공하십시오.

다음 코드 스니펫은 서버에서 이메일 메시지를 가져와 저장하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Select the inbox folder and Get the message info collection
client.selectFolder(ImapFolderInfo.IN_BOX);
ImapMessageInfoCollection list = client.listMessages();

// Download each message
for (int i = 0; i < list.size(); i++) {
    // Save the EML file locally
    client.saveMessage(list.get_Item(i).getUniqueId(), dataDir + list.get_Item(i).getUniqueId() + ".eml");
}

MSG 형식으로 메시지 저장

위 예제에서, 이메일은 EML 형식으로 저장됩니다. 이메일을 MSG 형식으로 저장하려면 ImapClient.fetchMessage() 메서드를 호출해야 합니다. 이 메서드는 메시지를 다음 인스턴스로 반환합니다 MailMessage 클래스. MailMessage.save() 메서드를 호출하여 메시지를 MSG로 저장할 수 있습니다. 다음 코드 스니펫은 MSG 형식으로 메시지를 저장하는 방법을 보여줍니다.

// 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 = "data/";

// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

// Select the inbox folder and Get the message info collection
client.selectFolder(ImapFolderInfo.IN_BOX);
ImapMessageInfoCollection list = client.listMessages();

// Download each message
for (int i = 0; i < list.size(); i++) {
    // Save the message in MSG format
    MailMessage message = client.fetchMessage(list.get_Item(i).getUniqueId());
    message.save(dataDir + list.get_Item(i).getUniqueId() + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

그룹 메시지 가져오기

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

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

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

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

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

이메일 스레딩/대화별 이메일 정리

Aspose.Email는 동일한 대화와 관련된 모든 전달, 회신 및 모두에게 회신 메시지를 계층적으로 그룹화할 수 있게 합니다. 기본적으로 IMAP 프로토콜은 RFC-5256에 정의된 THREAD 기능을 지원할 수 있습니다. 또한 Gmail에서 제공하는 X-GM-EXT-1이라는 다른 IMAP 확장이 있습니다.

다음 이메일 스레딩 기능을 사용할 수 있습니다:

getMessageThreads 메서드 - 메시지 스레드를 수신합니다 ImapClient.
boolean getGmExt1Supported - Gmail X-GM-EXT-1 확장이 지원되는지 여부 정보를 가져옵니다.
boolean getThreadSupported - THREAD 확장이 지원되는지 여부 정보를 가져옵니다.
String[] getThreadAlgorithms - 지원되는 THREAD 알고리즘을 가져옵니다.

다음 코드 샘플은 Gmail에서 이메일 스레드를 가져오기 위한 이러한 기능의 사용법을 보여줍니다:

  ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password", SecurityOptions.SSLImplicit);

try {

    client.selectFolder(ImapFolderInfo.IN_BOX);

   // get a list of messages that we'll group by conversation

   ImapMessageInfoCollection messages = client.listMessages();

   // make sure the IMAP server supports X-GM-EXT-1 extension

   if (client.getGmExt1Supported()) {

       // gets unique conversationId for our example

       Set<String> conversationIds = new HashSet<String>();

       for (ImapMessageInfo messageInfo : messages) {

           if (messageInfo.getConversationId() != null)

                conversationIds.add(messageInfo.getConversationId());

       }

       for (String conversationId : conversationIds) {

           // create the necessary search conditions for a thread

           XGMThreadSearchConditions conditions = new XGMThreadSearchConditions();

            conditions.setConversationId(conversationId);

            conditions.setUseUId(true);

           // get results

           List<MessageThreadResult> conversation = client.getMessageThreads(conditions);

           // print the email conversation in hierarchically manner

           printConversaton("", conversation, messages);

            System.out.println("--------------------");

       }

   }

} finally {

    client.dispose();

}

/**

 * <p>

 * Prints the email conversation in hierarchically manner

 * </p>

 */

public static void printConversaton(String indent, Iterable<MessageThreadResult> conversation,

    Iterable<ImapMessageInfo> messages) {

   for (MessageThreadResult thread : conversation) {

       for (ImapMessageInfo messageInfo : messages) {

           if (thread.getUniqueId().equals(messageInfo.getUniqueId())) {

                System.out.println(indent + " (" + thread.getUniqueId() + ") " + messageInfo.getSubject());

               break;

           }

       }

       if (thread.getChildMessages().size() != 0) {

            printConversaton(indent += "-", thread.getChildMessages(), messages);

       }

   }

}

IMAP 서버가 THREAD 기능을 지원하는 경우, 코드는 약간 변경됩니다:

IMAP 서버가 THREAD 확장을 지원하는지 확인합니다:

 if (client.getThreadSupported())

스레드에 적합한 검색 조건을 생성합니다:

 ThreadSearchConditions conditions = new ThreadSearchConditions();

conditions.setAlgorithm(client.getThreadAlgorithms()[0]);

conditions.setUseUId(true);

페이지 지원 메시지 목록

메일함에 많은 수의 메시지가 있는 경우, 페이지 지원으로 메시지를 나열하거나 검색하는 것이 일반적입니다. Aspose.Email API ImapClient 페이지 지원을 통해 서버에서 메시지를 검색할 수 있게 합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// This example shows the paging support of ImapClient for listing messages from the server
// Available in Aspose.Email for Java and onwards
final ImapClient client = new ImapClient("host.domain.com", 993, "username", "password");
try {
    try {
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        // Create some test messages and append these to server's inbox
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35157 - " + UUID.randomUUID(),
                    "EMAILNET-35157 Move paging parameters to separate class");
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }

        // List messages from inbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection totalMessageInfoCol = client.listMessages();
        // Verify the number of messages added
        System.out.println(totalMessageInfoCol.size());

        ////////////////// RETREIVE THE MESSAGES USING PAGING SUPPORT////////////////////////////////////

        List<ImapPageInfo> pages = new ArrayList<ImapPageInfo>();
        PageSettings pageSettings = new PageSettings();
        ImapPageInfo pageInfo = client.listMessagesByPage(itemsPerPage, 0, pageSettings);
        System.out.println(pageInfo.getTotalCount());
        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(itemsPerPage, pageInfo.getNextPage().getPageOffset(), pageSettings);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;

        // foreach to while statements conversion
        for (ImapPageInfo folderCol : pages) {
            retrievedItems += folderCol.getItems().size();
        }
        System.out.println(retrievedItems);
    } finally {
    }
} finally {
    if (client != null)
        client.dispose();
}

폴더 가져오기 및 메시지 재귀적 읽기

이 문서에서는 대부분의 ImapClient 이 기능은 IMAP 서버에서 모든 폴더와 하위 폴더를 재귀적으로 나열하는 애플리케이션을 만드는 데 사용됩니다. 또한 각 폴더와 하위 폴더의 메시지를 로컬 디스크에 MSG 형식으로 저장합니다. 디스크에 폴더와 메시지는 IMAP 서버와 동일한 계층 구조로 생성 및 저장됩니다. 다음 코드 스니펫은 메시지와 하위 폴더 정보를 재귀적으로 가져오는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() throws Exception {
    // Create an instance of the ImapClient class
    ImapClient client = new ImapClient();

    // Specify host, username, password, Port and SecurityOptions for your client
    client.setHost("imap.gmail.com");
    client.setUsername("your.username@gmail.com");
    client.setPassword("your.password");
    client.setPort(993);
    client.setSecurityOptions(SecurityOptions.Auto);
    try {
        // The root folder (which will be created on disk) consists of host and username
        String rootFolder = client.getHost() + "-" + client.getUsername();

        // Create the root folder and List all the folders from IMAP server
        new File(rootFolder).mkdirs();
        ImapFolderInfoCollection folderInfoCollection = client.listFolders();
        for (ImapFolderInfo folderInfo : folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listMessagesInFolder(folderInfo, rootFolder, client);
        }
        // Disconnect to the remote IMAP server
        client.dispose();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex);
    }

    System.out.println("Downloaded messages recursively from IMAP server.");
}

/// Recursive method to get messages from folders and sub-folders
private static void listMessagesInFolder(ImapFolderInfo folderInfo, String rootFolder, ImapClient client) {
    // Create the folder in disk (same name as on IMAP server)
    String currentFolder = "data/";
    new File(currentFolder).mkdirs();

    // Read the messages from the current folder, if it is selectable
    if (folderInfo.getSelectable()) {
        // Send status command to get folder info
        ImapFolderInfo folderInfoStatus = client.getFolderInfo(folderInfo.getName());
        System.out.println(folderInfoStatus.getName() + " folder selected. New messages: " + folderInfoStatus.getNewMessageCount() + ", Total messages: "
                + folderInfoStatus.getTotalMessageCount());

        // Select the current folder and List messages
        client.selectFolder(folderInfo.getName());
        ImapMessageInfoCollection msgInfoColl = client.listMessages();
        System.out.println("Listing messages....");
        for (ImapMessageInfo msgInfo : msgInfoColl) {
            // Get subject and other properties of the message
            System.out.println("Subject: " + msgInfo.getSubject());
            System.out.println("Read: " + msgInfo.isRead() + ", Recent: " + msgInfo.getRecent() + ", Answered: " + msgInfo.getAnswered());

            // Get rid of characters like ? and :, which should not be included in a file name and Save the message in MSG format
            String fileName = msgInfo.getSubject().replace(":", " ").replace("?", " ");
            MailMessage msg = client.fetchMessage(msgInfo.getSequenceNumber());
            msg.save(currentFolder + "\\" + fileName + "-" + msgInfo.getSequenceNumber() + ".msg", SaveOptions.getDefaultMsgUnicode());
        }
        System.out.println("============================\n");
    } else {
        System.out.println(folderInfo.getName() + " is not selectable.");
    }

    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ImapFolderInfoCollection folderInfoCollection = client.listFolders(folderInfo.getName());
        for (ImapFolderInfo subfolderInfo : folderInfoCollection) {
            listMessagesInFolder(subfolderInfo, rootFolder, client);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

메시지 UID 또는 시퀀스 번호 가져오기

Aspose.Email 공개 API는 서버에서 받은 메시지를 처리할 때 필요할 수 있는 UID 또는 시퀀스 번호와 같은 메시지 식별 정보를 가져오는 다음 기능을 제공합니다:

MailboxInfo 클래스 - 메일함에 있는 메시지에 대한 식별 정보를 나타냅니다.

getSequenceNumber() 메서드 - 메시지의 시퀀스 번호를 가져옵니다.
getUniqueId() 메서드 - 메시지의 고유 ID를 가져옵니다.

MailMessage 클래스 - 전자 메일 메시지를 나타내며, 제목, 본문, 발신자 및 수신자 주소 등의 메시지 속성에 접근할 수 있습니다.

getItemId 메서드 - 메일함에 있는 메시지에 대한 식별 정보를 나타냅니다.

"INBOX" 폴더에서 IMAP 서버의 메시지 세부 정보를 가져오고 표시하는 방법을 아래 코드 샘플이 보여줍니다. ImapClient 클래스:

try (ImapClient client = new ImapClient(imapHost, port, emailAddress, password, securityOption)) {
    ImapMessageInfoCollection msgs = client.listMessages("INBOX");
    List<Integer> seqIds = new ArrayList<>();
    for (ImapMessageInfo msg : msgs) {
        seqIds.add(msg.getSequenceNumber());
    }
    Iterable<MailMessage> msgsViaFetch = client.fetchMessagesBySequences(seqIds);
    for (MailMessage thisMsg : msgsViaFetch) {
        System.out.println("Message ID: " + thisMsg.getItemId().getUniqueId()
                + " SequenceNumber: " + thisMsg.getItemId().getSequenceNumber()
                + " Subject: " + thisMsg.getSubject());
    }
}

요약 정보로서 추가 매개변수 검색

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("host.domain.com", "username", "password");
try {
    MailMessage message = new MailMessage("from@domain.com", "to@doman.com", "EMAILNET-38466 - " + UUID.randomUUID().toString(),
            "EMAILNET-38466 Add extra parameters for UID FETCH command");

    // append the message to the server
    String uid = client.appendMessage(message);

    // wait for the message to be appended
    Thread.sleep(5000);

    // Define properties to be fetched from server along with the message
    List<String> messageExtraFields = Arrays.asList("X-GM-MSGID", "X-GM-THRID");

    // retreive the message summary information using it's UID
    ImapMessageInfo messageInfoUID = client.listMessage(uid, messageExtraFields);

    // retreive the message summary information using it's sequence number
    ImapMessageInfo messageInfoSeqNum = client.listMessage(1, messageExtraFields);

    // List messages in general from the server based on the defined properties
    ImapMessageInfoCollection messageInfoCol = client.listMessages(messageExtraFields);

    ImapMessageInfo messageInfoFromList = messageInfoCol.get_Item(0);

    // verify that the parameters are fetched in the summary information
    for (String paramName : messageExtraFields) {
        System.out.println(messageInfoFromList.getExtraParameters().containsKey(paramName));
        System.out.println(messageInfoUID.getExtraParameters().containsKey(paramName));
        System.out.println(messageInfoSeqNum.getExtraParameters().containsKey(paramName));
    }
} finally {
    if (client != null)
        client.dispose();
}

List-Unsubscribe 헤더 정보 가져오기

List-Unsubscribe 헤더에는 광고, 뉴스레터 등 메일링 리스트 구독 해지를 위한 URL이 포함됩니다. List-Unsubscribe 헤더를 가져오려면 다음을 사용하세요 listUnsubscribe 속성 ImapMessageInfo 클래스. 다음 예제는 사용법을 보여줍니다 listUnsubscribe List-Unsubscribe 헤더를 가져오는 속성.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMessageInfoCollection messageInfoCol = imapClient.listMessages();
for (ImapMessageInfo imapMessageInfo : messageInfoCol) {
    System.out.println("ListUnsubscribe Header: " + imapMessageInfo.getListUnsubscribe());
}

Java: IMAP을 사용한 메시지 첨부 파일 작업

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

IMAP 클라이언트를 사용한 메시지 첨부 파일 목록

첨부 파일의 이름, 크기와 같은 정보를 가져오되 첨부 데이터 자체를 가져오지 않으려면 다음 API 기능을 사용하십시오:

ImapAttachmentInfo - 첨부 파일 정보를 나타냅니다.
ImapAttachmentInfoCollection - ImapAttachmentInfo 컬렉션을 나타냅니다.
listAttachments(int sequenceNumber) - 메시지의 각 첨부 파일에 대한 정보를 가져옵니다.

다음 코드 예제는 IMAP 클라이언트를 사용하여 서버에서 이메일 메시지 및 해당 첨부 파일에 대한 정보를 검색하고 각 메시지에 대한 첨부 파일 세부 정보를 표시하는 방법을 보여줍니다. 이를 통해 IMAP 프로토콜을 사용하여 이메일 메시지의 첨부 파일에 접근하고 처리할 수 있습니다.

ImapMessageInfoCollection messageInfoCollection = imapClient.listMessages();

for (ImapMessageInfo message : messageInfoCollection) {
    ImapAttachmentInfoCollection attachmentInfoCollection =
            imapClient.listAttachments(message.getSequenceNumber());

    for (ImapAttachmentInfo attachmentInfo : attachmentInfoCollection) {
        System.out.println(
                "Attachment: " + attachmentInfo.getName() + " (size: " + attachmentInfo.getSize() + ")");
    }
}

Java: 서버에서 메시지 플래그 작업

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

메시지 플래그 변경

메시지 플래그는 다음을 사용하여 변경할 수 있습니다. changeMessageFlags() method. 이 메서드는 두 개의 매개변수를 사용합니다.

메시지 시퀀스 번호 또는 고유 ID.
MessageFlag.

다음 플래그를 설정할 수 있습니다:

메시지 플래그 설정

다음 코드 스니펫은 Aspose.Email을 사용하여 IMAP 서버에서 메시지 플래그를 변경하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Mark the message as read
client.changeMessageFlags(1, ImapMessageFlags.isRead());

메시지 플래그 제거

메시지 플래그는 또한 다음을 사용하여 제거할 수 있습니다. removeMessageFlags() 메서드. 사용법은 changeMessageFlags() 메서드. 시퀀스 번호 또는 고유 메시지 ID를 받아 MessageFlag. 다음 코드 스니펫은 메시지 플래그를 제거하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Remove the message flag
client.removeMessageFlags(1, ImapMessageFlags.isRead());

사용자 정의 플래그 설정

또한 다음을 사용하여 메시지에 사용자 정의 플래그를 설정할 수 있습니다. ImapClient API의. ImapClient AddMessageFlags 메시지에 사용자 정의 플래그를 설정할 수 있는 기능을 제공합니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create a message
MailMessage message = new MailMessage("user@domain1.com", "user@domain2.com", "subject", "message");

// Append the message to mailbox
String uid = client.appendMessage(ImapFolderInfo.IN_BOX, message);

// Add custom flags to the added messge
client.addMessageFlags(uid, com.aspose.email.ImapMessageFlags.op_BitwiseOr(ImapMessageFlags.keyword("custom1"), ImapMessageFlags.keyword("custom1_0")));

// Retreive the messages for checking the presence of custom flag
client.selectFolder(ImapFolderInfo.IN_BOX);

ImapMessageInfoCollection messageInfos = client.listMessages();
for (ImapMessageInfo inf : messageInfos) {
    ImapMessageFlags[] flags = inf.getFlags().split();

    if (inf.containsKeyword("custom1"))
        System.out.println("Keyword found");
}

Java: IMAP 클라이언트를 사용하여 서버에서 메시지 필터링

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

다음은 ImapClient class는 다음을 제공합니다 listMessages() 메서드는 사서함의 모든 메시지를 가져옵니다. 특정 조건에 일치하는 메시지만 얻으려면 오버로드된 메서드를 사용하십시오 listMessages() 메서드는 ~를 받아들입니다 MailQuery 을 인수로 사용합니다. MailQuery 클래스는 날짜, 제목, 발신자, 수신자 등과 같은 조건을 지정하기 위한 다양한 속성을 제공합니다. 첫 번째 예는 날짜와 제목을 기준으로 메시지를 필터링하는 방법을 보여줍니다. 또한 다른 기준으로 필터링하고 보다 복잡한 쿼리를 구축하는 방법을 보여줍니다. API는 정확한 필터링 기준에 일치하도록 대소문자 구분 검색 기준을 적용할 수 있는 기능도 제공합니다. 또한 메일함에서 메시지를 필터링하기 위한 검색 문자열 인코딩을 지정할 수 있습니다.

사서함에서 메시지 필터링

IMAP 서버에 연결하고 로그인하기
다음의 인스턴스를 생성합니다. MailQuery 그리고 속성을 설정합니다
다음을 호출합니다. ImapClient.listMessages(MailQuery query) method에 전달하고 MailQuery 필터링된 메시지만 가져오기 위한 매개변수와 함께.

다음 코드 스니펫은 IMAP 메일함에 연결하고 오늘 도착했으며 제목에 "newsletter" 단어가 포함된 메시지를 가져오는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
final String host = "host";
final int port = 143;
final String username = "user@host.com";
final String password = "password";
ImapClient client = new ImapClient(host, port, username, password);
client.selectFolder("Inbox");
// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());
// Build the query and Get list of messages
MailQuery query = builder.getQuery();
ImapMessageInfoCollection messages = client.listMessages(query);
System.out.println("Imap: " + messages.size() + " message(s) found.");
// Disconnect from IMAP
client.dispose();

특정 기준에 맞는 메시지 가져오기

위의 코드 샘플 이메일 제목과 날짜를 기준으로 메시지를 필터링합니다. 다른 속성을 사용하여 지원되는 다른 조건도 설정할 수 있습니다. 아래는 를 사용하여 조건을 설정하는 몇 가지 예입니다 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());
~~
### **Date Range*
The following code snippet shows you how to filter emails on the date range.

~~~Java
// 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 cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.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 cal = Calendar.getInstance();
builder.getInternalDate().before(cal.getTime());
cal.add(Calendar.DATE, -7);
builder.getInternalDate().since(cal.getTime());

OR로 쿼리 결합

MailQueryBuilder 제공합니다 or() 두 개를 받는 메서드 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"));

InternalDate 기반 필터링

메시지는 InternalDate를 기준으로 서버에서 추출할 수 있지만, 때때로 서버가 인박스에 보이는 모든 메시지를 반환하지 않을 수 있습니다. 그 이유는 서버 시간대가 UTC가 아닐 수 있기 때문이며, 다음과 같은 서버가 있습니다 Gmail. Aspose는 008 SEARCH ON 4-May-2014와 같은 명령을 보냅니다. IMAP 프로토콜 하지만 결과는 서버 시간대 설정에 따라 다를 수 있습니다. 새 멤버가 다음에 추가되었습니다 ImapMessageInfo as InternalDate 이는 메시지 필터링에 추가로 도움이 됩니다. 다음 코드 스니펫은 사용법을 보여줍니다 InternalDate 메시지를 필터링하기 위해.

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

// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter");
builder.getInternalDate().on(new Date());

// Build the query and Get list of messages
MailQuery query = builder.getQuery();
ImapMessageInfoCollection messages = client.listMessages(query);
for (ImapMessageInfo info : messages) {
    System.out.println("Internal Date: " + info.getInternalDate());
}

// Disconnect from IMAP
client.dispose();

대소문자 구분 이메일 필터링

다음 코드 스니펫은 대소문자 구분 이메일 필터링을 사용하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set conditions, Subject contains "Newsletter", Emails that arrived today
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Newsletter", true);
builder.getInternalDate().on(new Date());
MailQuery query = builder.getQuery();

쿼리 빌더 인코딩 지정

API의 ImapQueryBuilder 생성자를 사용하여 검색 문자열의 인코딩을 지정할 수 있습니다. 이는 또한 다음을 사용하여 설정할 수 있습니다 DefaultEncoding MailQueryBuilder의 속성입니다. 다음 코드 스니펫은 쿼리 빌더에 대한 인코딩을 지정하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set conditions
ImapQueryBuilder builder = new ImapQueryBuilder(Charset.forName("utf-8"));
builder.getSubject().contains("ğüşıöç", true);
MailQuery query = builder.getQuery();

페이지 매김 지원 메시지 필터링

다음은 ImapClient 메일함에서 메시지를 검색하고 페이지 매김을 지원하여 나열하는 기능을 제공합니다. 다음 코드 스니펫은 페이지 매김을 지원하는 메시지 필터링 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
/// <summary>
/// This example shows how to search for messages using ImapClient of the API with paging support
/// Introduced in Aspose.Email for .NET 6.4.0
/// </summary>
final ImapClient client = new ImapClient("host.domain.com", 84, "username", "password");
try {
    try {
        // Append some test messages
        int messagesNum = 12;
        int itemsPerPage = 5;
        MailMessage message = null;
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35128 - " + UUID.randomUUID(), "111111111111111");
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }
        String body = "2222222222222";
        for (int i = 0; i < messagesNum; i++) {
            message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35128 - " + UUID.randomUUID(), body);
            client.appendMessage(ImapFolderInfo.IN_BOX, message);
        }

        client.selectFolder("Inbox");
        ImapQueryBuilder iqb = new ImapQueryBuilder();
        iqb.getBody().contains(body);
        MailQuery query = iqb.getQuery();

        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection totalMessageInfoCol = client.listMessages(query);
        System.out.println(totalMessageInfoCol.size());

        //////////////////////////////////////////////////////

        List<ImapPageInfo> pages = new ArrayList<ImapPageInfo>();

        PageSettings ps = new PageSettings();
        ps.setFolderName(ImapFolderInfo.IN_BOX);
        PageInfo pi = new PageInfo(itemsPerPage);
        ImapPageInfo pageInfo = client.listMessagesByPage(query, pi, ps);

        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(query, pageInfo.getNextPage(), ps);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;
        // foreach to while statements conversion
        for (ImapPageInfo folderCol : pages) {
            retrievedItems += folderCol.getItems().size();
        }
    } finally {
    }
} finally {
    if (client != null)
        client.dispose();
}

사용자 정의 플래그로 메시지 필터링

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapQueryBuilder queryBuilder = new ImapQueryBuilder();

queryBuilder.hasFlags(ImapMessageFlags.keyword("custom1"));

queryBuilder.hasNoFlags(ImapMessageFlags.keyword("custom2"));

사용자 정의 검색으로 메시지 필터링

예를 들어 RFC 3501 표준은 메시지에 첨부 파일이 존재하는지 여부를 기준으로 검색하는 것을 허용하지 않습니다. 그러나 Gmail은 제공합니다 IMAP 확장 기능 이러한 검색을 수행할 수 있게 합니다. Aspose.Email은 customSearch 메서드 ImapQueryBuilder 해당 쿼리를 만들기 위한 클래스.

아래 코드 샘플은 IMAP 프로토콜과 사용자 정의 검색 기준을 사용하여 첨부 파일이 있는 이메일 메시지 목록을 서버에서 가져오는 방법을 보여줍니다:

ImapQueryBuilder builder = new ImapQueryBuilder();
builder.customSearch("X-GM-RAW \"has:attachment\"");
MailQuery query = builder.getQuery();
messageInfoCol = client.listMessages(query);

Java: 서버에서 메시지 삭제

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

메시지 삭제

다음은 ImapClient 클래스는 IMAP 서버에서 메시지를 삭제할 수 있습니다. ImapClient 클래스 deleteMessage() 함수는 메시지를 삭제하는 데 사용됩니다. 메시지 시퀀스 번호 또는 고유 ID를 매개변수로 받습니다. ImapClient 제공합니다 deleteMessage 및 deleteMessages 메시지를 하나씩 또는 여러 개씩 삭제하는 메서드들입니다. 다음 코드 스니펫은 IMAP 서버에서 메시지 ID 1인 이메일을 삭제하는 방법을 보여줍니다.

try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.setSecurityOptions(SecurityOptions.SSLImplicit);

    // Append test message
    client.selectFolder(ImapFolderInfo.IN_BOX);

    MailMessage eml = new MailMessage("from@from.com", "to@to.com");
    eml.setSubject("Message to delete");
    eml.setBody("Hey! This Message will be deleted!");
    String emlId = client.appendMessage(eml);

    // Delete appended message
    client.deleteMessage(emlId);
    client.commitDeletes();
}

다중 메시지 삭제

메일함에서 여러 이메일을 다음을 사용하여 삭제할 수 있습니다. ImapClient Aspose.Email API의. deleteMessages 메서드는 고유 ID, 시퀀스 번호 등을 사용하여 서버에서 다수의 메시지를 삭제할 수 있는 여러 옵션을 제공합니다. ImapMessageInfoCollection 요소들. 다음 코드 스니펫은 여러 메시지를 삭제하는 방법을 보여줍니다.

try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.selectFolder(ImapFolderInfo.IN_BOX);

    // Append test messages
    List<MailMessage> emlList = new ArrayList<>();
    for (int i = 0; i < 3; i++) {
        MailMessage eml = new MailMessage("from@from.com", "to@to.com");
        eml.setSubject("Message to delete " + i);
        eml.setBody("Hey! This Message will be deleted!");

        emlList.add(eml);
    }

    AppendMessagesResult appendMessagesResult = client.appendMessages(emlList);
    List<String> uidList = new ArrayList<>();
    for (String uid : appendMessagesResult.getSucceeded().getValues()) {
        uidList.add(uid);
    }

    // Bulk Delete appended Messages
    client.deleteMessagesByUids(uidList, true);
    client.commitDeletes();
}

Java: IMAP 서버의 폴더 작업

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

폴더 정보 가져오기

Aspose.Email를 사용하면 IMAP 서버에서 폴더 정보를 얻는 것이 매우 쉽습니다. 다음을 호출하세요 listFolders() 메서드 ImapClient 클래스. 이것은 다음 객체를 반환합니다 ImapFolderInfoCollection 형식. 이 컬렉션을 반복하면서 개별 폴더 정보를 루프에서 가져옵니다. 메서드는 오버로드됩니다. 폴더 이름을 매개변수로 전달하여 하위 폴더 목록을 가져올 수 있습니다. 다음 코드 스니펫은 설명된 Aspose.Email 메서드를 사용하여 IMAP 서버에서 폴더 정보를 가져오는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Get all folders in the currently subscribed folder
ImapFolderInfoCollection folderInfoColl = client.listFolders();

// Iterate through the collection to get folder info one by one
for (ImapFolderInfo folderInfo : (Iterable<ImapFolderInfo>) folderInfoColl) {
    // Folder name and get New messages in the folder
    System.out.println("Folder name is " + folderInfo.getName());
    ImapFolderInfo folderExtInfo = client.getFolderInfo(folderInfo.getName());
    System.out.println("New message count: " + folderExtInfo.getNewMessageCount());
    System.out.println("Is it readonly? " + folderExtInfo.getReadOnly());
    System.out.println("Total number of messages " + folderExtInfo.getTotalMessageCount());
}

폴더 삭제 및 이름 바꾸기

IMAP 서버의 폴더는 Aspose.Email을 사용하여 한 줄로 삭제하거나 이름을 바꿀 수 있습니다:

다음은 deleteFolder() 메서드는 폴더 이름을 매개변수로 받습니다.
에 대해 renameFolder() 메서드를 호출할 때 현재 폴더 이름과 새 폴더 이름을 전달해야 합니다. 다음 코드 스니펫은 IMAP 서버에서 폴더를 삭제하고 이름을 바꾸는 방법을 보여줍니다. 각 작업은 한 줄의 코드로 수행됩니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Delete a folder and Rename a folder
client.deleteFolder("foldername");
client.renameFolder("foldername", "newfoldername");

폴더에 새 메시지 추가

다음 방법을 사용하여 폴더에 새 메시지를 추가할 수 있습니다 MailMessage 및 ImapClient 클래스. 먼저, 다음을 생성합니다 MailMessage 제목, 받는 사람 및 보낸 사람 값을 제공하여 객체를 생성합니다. 그런 다음 폴더를 구독하고 메시지를 추가합니다. 다음 코드 스니펫은 폴더에 새 메시지를 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create a message
MailMessage msg = new MailMessage("user@domain1.com", "user@domain2.com", "subject", "message");

// Subscribe to the Inbox folder and Append the newly created message
client.selectFolder(ImapFolderInfo.IN_BOX);
client.subscribeFolder(client.getCurrentFolder().getName());
client.appendMessage(client.getCurrentFolder().getName(), msg);

MultiConnection 지원으로 다중 메시지 추가

다음과 같이 여러 메시지를 추가할 수 있습니다 appendMessages 에 의해 제공되는 메서드 ImapClient 클래스. appendMessages 메서드는 다음 목록을 받습니다 MailMessage 폴더가 매개변수로 제공되지 않으면 현재 폴더에 추가합니다. ImapClient는 고부하 작업을 위해 MultiConnection 모드도 지원합니다. 다음 코드 스니펫은 MultiConnection 모드를 사용하여 여러 메시지를 추가하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

List<MailMessage> messages = new ArrayList<MailMessage>();
for (int i = 0; i < 20; i++) {
    MailMessage message = new MailMessage("<EMAIL ADDRESS>", "<EMAIL ADDRESS>", "Test Message - " + UUID.randomUUID().toString(), "IMAP Group Append with MultiConnection");
    messages.add(message);
}

imapClient.setConnectionsQuantity(5);
imapClient.setUseMultiConnection(MultiConnectionMode.Enable);
imapClient.appendMessages(messages);

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

다른 사서함 폴더로 메시지 이동

Aspose.Email for Java 은(는) 메시지를 한 사서함 폴더에서 다른 폴더로 이동하도록 허용합니다. ImapClient API. The moveMessage 메서드는 메시지 고유 ID와 대상 폴더 이름을 사용하여 메시지를 대상 폴더로 이동합니다. 다음 코드 스니펫은 메시지를 다른 사서함 폴더로 이동하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// This example shows how to move a message from one folder of a mailbox to another one using the ImapClient API of Aspose.Email for Java
// Available from Aspose.Email for Java onwards
// -------------- Available API Overload Members --------------
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(int sequenceNumber, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(String uniqueId, String folderName, boolean commitDeletions)
// void ImapClient.moveMessage(IConnection iConnection, int sequenceNumber, String folderName)
// void ImapClient.moveMessage(IConnection iConnection, String uniqueId, String folderName)
// void ImapClient.moveMessage(int sequenceNumber, String folderName)
// void ImapClient.moveMessage(String uniqueId, String folderName)

final ImapClient client = new ImapClient("host.domain.com", 993, "username", "password");
try {
    String folderName = "EMAILNET-35151";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-35151 - " + UUID.randomUUID(),
                "EMAILNET-35151 ImapClient: Provide option to Move Message");
        client.selectFolder(ImapFolderInfo.IN_BOX);
        // Append the new message to Inbox folder
        String uniqueId = client.appendMessage(ImapFolderInfo.IN_BOX, message);
        ImapMessageInfoCollection messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Now move the message to the folder EMAILNET-35151
        client.moveMessage(uniqueId, folderName);
        client.commitDeletes();
        // Verify that the message was moved to the new folder
        client.selectFolder(folderName);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
        // Verify that the message was moved from the Inbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        messageInfoCol1 = client.listMessages();
        System.out.println(messageInfoCol1.size());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

다른 사서함 폴더로 메시지 복사

Aspose.Email API는 한 메일함 폴더에서 다른 폴더로 메시지를 복사하는 기능을 제공합니다. 이를 통해 단일 및 다중 메시지를 다음을 사용하여 복사할 수 있습니다 copyMessage 및 copyMessages 메서드. copyMessages 메서드는 메일함의 소스 폴더에서 대상 메일함 폴더로 여러 메시지를 복사할 수 있는 기능을 제공합니다. 다음 코드 스니펫은 메시지를 다른 메일함 폴더로 복사하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("exchange.aspose.com", "username", "password");
try {
    // Create the destination folder
    String folderName = "EMAILNET-35242";
    if (!client.existFolder(folderName))
        client.createFolder(folderName);
    try {
        // Append a couple of messages to the server
        MailMessage message1 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId1 = client.appendMessage(message1);

        MailMessage message2 = new MailMessage("asposeemail.test3@aspose.com", "asposeemail.test3@aspose.com", "EMAILNET-35242 - " + UUID.randomUUID(),
                "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        String uniqueId2 = client.appendMessage(message2);

        // Verify that the messages have been added to the mailbox
        client.selectFolder(ImapFolderInfo.IN_BOX);
        ImapMessageInfoCollection msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());

        // Copy multiple messages using the CopyMessages command and Verify that messages are copied to the destination folder
        client.copyMessagesByUids(Arrays.asList(uniqueId1, uniqueId2), folderName);

        client.selectFolder(folderName);
        msgsColl = client.listMessages();
        for (ImapMessageInfo msgInfo : msgsColl)
            System.out.println(msgInfo.getSubject());
    } finally {
        try {
            client.deleteFolder(folderName);
        } catch (java.lang.RuntimeException e) {
        }
    }
} finally {
    if (client != null)
        client.dispose();
}

특수 용도 메일함 폴더 작업

일부 IMAP 메시지 저장소에는 초안이나 보낸 메일을 보관하는 특수 용도 메일함이 포함됩니다. 많은 메일 클라이언트는 사용자가 초안이나 보낸 메일의 저장 위치를 지정하도록 허용하지만, 이를 구성하려면 사용자가 서버가 이러한 용도로 할당한 메일함을 알아야 합니다. Aspose.Email는 다음을 사용하여 이러한 특수 용도 메일함을 식별할 수 있습니다 ImapMailboxInfo 클래스는 이를 더 쉽게 작업할 수 있게 합니다. 다음 코드 샘플은 다음을 사용하여 이러한 특수 용도 메일함에 접근하는 방법을 보여줍니다 ImapMailboxInfo 클래스.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapClient imapClient = new ImapClient();
imapClient.setHost("<HOST>");
imapClient.setPort(993);
imapClient.setUsername("<USERNAME>");
imapClient.setPassword("<PASSWORD>");
imapClient.setSupportedEncryption(EncryptionProtocols.Tls);
imapClient.setSecurityOptions(SecurityOptions.SSLImplicit);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();
System.out.println(mailboxInfo.getInbox());
System.out.println(mailboxInfo.getDraftMessages());
System.out.println(mailboxInfo.getJunkMessages());
System.out.println(mailboxInfo.getSentMessages());
System.out.println(mailboxInfo.getTrash());

Java: ImapClient 비동기 작업

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

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

메시지 비동기 검색

다음 코드 스니펫은 메시지를 비동기적으로 검색하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
try (ImapClient client = new ImapClient("host", "username", "password")) {
    client.selectFolder("Issues/SubFolder");
    ImapMessageInfoCollection messages = client.listMessages();
    IAsyncResult ar = client.beginFetchMessage(messages.get_Item(0).getSequenceNumber());
    MailMessage message = client.endFetchMessage(ar);
}

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

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
ImapQueryBuilder builder = new ImapQueryBuilder();
builder.getSubject().contains("Subject");
MailQuery query = builder.getQuery();
IAsyncResult asyncResult = client.beginListMessages(query);
ImapMessageInfoCollection messages = client.endListMessages(asyncResult);

Java: IMAP 서버 확장 목록

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

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.gmail.com", "username", "password");
String[] getCapabilities = client.getCapabilities();
for (String getCap : getCapabilities) {
    System.out.println(getCap);
}

Java: IMAP IDLE 명령 지원

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

Aspoe.Email API ImapClient 서버에 연결을 열고 이메일 메시지 도착을 기다리는 기능을 제공합니다. 이를 통해 들어오는 이메일을 위해 서버를 반복적으로 폴링하는 것을 피할 수 있습니다. 다음 코드 스니펫은 IMAP Idle 명령 지원 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

client.startMonitoring(new ImapMonitoringEventHandler() {
    public void invoke(Object sender, ImapMonitoringEventArgs e) {
        System.out.println(e.getNewMessages().length);
        System.out.println(e.getDeletedMessages().length);
    }
});
client.stopMonitoring("Inbox");

Java: IMAP IDLE 명령 및 확장 지원

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

IMAP Idle 명령 지원

Aspose.Email API ImapClient 서버에 연결을 열고 이메일 메시지 도착을 기다리는 기능을 제공합니다. 이를 통해 들어오는 이메일을 위해 서버를 반복적으로 폴링하는 것을 피할 수 있습니다. 다음 코드 스니펫은 IMAP Idle 명령 지원 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Connect and log in to IMAP
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

client.startMonitoring(new ImapMonitoringEventHandler() {
    public void invoke(Object sender, ImapMonitoringEventArgs e) {
        System.out.println(e.getNewMessages().length);
        System.out.println(e.getDeletedMessages().length);
    }
});
client.stopMonitoring("Inbox");

IMAP 확장 지원

Aspose.Email API는 IMAP 확장을 지원합니다. 현재 API에서 지원되는 IMAP 확장은 다음과 같습니다. 이러한 IMAP 확장은 모든 서버에서 지원되는 것은 아닙니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password");
try {
    // Set SecurityOptions
    client.setSecurityOptions(SecurityOptions.Auto);
    System.out.println(client.getIdSupported());

    ImapIdentificationInfo serverIdentificationInfo1 = client.introduceClient();
    ImapIdentificationInfo serverIdentificationInfo2 = client.introduceClient(ImapIdentificationInfo.getDefaultValue());

    // Display ImapIdentificationInfo properties
    System.out.println(serverIdentificationInfo1.toString() + serverIdentificationInfo2.toString());
    System.out.println(serverIdentificationInfo1.getName());
    System.out.println(serverIdentificationInfo1.getVendor());
    System.out.println(serverIdentificationInfo1.getSupportUrl());
    System.out.println(serverIdentificationInfo1.getVersion());
} finally {
    if (client != null)
        client.dispose();
}

IMAP4 확장 리스트 명령

다음 코드 스니펫은 IMAP4 확장 리스트 명령을 사용하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password");
try {
    ImapFolderInfoCollection folderInfoCol = client.listFolders("*");
    System.out.println("Extended List Supported: " + client.getExtendedListSupported());
    for (ImapFolderInfo folderInfo : (Iterable<ImapFolderInfo>) folderInfoCol) {
        if (folderInfo.getName().equals("[Gmail]/All Mail"))
            System.out.println("Has Children: " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Bin"))
            System.out.println("Bin has children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Drafts"))
            System.out.println("Drafts has children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Important"))
            System.out.println("Important has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Sent Mail"))
            System.out.println("Sent Mail has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Spam"))
            System.out.println("Spam has Children? " + folderInfo.hasChildren());
        if (folderInfo.getName().equals("[Gmail]/Starred"))
            System.out.println("Starred has Children? " + folderInfo.hasChildren());
    }
} finally {
    if (client != null)
        client.dispose();
}

Java: IMAP 백업 및 복원 작업

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

Aspose.Email for Java 은 메시지를 백업 및 복원할 수 있는 기능을 제공합니다. 이를 위해 API는 다음 메서드를 제공합니다.

이 문서는 메시지를 백업 및 복원하는 방법을 보여줍니다. ImapClient 클래스.

메시지 백업

메시지를 백업하려면 다음을 사용하십시오 ImapClient.backup 다음 코드 스니펫에 표시된 메서드입니다.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();

ImapFolderInfo info = imapClient.getFolderInfo(mailboxInfo.getInbox().getName());
ImapFolderInfoCollection infos = new ImapFolderInfoCollection();
infos.addItem(info);

imapClient.backup(infos, dataDir + "\\ImapBackup.pst", com.aspose.email.BackupSettings.to_BackupSettings(BackupOptions.Recursive));

메시지 복원

메시지를 백업하려면 다음을 사용하십시오 ImapClient.restore 다음 코드 스니펫에 표시된 메서드입니다.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

ImapRestoreSettings settings = new ImapRestoreSettings();
settings.setRecursive(true);
PersonalStorage pst = PersonalStorage.fromFile(dataDir + "\\ImapBackup.pst");
imapClient.restore(pst, settings);

멀티 연결을 통한 IMAP 백업 및 복원 작업

많은 수의 메시지를 처리할 때 백업/복원 작업에는 시간이 오래 걸릴 수 있습니다. 이를 위해 API는 백업 및 복원 작업 중 다중 연결을 지원합니다. 멀티 연결 모드를 활성화하려면 설정하십시오 ImapClient.UseMultiConnection 속성 MultiConnectionMode.Enable. 다음 코드 스니펫은 멀티 연결 모드가 활성화된 백업 및 복원 작업을 보여줍니다.

멀티 연결을 사용한 메시지 백업

다음 코드 스니펫은 멀티 연결 모드가 활성화된 백업 작업을 보여줍니다.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

imapClient.setUseMultiConnection(MultiConnectionMode.Enable);

ImapMailboxInfo mailboxInfo = imapClient.getMailboxInfo();

ImapFolderInfo info = imapClient.getFolderInfo(mailboxInfo.getInbox().getName());
ImapFolderInfoCollection infos = new ImapFolderInfoCollection();
infos.addItem(info);

imapClient.backup(infos, dataDir + "\\ImapBackup.pst", com.aspose.email.BackupSettings.to_BackupSettings(BackupOptions.Recursive));

멀티 연결을 사용한 메시지 복원

다음 코드 스니펫은 멀티 연결 모드가 활성화된 복원 작업을 보여줍니다.

// 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 = "data/";
// Create an instance of the ImapClient class
ImapClient imapClient = new ImapClient();

// Specify host, username and password, and set port for your client
imapClient.setHost("imap.gmail.com");
imapClient.setUsername("your.username@gmail.com");
imapClient.setPassword("your.password");
imapClient.setPort(993);
imapClient.setSecurityOptions(SecurityOptions.Auto);

imapClient.setUseMultiConnection(MultiConnectionMode.Enable);

ImapRestoreSettings settings = new ImapRestoreSettings();
settings.setRecursive(true);
PersonalStorage pst = PersonalStorage.fromFile(dataDir + "\\Outlook.pst");
imapClient.restore(pst, settings);