Documentation – Exchange EWS 클라이언트 작업

Java: Exchange Server에 연결

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

Exchange Web Service를 사용하여 Exchange 서버 2007, 2010 및 2013에 연결하려면 Aspose.Email이 제공합니다. IEWSClient 다음 인터페이스를 구현합니다. EWSClient 클래스. EWSClient.getEWSClient 메서드는 다음을 인스턴스화하고 반환합니다. IEWSClient Exchange 메일함 및 기타 폴더와 관련된 작업을 수행하는 데 사용되는 객체입니다. 이 문서는 다음 객체를 인스턴스화하는 방법을 보여줍니다. IEWSClient.

EWS를 사용하여 Exchange Server에 연결

다음 코드 스니펫은 Exchange Web Service(EWS)를 사용하여 연결하는 방법을 보여줍니다.

private static IEWSClient getExchangeEWSClient() {
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String domain = "";
    final String username = "username@onmicrosoft.com";
    final String password = "password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
    return client;
}

IMAP을 사용하여 Exchange Server에 연결

Microsoft Exchange Server는 메일함 항목에 액세스하기 위해 IMAP 프로토콜을 지원합니다. Aspose.Email을 사용하십시오. ImapClient IMAP 프로토콜을 사용하여 Exchange Server에 연결하는 클래스입니다. 자세한 내용은 ImapClient 클래스. 먼저 Exchange Server에서 IMAP 서비스가 활성화되어 있는지 확인하십시오:

제어판을 엽니다.
관리자 도구로 이동한 다음 서비스로 이동합니다.
Microsoft Exchange IMAP4 서비스 상태를 확인합니다.
이미 실행 중이 아니라면 활성화/시작하십시오.

다음 코드 스니펫은 IMAP 프로토콜을 사용하여 Microsoft Exchange Server의 받은 편지함 폴더에 연결하고 메시지를 나열하는 방법을 보여줍니다.

// Connect to Exchange Server using ImapClient class
ImapClient imapClient = new ImapClient("ex07sp1", "Administrator", "Evaluation1");
imapClient.setSecurityOptions(SecurityOptions.Auto);

// Select the Inbox folder
imapClient.selectFolder(ImapFolderInfo.IN_BOX);

// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.listMessages();
for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
    System.out.println(msgInfo.getSubject());
}
// Disconnect from the server
imapClient.dispose();

다음 코드 스니펫은 SSL을 사용하는 방법을 보여줍니다.

public static void run() {
    // Connect to Exchange Server using ImapClient class
    ImapClient imapClient = new ImapClient("ex07sp1", 993, "Administrator", "Evaluation1");
    imapClient.setSecurityOptions(SecurityOptions.SSLExplicit);

    // Select the Inbox folder
    imapClient.selectFolder(ImapFolderInfo.IN_BOX);

    // Get the list of messages
    ImapMessageInfoCollection msgCollection = imapClient.listMessages();
    for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
        System.out.println(msgInfo.getSubject());
    }
    // Disconnect from the server
    imapClient.dispose();
}

IMAP을 사용하여 Exchange 서버에 연결하고 다음을 가져온 후 IMapMessageInfoCollection, 다음 코드 스니펫은 이를 사용하는 방법을 보여줍니다. MessageInfo 특정 메시지를 저장하기 위한 객체의 시퀀스 번호.

// Select the Inbox folder
imapClient.selectFolder(ImapFolderInfo.IN_BOX);
// Get the list of messages
ImapMessageInfoCollection msgCollection = imapClient.listMessages();
for (ImapMessageInfo msgInfo : (Iterable<ImapMessageInfo>) msgCollection) {
    // Fetch the message from inbox using its SequenceNumber from msgInfo
    MailMessage message = imapClient.fetchMessage(msgInfo.getSequenceNumber());

    // Save the message to disc now
    message.save(dataDir + msgInfo.getSequenceNumber() + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

Java: Exchange 사서함 및 메시지 작업 - Java에서 Exchange 서버에서 이메일 읽기

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

EWS를 사용해 사서함 정보 얻기

다음은 EWSClient 클래스는 Exchange Server에서 메일함 정보를 가져오기 위해 다음을 호출하여 사용할 수 있는 멤버를 가지고 있습니다: IEWSClient.getMailboxInfo() 메서드. 해당 타입의 인스턴스를 반환합니다. ExchangeMailboxInfo. 다음과 같은 속성에서 메일함 정보를 가져옵니다: MailboxUri, InboxUri 및 DraftsUri. 이 문서는 Exchange Web Services를 사용해 사서함 정보를 접근하는 방법을 보여줍니다.

Exchange Web Services(EWS)를 사용해 Exchange Server에 연결하려면, 다음을 사용하세요. EWSClient 클래스. 이 클래스는 EWS를 사용해 Exchange Server에 연결하고 항목을 관리합니다. 다음 Java 코드 스니펫은 Exchange Web Services를 사용해 사서함 정보를 가져오는 방법을 보여줍니다.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get mailbox size, exchange mailbox info, Mailbox and Inbox folder URI
System.out.println("Mailbox size: " + client.getMailboxSize() + " bytes");
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
System.out.println("Inbox folder URI: " + mailboxInfo.getInboxUri());
System.out.println("Sent Items URI: " + mailboxInfo.getSentItemsUri());
System.out.println("Drafts folder URI: " + mailboxInfo.getDraftsUri());

이메일 메시지 보내기

다음 도구를 사용해 Exchange Server로 이메일 메시지를 보낼 수 있습니다. Aspose.Email.Exchange. IEWSClient.Send() 메서드는 MailMessage 인스턴스를 매개변수로 받아 이메일을 보냅니다. 이 문서는 Exchange Web Services를 사용해 이메일 메시지를 보내는 방법을 설명합니다.

Aspose.Email는 Exchange Web Services를 사용해 Microsoft Exchange Server에 연결하는 IEWSClient 클래스를 제공합니다. 다음 코드 스니펫은 EWS를 사용해 Microsoft Exchange Server로 이메일을 보내는 방법을 보여줍니다. 아래 Java 코드 스니펫은 EWS를 사용해 이메일 메시지를 보내는 방법을 보여줍니다.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create instance of type MailMessage
MailMessage msg = new MailMessage();
msg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
msg.setTo(MailAddressCollection.to_MailAddressCollection("recipient@ domain.com "));
msg.setSubject("Sending message from exchange server");
msg.setHtmlBody("<h3>sending message from exchange server</h3>");

// Send the message
client.send(msg);

메시지 클래스 가져오기

다음은 getMessageClass() 메서드 ExchangeMessageInfo 클래스는 메시지의 클래스를 나타내는 문자열을 반환합니다. 아래 코드는 메시지 클래스를 얻는 방법을 보여줍니다.

try (IEWSClient client = EWSClient.getEWSClient(uri, credentials))
{
    ExchangeMessageInfoCollection messageInfoCollection = client.listMessagesFromPublicFolder(publicFolder);

    for (ExchangeMessageInfo messageInfo : messageInfoCollection)
    {
        System.out.println("Message Class: " + messageInfo.getMessageClass());
    }
}

다른 사용자의 사서함에서 이메일 읽기

Exchange 서버의 일부 계정은 여러 사서함에 접근 권한이 있으며, 일부 사용자는 동일한 Exchange 서버에서 여러 이메일 계정을 가집니다. 두 경우 모두 Aspose.Email for Java를 사용해 다른 사용자의 사서함에 접근할 수 있습니다. 이 API는 다른 사서함의 폴더와 이메일에 접근하는 메커니즘을 제공합니다. IEWSClient 클래스. 이 기능은 오버로드된 getMailboxInfo() 메서드와 사용자 이메일 주소를 매개변수로 제공하여.

다음 코드 스니펫은 이메일을 읽는 방법을 보여줍니다. IEWSClient 클래스.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get Exchange mailbox info of other email account
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo("otherUser@domain.com");

메시지 나열

Exchange 메일함의 이메일 메시지 목록은 다음을 호출하여 가져올 수 있습니다: IEWSClient.listMessages 메서드. 제목, 발신자, 수신자 및 메시지 ID와 같은 기본 정보를 가져오려면 다음을 사용하십시오: listMessages 메서드.

간단한 메시지 목록

Exchange 사서함의 메시지를 나열하려면:

다음의 인스턴스를 생성합니다. IEWSClient 클래스.
listMessages 메서드를 호출하고 메시지 컬렉션을 생성합니다.
컬렉션을 반복하며 메시지 정보를 표시합니다.

다음 Java 코드 스니펫은 EWS를 사용해 Exchange 서버에 연결하고 Inbox 폴더에서 메시지를 나열하는 방법을 보여줍니다.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject: " + msgInfo.getSubject());
    System.out.println("From: " + msgInfo.getFrom().toString());
    System.out.println("To: " + msgInfo.getTo().toString());
    System.out.println("Message ID: " + msgInfo.getMessageId());
    System.out.println("Unique URI: " + msgInfo.getUniqueUri());
}

다양한 폴더에서 메시지 나열

위의 코드 스니펫들, Inbox 폴더의 모든 메시지를 나열합니다. 다른 폴더의 메시지 목록도 가져올 수 있습니다. IEWSClient.listMessages() 메서드는 폴더 URI를 매개변수로 받습니다. 폴더 URI가 유효하면 해당 폴더의 메시지 목록을 가져올 수 있습니다. IEWSClient.getMailboxInfo().getXXXFolderUri 속성을 사용해 다양한 폴더의 URI를 얻으세요. 나머지 코드는 메시지 목록을 얻는 것과 동일합니다. 다음 코드 스니펫은 EWS를 사용해 다양한 폴더에서 메시지를 나열하는 방법을 보여줍니다.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get folder URI
String strFolderURI = "";
strFolderURI = client.getMailboxInfo().getInboxUri();
strFolderURI = client.getMailboxInfo().getDeletedItemsUri();
strFolderURI = client.getMailboxInfo().getDraftsUri();
strFolderURI = client.getMailboxInfo().getSentItemsUri();

// Get list of messages from the specified folder
ExchangeMessageInfoCollection msgCollection = client.listMessages(strFolderURI);

페이지 지원 메시지 목록

다음 Java 코드 스니펫은 페이지 지원이 있는 메시지 목록을 가져오는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
final IEWSClient client = EWSClient.getEWSClient("exchange.domain.com", "username", "password");
try {
    try {
        // Create some test messages to be added to server for retrieval later
        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-35157_1 - " + UUID.randomUUID().toString(),
                    "EMAILNET-35157 Move paging parameters to separate class");
            client.appendMessage(client.getMailboxInfo().getInboxUri(), message);
        }
        // Verfiy that the messages have been added to the server
        ExchangeMessageInfoCollection totalMessageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
        System.out.println(totalMessageInfoCol.size());

        ////////////////// RETREIVING THE MESSAGES USING PAGING SUPPORT ////////////////////////////////////

        List<ExchangeMessagePageInfo> pages = new ArrayList<ExchangeMessagePageInfo>();
        ExchangeMessagePageInfo pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
        // Total Pages Count
        System.out.println(pageInfo.getTotalCount());

        pages.add(pageInfo);
        while (!pageInfo.getLastPage()) {
            pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage, pageInfo.getPageOffset() + 1);
            pages.add(pageInfo);
        }
        int retrievedItems = 0;
        // foreach to while statements conversion
        for (ExchangeMessagePageInfo pageCol : pages) {
            retrievedItems += pageCol.getItems().size();
        }
        // Verify total message count using paging
        System.out.println(retrievedItems);
    } finally {
    }
} finally {
    client.dispose();
}

ExchangeMessageInfo에서 메시지 유형 정보 가져오기

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeMessageInfoCollection list = client.listMessages(client.getMailboxInfo().getDeletedItemsUri());
System.out.println(list.get_Item(0).getMessageInfoType()); // MessageInfoType

메시지 저장

이 문서는 Exchange Server 사서함에서 메시지를 가져와 디스크에 EML 및 MSG 형식으로 저장하는 방법을 보여줍니다.

디스크에 EML로 저장.
메모리 스트림에 저장.
MSG로 저장.

EML로 메시지 저장

메시지를 가져와 EML 형식으로 저장하려면:

IEWSC lient 클래스의 인스턴스를 생성합니다.
mailboxUri, 사용자명, 비밀번호 및 도메인을 제공합니다.
IEWSC lient.listMessages() 메서드를 호출해 ExchangeMessagesInfoCollection 컬렉션 인스턴스를 가져옵니다.
ExchangeMessagesInfoCollection 컬렉션을 반복하여 각 메시지의 고유 URI를 가져옵니다.
IEWSC lient.saveMessage() 메서드를 호출하고 고유 URI를 매개변수로 전달합니다.
saveMessage() 메서드에 파일을 저장할 경로를 제공합니다.

다음 코드 스니펫은 EWS를 사용해 Exchange Server에 연결하고 메시지를 EML 파일로 저장하는 방법을 보여줍니다.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now save the message in disk
    client.saveMessage(strMessageURI, dataDir + msgInfo.getMessageId() + "out.eml");
}

메시지를 메모리 스트림에 저장

EML 파일을 디스크에 저장하는 대신 메모리 스트림에 저장할 수 있습니다. 이는 스트림을 데이터베이스와 같은 저장소에 저장하려는 경우에 유용합니다. 스트림이 데이터베이스에 저장되면 EML 파일을 다시 로드할 수 있습니다. MailMessage 클래스. 다음 코드 스니펫은 EWS를 사용해 Exchange Server 사서함에서 메시지를 메모리 스트림에 저장하는 방법을 보여줍니다.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now save the message in memory stream
    ByteArrayOutputStream stream = new ByteArrayOutputStream();
    client.saveMessage(strMessageURI, stream);
}

MSG 형식으로 메시지 저장

다음은 IEWSClient.saveMessage() 메서드는 메시지를 직접 EML 형식으로 저장할 수 있습니다. MSG 형식으로 저장하려면 먼저 IEWSClient.fetchMessage() 인스턴스를 반환하는 메서드 MailMessage 클래스. 그런 다음 호출합니다 MailMessage.save() 메시지를 MSG로 저장하는 메서드. 다음 코드 스니펫은 Exchange Server 사서함에서 메시지를 가져와 EWS를 사용해 MSG 형식으로 저장하는 방법을 보여줍니다.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

int count = 0;
// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now get the message details using FetchMessage() and Save message as Msg
    MailMessage message = client.fetchMessage(strMessageURI);
    message.save(dataDir + (count++) + "_out.msg", SaveOptions.getDefaultMsgUnicode());
}

Message URI에서 ExchangeMessageInfo 가져오기

이메일 메시지는 고유 식별자와 URI로 표현되며, 다음의 필수 부분입니다. ExchangeMessageInfo 객체. 메시지 URI만 가능한 경우, 다음과 같이 ExchangeMessageInfo 객체는 이 정보로도 검색할 수 있습니다. 오버로드 버전은 listMessages 사용할 Id 목록을 받습니다. ExchangeMessageInfoCollection. 다음 코드 스니펫은 가져오는 방법을 보여줍니다. ExchangeMessageInfo 메시지 URI에서.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "user@domain.com", "pwd", "domain");

List<String> ids = new ArrayList<String>();
List<MailMessage> messages = new ArrayList<MailMessage>();

for (int i = 0; i < 5; i++) {
    MailMessage message = new MailMessage("user@domain.com", "receiver@domain.com", "EMAILNET-35033 - " + UUID.randomUUID().toString(),
            "EMAILNET-35033 Messages saved from Sent Items folder doesn't contain 'To' field");
    messages.add(message);
    String uri = client.appendMessage(message);
    ids.add(uri);
}

ExchangeMessageInfoCollection messageInfoCol = client.listMessages(ids);

for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) messageInfoCol) {
    // Do something ...
    System.out.println(messageInfo.getUniqueUri());
}

Exchange Server 사서함에서 메시지 가져오기

Exchange Server에서 메시지 나열은 listMessages() Exchange Server 사서함에서 메시지 목록을 가져오는 메서드입니다. listMessages() 메서드는 메시지의 기본 정보를 가져옵니다(예: 제목, 메시지 ID, 발신자 및 수신자). 전체 메시지 세부 정보를 얻으려면 Aspose.Email.Exchange가 IEWSClient.fetchMessage() 메서드를 제공합니다. 이 메서드는 메시지 URI를 매개변수로 받아 해당 인스턴스를 반환합니다. MailMessage 클래스. MailMessage 클래스는 본문, 헤더 및 첨부 파일과 같은 메시지 세부 정보를 제공합니다. 자세히 알아보세요. MailMessage API, 또는 이메일 관리 방법을 확인하십시오. MailMessage 클래스. Exchange Server 사서함에서 메시지를 가져오려면:

IEWSC lient 타입의 인스턴스를 생성합니다.
서버 이름, 사용자 이름, 비밀번호 및 도메인을 지정합니다.
listMessages를 호출하여 ExchangeMessageInfoCollection을 가져옵니다.
ExchangeMessageInfoCollection 컬렉션을 반복하여 ExchangeMessageInfo.UniqueURI 값을 가져옵니다.
IEWSC lient.fetchMessage()를 호출하고 ExchangeMessageInfo.UniqueURI를 매개변수로 전달합니다.

다음 코드 스니펫은 Exchange Server 사서함에 연결하고 EWS를 사용하여 모든 메시지를 가져오는 방법을 보여줍니다.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    String strMessageURI = msgInfo.getUniqueUri();

    // Now get the message details using FetchMessage()
    MailMessage msg = client.fetchMessage(strMessageURI);

    for (Attachment att : (Iterable<Attachment>) msg.getAttachments()) {
        System.out.println("Attachment Name: " + att.getName());
    }
}

FetchItem 메서드를 사용하여 메시지 가져오기

주의, FetchItem 메서드는 첨부 파일 없이 메시지를 반환합니다. 첨부 파일이 있는 메시지를 가져오려면 다음을 사용하세요. FetchItem 아래 섹션에 설명된 메서드.

다음은 FetchItem 메시지를 가져오려면 이 메서드가 더 선호됩니다. MapiMessage 그리고 MAPI 속성과 함께 작동합니다. 이 메서드를 사용하여 연락처, 약속, 작업 등 Outlook 항목을 가져올 수도 있습니다.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to get Message URI
for (ExchangeMessageInfo msgInfo : msgCollection)
{
    // Now get the message using FetchItem()
    MapiMessage msg = client.fetchItem(msgInfo.getUniqueUri());

    // If necessary, you can cast the MapiMessage to the proper item type to simplify working with its properties.
    MapiContact contact = (MapiContact) msg.toMapiMessageItem();
}

메시지 크기 사전 가져오기

Microsoft Outlook InterOp은 서버에서 전체 메시지를 실제로 가져오기 전에 메시지 크기를 가져오는 기능을 제공합니다. Aspose.Email API의 경우, Exchange 서버에서 가져온 요약 정보는 다음과 같이 나타냅니다. ExchangeMessageInfo 클래스. Size 속성을 사용하여 메시지 크기를 가져오는 동일한 기능을 제공합니다. 메시지 크기를 가져오기 위해 표준 호출인 IEWSClient의 listMessages가 컬렉션을 검색하는 데 사용됩니다. ExchangeMessageInfo. 다음 코드 스니펫은 메시지 크기를 표시하는 방법을 보여줍니다. ExchangeMessageInfo 클래스.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

// Loop through the collection to display the basic information
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject: " + msgInfo.getSubject());
    System.out.println("From: " + msgInfo.getFrom().toString());
    System.out.println("To: " + msgInfo.getTo().toString());
    System.out.println("Message Size: " + msgInfo.getSize());
    System.out.println("==================================");
}

메시지 재귀 다운로드

다음은 EWSClient’s listSubFolders() 이 메서드는 Exchange Server 메일함의 폴더와 하위 폴더에서 메시지를 재귀적으로 가져오는 데 사용할 수 있습니다. EWS를 사용하므로 Exchange Server 2007 이상이 필요합니다. 다음 코드 스니펫은 Exchange Server의 전체 메일함(폴더 및 하위 폴더)을 다운로드하는 방법을 보여줍니다. 폴더 구조가 로컬에 생성되고 모든 메시지가 다운로드됩니다.

public static void run() {
    try {
        downloadAllMessages();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void downloadAllMessages() {
    try {
        String rootFolder = domain + "-" + username;
        new File(rootFolder).mkdirs();
        String inboxFolder = rootFolder + "\\Inbox";
        new File(inboxFolder).mkdirs();

        System.out.println("Downloading all messages from Inbox....");
        // Create instance of IEWSClient class by giving credentials
        IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", username, password, domain);

        ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
        System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
        String rootUri = client.getMailboxInfo().getRootUri();
        // List all the folders from Exchange server
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(rootUri);
        for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listMessagesInFolder(client, folderInfo, rootFolder);
        }

        System.out.println("All messages downloaded.");
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

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

    // List messages
    ExchangeMessageInfoCollection msgInfoColl = client.listMessages(folderInfo.getUri());
    System.out.println("Listing messages....");
    int i = 0;
    for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
        // Get subject and other properties of the message
        System.out.println("Subject: " + msgInfo.getSubject());

        // Get rid of characters like ? and :, which should not be included in a file name
        String fileName = msgInfo.getSubject().replace("?", " ").replace(":", " ");

        MailMessage msg = client.fetchMessage(msgInfo.getUniqueUri());
        msg.save(dataDir + "\\" + fileName + "-" + i + ".msg");

        i++;
    }
    System.out.println("============================\n");
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(folderInfo.getUri());
        for (ExchangeFolderInfo subfolderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            listMessagesInFolder(client, subfolderInfo, currentFolder);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

공용 폴더에서 메시지 다운로드

Microsoft Exchange Server는 사용자가 공개 폴더를 만들고 그 안에 메시지를 게시하도록 허용합니다. 애플리케이션을 통해 이를 수행하려면 Aspose.Email을 사용하십시오. EWSClient Exchange Server에 연결하고 공용 폴더에서 메시지와 게시물을 읽고 다운로드하는 클래스입니다. 다음 코드 스니펫은 모든 공용 폴더와 하위 폴더를 읽고, 해당 폴더에서 발견된 모든 메시지를 나열하고 다운로드하는 방법을 보여줍니다. 이 예제는 EWS를 지원하는 Microsoft Exchange Server 2007 이상에서만 작동합니다.

public static void run() {
    try {
        readPublicFolders();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void readPublicFolders() {
    NetworkCredential credential = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

    ExchangeFolderInfoCollection folders = client.listPublicFolders();
    for (ExchangeFolderInfo publicFolder : (Iterable<ExchangeFolderInfo>) folders) {
        System.out.println("Name: " + publicFolder.getDisplayName());
        System.out.println("Subfolders count: " + publicFolder.getChildFolderCount());
        listMessagesFromSubFolder(publicFolder, client);

    }
}

private static void listMessagesFromSubFolder(ExchangeFolderInfo publicFolder, IEWSClient client) {
    System.out.println("Folder Name: " + publicFolder.getDisplayName());
    ExchangeMessageInfoCollection msgInfoCollection = client.listMessagesFromPublicFolder(publicFolder);
    for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) msgInfoCollection) {
        MailMessage msg = client.fetchMessage(messageInfo.getUniqueUri());
        System.out.println(msg.getSubject());
        msg.save(dataDir + msg.getSubject() + ".msg", SaveOptions.getDefaultMsgUnicode());
    }

    // Call this method recursively for any subfolders
    if (publicFolder.getChildFolderCount() > 0) {
        ExchangeFolderInfoCollection subfolders = client.listSubFolders(publicFolder);
        for (ExchangeFolderInfo subfolder : (Iterable<ExchangeFolderInfo>) subfolders) {
            listMessagesFromSubFolder(subfolder, client);
        }
    }
}

메시지 이동

다음의 도움으로 이메일 메시지를 한 폴더에서 다른 폴더로 이동할 수 있습니다: IEWSClient 클래스 move 메서드. 매개변수는 다음과 같습니다:

이동될 메시지의 고유 URI.
대상 폴더의 고유 URI.

폴더 간 메시지 이동

다음 코드 스니펫은 메일함에서 받은 편지함 폴더의 메시지를 Processed 라는 폴더로 이동하는 방법을 보여줍니다. 이 예제에서 애플리케이션은:

Inbox 폴더에서 메시지를 읽습니다.
일부 기준에 따라 메시지를 처리합니다(예: 메시지 제목에 키워드가 있는지 확인).
주어진 조건을 충족하는 메시지를 처리 폴더로 이동합니다.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();

// List all messages from Inbox folder
System.out.println("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.listMessages(mailboxInfo.getInboxUri());
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
    // Move message to "Processed" folder, after processing certain messages based on some criteria
    if (msgInfo.getSubject() != null && msgInfo.getSubject().toLowerCase().contains("process this message")) {
        client.moveItem(mailboxInfo.getDeletedItemsUri(), msgInfo.getUniqueUri()); // EWS
        System.out.println("Message moved...." + msgInfo.getSubject());
    } else {
        // Do something else
    }
}

메시지 삭제

폴더에서 이메일 메시지를 삭제하려면 다음을 사용하면 됩니다. IEWSClient 클래스 deleteItem 메서드. 메시지의 고유 URI를 매개변수로 받습니다.

다음 코드 스니펫은 Inbox 폴더에서 메시지를 삭제하는 방법을 보여줍니다. 예시를 위해, 코드는:

Inbox 폴더에서 메시지를 읽습니다.
일부 기준에 따라 메시지를 처리합니다(이 예에서는 메시지 제목에 키워드가 있는지를 찾습니다).
메시지를 삭제합니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();

// List all messages from Inbox folder
System.out.println("Listing all messages from Inbox....");
ExchangeMessageInfoCollection msgInfoColl = client.listMessages(mailboxInfo.getInboxUri());
for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgInfoColl) {
    // Delete message based on some criteria
    if (msgInfo.getSubject() != null && msgInfo.getSubject().toLowerCase().contains("delete") == true) {
        client.deleteItem(msgInfo.getUniqueUri(), DeletionOptions.getDeletePermanently()); // EWS
        System.out.println("Message deleted...." + msgInfo.getSubject());
    } else {
        // Do something else
    }
}

메시지 복사

Aspose.Email API는 메시지를 한 폴더에서 다른 폴더로 복사할 수 있습니다. copyItem 메서드. 이 메서드의 오버로드된 버전은 이 문서에 표시된 복사된 메시지의 고유 URI를 반환합니다.

메시지를 다른 폴더로 복사

다음 코드 스니펫은 메시지를 다른 폴더로 복사하는 방법을 보여줍니다.

try {
    // Create instance of EWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
    MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-34997 - " + UUID.randomUUID().toString(),
            "EMAILNET-34997 Exchange: Copy a message and get reference to the new Copy item");
    String messageUri = client.appendMessage(message);
    String newMessageUri = client.copyItem(messageUri, client.getMailboxInfo().getDeletedItemsUri());
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Java: Exchange 사서함에서 메시지 필터링

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

Aspose.Email for Java는 Exchange 사서함에서 메시지를 필터링하는 기능을 제공합니다. EWSClient 및 ExchangeQueryBuilder. 메시지는 날짜, 도메인, 메시지-ID, 메일 전달 알림 등 다양한 기준으로 필터링될 수 있습니다. 이 문서는 다양한 기준을 사용하여 Exchange Server에서 메시지를 필터링하는 방법을 보여줍니다.

EWS를 사용한 메시지 필터링

다음은 IEWSClient class는 다음을 제공합니다 listMessages() 메일함에서 모든 메시지를 가져오는 메서드입니다. 특정 조건에 일치하는 메시지만 가져오려면 오버로드된 메서드를 사용하십시오. listMessages() 매개변수를 받는 메서드 MailQuery 클래스를 인수로 사용합니다. MailQuery 클래스는 날짜, 제목, 발신자 및 수신자 등 조건을 지정하기 위한 다양한 속성을 제공합니다. 또한 API는 메일함에서 이메일을 검색할 때 대소문자 구분 필터를 적용할 수 있도록 합니다.

메시지 필터링

사서함에서 필터링된 메시지를 가져오려면:

Exchange 서버에 연결합니다.
MailQuery 인스턴스를 만들고 원하는 속성을 설정합니다.
IEWSClient.listMessages() 메서드를 호출하고 매개변수에 MailQuery를 전달하여 필터링된 메시지만 가져옵니다.

다음 코드 스니펫은 IMAP 메일함에 연결하고 제목에 "Newsletter" 문자열이 포함되며 오늘 보낸 메시지를 가져오는 방법을 보여줍니다.

try {
    // Connect to EWS
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String username = "username";
    final String password = "password";
    final String domain = "domain";

    IEWSClient client = EWSClient.getEWSClient(mailboxUri, username, password, domain);

    // Query building by means of ExchangeQueryBuilder class
    ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

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

    MailQuery query = builder.getQuery();

    // Get list of messages
    ExchangeMessageInfoCollection messages = client.listMessages(client.getMailboxInfo().getInboxUri(), query, false);
    System.out.println("EWS: " + messages.size() + " message(s) found.");

    // Disconnect from EWS
    client.dispose();
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

조건으로 메시지 필터링

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

오늘 날짜로 메시지 필터링

다음 코드 스니펫은 오늘 날짜를 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다.

// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.getInternalDate().on(new Date());

날짜 범위로 메시지 필터링

다음 코드 스니펫은 날짜 범위를 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다.

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

특정 발신자로 메시지 필터링

다음 코드 스니펫은 특정 발신자를 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다.

// Get emails from specific sender
builder.getFrom().contains("saqib.razzaq@127.0.0.1");

특정 도메인으로 메시지 필터링

다음 코드 스니펫은 특정 도메인을 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다.

// Get emails from specific domain
builder.getFrom().contains("SpecificHost.com");

특정 수신자로 메시지 필터링

다음 코드 스니펫은 특정 수신자를 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다.

// Get emails sent to specific recipient
builder.getTo().contains("recipient");

MessageID로 메시지 필터링

다음 코드 스니펫은 MessageID를 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다.

// Get email with specific MessageId
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getMessageId().equals("MessageID");

전체 메일 배달 알림으로 메시지 필터링

다음 코드 스니펫은 모든 메일 전달 알림을 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다.

// Get Mail Delivery Notifications
builder = new ExchangeQueryBuilder();
builder.getContentClass().equals(ContentClassType.getMDN().toString());

크기로 메시지 필터링

builder = new ExchangeQueryBuilder();
builder.getItemSize().greater(80000);

문자열 값으로 메시지 필터링

다음 코드 스니펫은 헤더(제목, 보낸 사람, 받는 사람, 참조)에서 지정된 문자열을 기준으로 모든 이메일을 필터링하는 방법을 보여줍니다. getText() 메서드는 문자열 값과 함께 메시지 본문을 반환합니다.

 ExchangeQueryBuilder builder = new ExchangeQueryBuilder();

builder.getText().equals("SomeText");

MailQuery query = builder.getQuery();

ExchangeMessageInfoCollection messages = ewsClient.listMessages("InboxUri", query, false);

오름차순/내림차순으로 메시지 필터링

Aspose.Email은 다음을 제공합니다 ComparisonField.orderBy(boolean ascending) 클라이언트가 검색 필드에서 오름차순 또는 내림차순 정렬을 사용하는지 나타내는 값을 설정하는 메서드입니다. 이는 지정된 기준에 따라 이메일 메시지를 오름차순/내림차순으로 정렬할 수 있게 합니다. MailQueryBuilder.

아래 코드 조각은 메시지를 오름차순/내림차순으로 필터링하는 방법을 보여줍니다.

MailQueryBuilder builder = new MailQueryBuilder();
builder.getSubject().contains("Report");
builder.getInternalDate().since(sinceDate);
builder.getSubject().orderBy(true); // sort the subject ascending
builder.getInternalDate().orderBy(false); // sort the date descending  

ExchangeMessageInfoCollection miColl = client.listMessages(client.getMailboxInfo().getInboxUri(), builder.getQuery());

복잡한 쿼리 구축

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

AND로 쿼리 결합

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

// 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로 쿼리를 결합하는 방법을 보여줍니다.

builder.or(builder.getSubject().contains("test"), builder.getFrom().contains("noreply@host.com"));

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

다음 코드 조각에 표시된 대로 필터 기준에 IgnoreCase 플래그를 지정하여 대소문자 구분에 따라 이메일을 필터링할 수 있습니다.

// Query building by means of ExchangeQueryBuilder class
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getSubject().contains("Newsletter", true);
builder.getInternalDate().on(new Date());
MailQuery query = builder.getQuery();

페이지 지원이 있는 메시지 필터링

int itemsPerPage = 5;
String sGuid = UUID.randomUUID().toString();
String str1 = sGuid + " - " + "Query 1";
String str2 = sGuid + " - " + "Query 2";

MailQueryBuilder queryBuilder1 = new MailQueryBuilder();
queryBuilder1.getSubject().contains(str1);
MailQuery query1 = queryBuilder1.getQuery();
List<ExchangeMessagePageInfo> pages = new ArrayList<ExchangeMessagePageInfo>();
ExchangeMessagePageInfo pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), query1, itemsPerPage);
pages.add(pageInfo);
int str1Count = pageInfo.getItems().size();
while (!pageInfo.getLastPage()) {
    pageInfo = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), query1, itemsPerPage, pageInfo.getPageOffset() + 1);
    pages.add(pageInfo);
    str1Count += pageInfo.getItems().size();
}

Java: 대화 항목 관리

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

Aspose.Email for Java는 Exchange Server에서 대화 항목을 관리하는 데 사용할 수 있습니다. EWSClient 클래스. 이 클래스는 Exchange Web Services를 사용하며, 이는 Exchange Server 2007 이후 버전에서만 사용할 수 있습니다. 이 문서는 방법을 보여줍니다. find, copy, move 및 delete Exchange Server 2010의 대화 항목. 이 섹션에 포함된 모든 기능을 사용하려면 Microsoft Exchange Server 2010 Service Pack 1이 필요합니다.

대화 찾기

Exchange Server의 특정 폴더에서 대화 정보를 가져오려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
폴더에서 모든 대화 항목을 찾으려면 IEWSClient.findConversations() 메서드를 호출합니다.
ID, 대화 주제 및 플래그 상태와 같은 대화 항목 속성을 표시합니다.

다음 코드 조각은 대화를 찾는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find Conversation Items in the Inbox folder
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
// Show all conversations
for (ExchangeConversation conversation : conversations) {
    // Display conversation properties like Id and Topic
    System.out.println("Topic: " + conversation.getConversationTopic());
    System.out.println("Flag Status: " + conversation.getFlagStatus());
    System.out.println();
}

대화 복사

대화를 한 폴더에서 다른 폴더로 복사하려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
대화 항목을 원본 폴더에서 대상 폴더로 복사하려면 IEWSClient.copyConversationItems() 메서드를 호출합니다.

다음 코드 조각은 대화를 복사하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to copy
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Copy the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email")) {
        client.copyConversationItems(conversation.getConversationId(), client.getMailboxInfo().getDeletedItemsUri());
        System.out.println("Copied the conversation item to another folder");
    }
}

대화 이동

대화를 한 폴더에서 다른 폴더로 이동하려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
대화를 원본 폴더에서 대상 폴더로 이동하려면 IEWSClient.moveConversationItems() 메서드를 호출합니다.

다음 코드 조각은 대화를 이동하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to move
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());

for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Move the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email") == true) {
        client.moveConversationItems(conversation.getConversationId(), client.getMailboxInfo().getDeletedItemsUri());
        System.out.println("Moved the conversation item to another folder");
    }
}

대화 삭제

폴더에서 대화를 삭제하려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
원본 폴더에서 대화 항목을 삭제하려면 IEWSClient.deleteConversationItems() 메서드를 호출합니다.

다음 코드 조각은 대화를 삭제하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Find those Conversation Items in the Inbox folder which we want to delete
ExchangeConversation[] conversations = client.findConversations(client.getMailboxInfo().getInboxUri());
for (ExchangeConversation conversation : conversations) {
    System.out.println("Topic: " + conversation.getConversationTopic());
    // Delete the conversation item based on some condition
    if (conversation.getConversationTopic().contains("test email") == true) {
        client.deleteConversationItems(conversation.getConversationId());
        System.out.println("Deleted the conversation item");
    }
}

Java: Exchange Server에서 캘린더 항목 작업

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

회의 요청 보내기

이 문서는 Exchange Web Services와 Aspose.Email을 사용하여 여러 수신자에게 회의 요청을 보내는 방법을 보여줍니다.

Appointment 클래스를 사용하여 회의 요청을 만들고 위치, 시간 및 참석자를 설정합니다.
MailMessage 클래스를 인스턴스화하고 MailMessage.addAlternateView() 메서드를 사용하여 약속을 설정합니다.
Exchange Server에 연결하고 send(MailMessage) 메서드를 사용하여 회의 요청을 보냅니다.

다음은 EWSClient 클래스는 Exchange Web Services(EWS) 지원이 있는 Exchange Server에 연결하는 데 사용할 수 있습니다. 이를 위해 서버는 Exchange Server 2007 이상이어야 합니다. 다음 코드 스니펫은 EWS를 사용하여 회의 요청을 보내는 방법을 보여줍니다.

try {
    // Create instance of IEWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

    Calendar c = Calendar.getInstance();
    c.add(Calendar.HOUR_OF_DAY, 1);
    Date startTime = c.getTime();
    c.add(Calendar.MINUTE, 90);
    Date endTime = c.getTime();

    // Create the meeting request
    Appointment app = new Appointment("meeting request", startTime, endTime, MailAddress.to_MailAddress("administrator@test.com"),
            MailAddressCollection.to_MailAddressCollection("bob@test.com"));
    app.setSummary("meeting request summary");
    app.setDescription("description");

    c = Calendar.getInstance();
    c.add(Calendar.DATE, 5);
    RecurrencePattern pattern = new DailyRecurrencePattern(c.getTime());
    app.setRecurrence(pattern);

    // Create the message and set the meeting request
    MailMessage msg = new MailMessage();
    msg.setFrom(MailAddress.to_MailAddress("administrator@test.com"));
    msg.setTo(MailAddressCollection.to_MailAddressCollection("bob@test.com"));
    msg.isBodyHtml(true);
    msg.setHtmlBody("<h3>HTML Heading</h3><p>Email Message detail</p>");
    msg.setSubject("meeting request");
    msg.addAlternateView(app.requestApointment(0));

    // send the appointment
    client.send(msg);
    System.out.println("Appointment request sent");
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

EWS를 사용한 캘린더 항목 작업

Aspose.Email는 Exchange Web Service(EWS) 클라이언트를 사용하여 약속을 추가, 업데이트 및 취소할 수 있는 기능을 제공합니다. IEWSClients createAppointment, updateAppointment, 그리고 cancelAppointment 메서드를 사용하면 EWS로 캘린더 항목을 조작할 수 있습니다. 이 문서는 캘린더 항목 작업에 대한 자세한 코드 샘플을 제공합니다. 다음 코드 샘플은 방법을 보여줍니다:

약속 만들기.
약속을 업데이트합니다.
약속을 삭제/취소합니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "your.username", "your.Password");
Calendar c = Calendar.getInstance();
c.set(Calendar.MINUTE, 0);
c.set(Calendar.SECOND, 0);
c.set(Calendar.MILLISECOND, 0);
Date startTime = c.getTime();
c.add(Calendar.HOUR_OF_DAY, 1);
Date endTime = c.getTime();
String timeZone = "America/New_York";

Appointment app = new Appointment("Room 112", startTime, endTime, MailAddress.to_MailAddress("organizeraspose-email.test3@domain.com"),
        MailAddressCollection.to_MailAddressCollection("attendee@gmail.com"));
app.setTimeZone(timeZone);
app.setSummary("NETWORKNET-34136" + UUID.randomUUID().toString());
app.setDescription("NETWORKNET-34136 Exchange 2007/EWS: Provide support for Add/Update/Delete calendar items");

String uid = client.createAppointment(app);
Appointment fetchedAppointment1 = client.fetchAppointment(uid);
app.setLocation("Room 115");
app.setSummary("New summary for " + app.getSummary());
app.setDescription("New Description");
client.updateAppointment(app);

Appointment[] appointments1 = client.listAppointments();
System.out.println("Total Appointments: " + appointments1.length);
Appointment fetchedAppointment2 = client.fetchAppointment(uid);
System.out.println("Summary: " + fetchedAppointment2.getSummary());
System.out.println("Location: " + fetchedAppointment2.getLocation());
System.out.println("Description: " + fetchedAppointment2.getDescription());
client.cancelAppointment(app);
Appointment[] appointments2 = client.listAppointments();
System.out.println("Total Appointments: " + appointments2.length);

지정된 날짜 범위 내에서 반복 캘린더 항목 반환

Aspose.Email EWSClient는 시작일자와 종료일자 사이에 있는 반복 캘린더 항목의 반환을 지원합니다. AppointmentQueryBuilder.setCalendarView(Date startDate, Date endDate, int maxEntriesReturned) CalendarView가 지정된 경우, 해당 메서드는 시작일자와 종료일자 사이에 있는 단일 캘린더 항목 및 반복 캘린더 항목의 발생을 목록으로 반환합니다. maxEntriesReturned 매개변수는 반환될 최대 결과 수를 지정합니다. (값이 0 이하이면 모든 결과 반환).

ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getAppointment().setCalendarView(startDate, endDate, -1);

Appointment[] appointments = client.listAppointments(builder.getQuery());

페이지 지원으로 약속 목록 조회

ListAppointments 메서드 IEWSClient API는 Exchange 서버에서 전체 약속 목록을 검색합니다. 약속이 많을 경우 시간이 걸릴 수 있습니다. API는 다음과 같은 오버로드된 메서드를 제공합니다. listAppointments 작업에 페이지 지원을 제공하는 메서드입니다. 이는 쿼리 기능과 다양한 조합으로 사용할 수 있습니다. 다음과 같은 오버로드된 메서드들을 사용하여 Exchange Server에서 페이지 지원으로 약속을 나열할 수 있습니다.

AppointmentCollection IEWSClient.listAppointments(int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(String folderUri, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(String folderUri, MailQuery query, int itemsPerPage).
AppointmentCollection IEWSClient.listAppointments(int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(String folderUri, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(MailQuery query, int itemsPerPage, int itemOffset).
AppointmentCollection IEWSClient.listAppointments(String folderUri, MailQuery query, int itemsPerPage, int itemOffset).

다음 코드 스니펫은 페이지 지원을 사용하여 약속을 나열하는 방법을 보여줍니다.

        IEWSClient client = EWSClient.getEWSClient("exchange.domain.com", "username", "password");
        try {
            try {
                Appointment[] appts = client.listAppointments();
                System.out.println(appts.length);

                Calendar c = Calendar.getInstance();
                c.set(Calendar.MINUTE, 0);
                c.set(Calendar.SECOND, 0);
                c.set(Calendar.MILLISECOND, 0);

                int appNumber = 10;
                Map<String, Appointment> appointmentsDict = new HashMap<String, Appointment>();
                for (int i = 0; i < appNumber; i++) {
                    c.set(Calendar.HOUR_OF_DAY, i + 1);
                    Date startTime = c.getTime();
                    c.set(Calendar.HOUR_OF_DAY, i + 2);
                    Date endTime = c.getTime();

                    String timeZone = "America/New_York";
                    Appointment appointment = new Appointment("Room 112", startTime, endTime, MailAddress.to_MailAddress("from@domain.com"),
                            MailAddressCollection.to_MailAddressCollection("to@domain.com"));
                    appointment.setTimeZone(timeZone);
                    appointment.setSummary("NETWORKNET-35157_3 - " + UUID.randomUUID().toString());
                    appointment.setDescription("EMAILNET-35157 Move paging parameters to separate class");
                    String uid = client.createAppointment(appointment);
                    appointmentsDict.put(uid, appointment);
                }
                AppointmentCollection totalAppointmentCol = AppointmentCollection.to_AppointmentCollection(client.listAppointments());

                ///// LISTING APPOINTMENTS WITH PAGING SUPPORT ///////
                int itemsPerPage = 2;
                List<AppointmentPageInfo> pages = new ArrayList<AppointmentPageInfo>();
                AppointmentPageInfo pagedAppointmentCol = client.listAppointmentsByPage(itemsPerPage);
                System.out.println(pagedAppointmentCol.getItems().size());
                pages.add(pagedAppointmentCol);
                while (!pagedAppointmentCol.getLastPage()) {
                    pagedAppointmentCol = client.listAppointmentsByPage(itemsPerPage, pagedAppointmentCol.getPageOffset() + 1);
                    pages.add(pagedAppointmentCol);
                }
                int retrievedItems = 0;
                // foreach to while statements conversion
                for (AppointmentPageInfo folderCol : pages) {
                    retrievedItems += folderCol.getItems().size();
                }
            } finally {
            }
        } finally {
            client.dispose();
        }

Exchange Server의 보조 캘린더 폴더에 이벤트 추가

Aspose.Email API를 사용하면 Exchange Server에서 보조 캘린더 폴더를 만들 수 있습니다. IEWSClient. 그런 다음 보조 캘린더에서 약속을 추가, 업데이트 또는 취소할 수 있습니다. createAppointment, updateAppointment 및 cancelAppointment 메서드들. 아래 코드 샘플에서는 이 기능을 보여주기 위해 다음 API 메서드와 속성을 사용합니다. 이 기능은 Aspose.Email for Java 6.5.0 이상에서 지원됩니다.

메서드 IEWSClient.cancelAppointment(Appointment, String).
메서드 IEWSClient.cancelAppointment(String, String).
메서드 IEWSClient.createAppointment(Appointment, String).
메서드 IEWSClient.createFolder(String, String, ExchangeFolderPermissionCollection, String).
메서드 IEWSClient.fetchAppointment(String, String).
메서드 IEWSClient.updateAppointment(Appointment, String).
속성 IEWSClient.CurrentCalendarFolderUri.

다음 코드 스니펫은 Exchange 서버의 보조 캘린더 폴더에 이벤트를 추가하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "your.username", "your.Password");
try {
    try {
        // Create an appointmenta that will be added to secondary calendar folder

        Calendar c = Calendar.getInstance();
        c.set(Calendar.MINUTE, 0);
        c.set(Calendar.SECOND, 0);
        c.set(Calendar.MILLISECOND, 0);
        Date startTime = c.getTime();
        c.add(Calendar.HOUR_OF_DAY, 1);
        Date endTime = c.getTime();

        String timeZone = "America/New_York";

        Appointment[] listAppointments;
        Appointment appointment = new Appointment("Room 121", startTime, endTime, MailAddress.to_MailAddress("from@domain.com"),
                MailAddressCollection.to_MailAddressCollection("attendee@domain.com"));
        appointment.setTimeZone(timeZone);
        appointment.setSummary("EMAILNET-35198 - " + UUID.randomUUID().toString());
        appointment.setDescription("EMAILNET-35198 Ability to add event to Secondary Calendar of Office 365");

        // Verify that the new folder has been created
        ExchangeFolderInfoCollection calendarSubFolders = client.listSubFolders(client.getMailboxInfo().getCalendarUri());

        String getfolderName;
        String setFolderName = "New Calendar";
        boolean alreadyExits = false;

        // Verify that the new folder has been created already exits or not

        for (int i = 0; i < calendarSubFolders.size(); i++) {
            getfolderName = calendarSubFolders.get_Item(i).getDisplayName();

            if (getfolderName.equals(setFolderName)) {
                alreadyExits = true;
            }
        }

        if (alreadyExits) {
            System.out.println("Folder Already Exists");
        } else {
            // Create new calendar folder
            client.createFolder(client.getMailboxInfo().getCalendarUri(), setFolderName, null, "IPF.Appointment");

            System.out.println(calendarSubFolders.size());

            // Get the created folder URI
            String newCalendarFolderUri = calendarSubFolders.get_Item(0).getUri();

            // appointment api with calendar folder uri
            // Create
            client.createAppointment(appointment, newCalendarFolderUri);
            appointment.setLocation("Room 122");
            // update
            client.updateAppointment(appointment, newCalendarFolderUri);
            // list
            listAppointments = client.listAppointments(newCalendarFolderUri);

            // list default calendar folder
            listAppointments = client.listAppointments(client.getMailboxInfo().getCalendarUri());

            // Cancel
            client.cancelAppointment(appointment, newCalendarFolderUri);
            listAppointments = client.listAppointments(newCalendarFolderUri);

            // appointment api with context current calendar folder uri
            client.setCurrentCalendarFolderUri(newCalendarFolderUri);
            // Create
            client.createAppointment(appointment);
            appointment.setLocation("Room 122");
            // update
            client.updateAppointment(appointment);
            // list
            listAppointments = client.listAppointments();

            // list default calendar folder
            listAppointments = client.listAppointments(client.getMailboxInfo().getCalendarUri());

            // Cancel
            client.cancelAppointment(appointment);
            listAppointments = client.listAppointments();

        }
    } finally {
    }
} finally {
    client.dispose();
}

캘린더 초대 공유

Microsoft Exchange 서버는 동일한 서버에 등록된 다른 사용자에게 캘린더 초대를 보내 캘린더를 공유할 수 있는 기능을 제공합니다. Aspose.Email API는 EWS API를 사용하여 캘린더를 공유할 수 있는 동일한 기능을 제공합니다.

final IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
try {
    // delegate calendar access permission
    ExchangeDelegateUser delegateUser = new ExchangeDelegateUser("sharingfrom@domain.com", ExchangeDelegateFolderPermissionLevel.NotSpecified);
    delegateUser.getFolderPermissions().setCalendarFolderPermissionLevel(ExchangeDelegateFolderPermissionLevel.Reviewer);
    client.delegateAccess(delegateUser, "sharingfrom@domain.com");

    // Create invitation
    MapiMessage mapiMessage = client.createCalendarSharingInvitationMessage("sharingfrom@domain.com");
    MailConversionOptions options = new MailConversionOptions();
    options.setConvertAsTnef(true);
    MailMessage mail = mapiMessage.toMailMessage(options);
    client.send(mail);
} finally {
    client.dispose();
}

캘린더 항목에서 확장 속성 정보 검색

IEWSClient client = EWSClient.getEWSClient("https://exchange.office365.com/Exchange.asmx", "username", "password");

java.util.List<String> uriList = java.util.Arrays.asList(client.listItems(client.getMailboxInfo().getCalendarUri()));

// Define the Extended Attribute Property Descriptor for searching purpose
// In this case, we have a K1 Long named property for Calendar item
UUID uuid = UUID.fromString("00020329-0000-0000-C000-000000000046");
PropertyDescriptor propertyDescriptor = new PidNamePropertyDescriptor("K1", PropertyDataType.Integer32, uuid);

java.util.List<PropertyDescriptor> propertyDescriptors = java.util.Arrays.asList(new PropertyDescriptor[] { propertyDescriptor });
IGenericList<MapiCalendar> mapiCalendarList = client.fetchMapiCalendar(uriList, propertyDescriptors);

for (MapiCalendar cal : mapiCalendarList) {
    for (MapiNamedProperty namedProperty : (Iterable<MapiNamedProperty>) cal.getNamedProperties().getValues()) {
        System.out.println(namedProperty.getNameId() + " = " + namedProperty.getInt32());
    }
}

Java: Exchange Server에서 연락처 작업

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

Exchange Server 계정에는 이메일 메시지 외에도 다양한 항목이 포함되어 있습니다. 또한 가져오기, 이동, 보내기 및 이메일 메시지 삭제 Exchange Server에서 Aspose.Email을 사용하면 연락처 작업이 가능합니다. 이 문서는 Exchange Web Services를 사용하여 연락처 정보를 검색하는 방법을 설명합니다. 또한 연락처 폴더에서 연락처를 나열하거나 연락처 이름을 기준으로 연락처를 해결하는 방법을 보여줍니다.

EWS로 연락처 가져오기

Aspose.Email은 다음을 제공합니다 EWSClient Exchange Web Services를 사용하여 Microsoft Exchange Server에 연결하는 클래스입니다. 다음 코드 스니펫은 Exchange Web Services를 사용하여 모든 연락처를 읽는 방법을 보여줍니다. 다음 코드 스니펫은 EWS로 연락처를 가져오는 방법을 보여줍니다.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// List all the contacts
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
for (Contact contact : contacts) {
    MapiContact mapiContact = Contact.to_MapiContact(contact);
    // Display name and email address
    System.out.println("Name: " + mapiContact.getNameInfo().getDisplayName() + "+ Email Address: " + mapiContact.getElectronicAddresses().getEmail1());
}

연락처 이름으로 연락처 해결

다음 코드 스니펫은 EWS를 사용하여 연락처를 가져오는 방법을 보여줍니다.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// List all the contacts
Contact[] contacts = client.resolveContacts("Changed Name", ExchangeListContactsOptions.FetchPhoto);
for (Contact c : contacts) {
    MapiContact contact = Contact.to_MapiContact(c);
    // Display name and email address
    System.out.println("Name: " + contact.getNameInfo().getDisplayName() + "+ Email Address: " + contact.getElectronicAddresses().getEmail1());
}

연락처 노트 형식 결정

NotesFormat은 TextFormat 열거형에 정의된 연락처 노트 텍스트 형식 유형을 지정합니다.

ID로 연락처 가져오기

다음 코드 샘플과 같이 연락처 ID를 사용하여 서버에서 특정 연락처를 검색할 수 있습니다.

Contact fetchedContact = client.getContact(id);

연락처 추가

다음은 EWSClient 클래스 createContact() 이 메서드는 Exchange Server에 연락처 정보를 추가하는 데 사용할 수 있습니다. createContact() 메서드는 Contact 객체를 입력 매개변수로 사용합니다.

Exchange Server에 연락처를 추가하려면:

주소와 자격 증명을 사용하여 EWSClient를 초기화합니다.
원하는 속성으로 Contact 객체를 초기화합니다.
CreateContact 메서드를 호출하여 연락처를 Exchange Server에 추가합니다.

Aspose.Email은 다음을 제공합니다 EWSClient Exchange Web Services를 사용하여 Microsoft Exchange Server에 연결하는 클래스입니다. 다음 코드 스니펫은 Exchange Web Services를 사용하여 Exchange Server에 연락처를 추가하는 방법을 보여줍니다.

// Set mailboxURI, Username, password, domain information
String mailboxUri = "https://ex2010/ews/exchange.asmx";
String username = "test.exchange";
String password = "pwd";
String domain = "ex2010.local";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Create New Contact
Contact contact = new Contact();

// Set general info
contact.setGender(Gender.Male);
contact.setDisplayName("Frank Lin");
contact.setCompanyName("ABC Co.");
contact.setJobTitle("Executive Manager");
PhoneNumber tmp0 = new PhoneNumber();
tmp0.setNumber("123456789");
tmp0.setCategory(PhoneNumberCategory.getHome());

// Add Phone numbers
contact.getPhoneNumbers().add(tmp0);
AssociatedPerson tmp1 = new AssociatedPerson();
tmp1.setName("Catherine");
tmp1.setCategory(AssociatedPersonCategory.getSpouse());

// contact's associated persons
contact.getAssociatedPersons().add(tmp1);
AssociatedPerson tmp2 = new AssociatedPerson();
tmp2.setName("Bob");
tmp2.setCategory(AssociatedPersonCategory.getChild());
contact.getAssociatedPersons().add(tmp2);
AssociatedPerson tmp3 = new AssociatedPerson();
tmp3.setName("Merry");
tmp3.setCategory(AssociatedPersonCategory.getSister());
contact.getAssociatedPersons().add(tmp3);
Url tmp4 = new Url();
tmp4.setHref("www.blog.com");
tmp4.setCategory(UrlCategory.getBlog());

// URLs
contact.getUrls().add(tmp4);
Url tmp5 = new Url();
tmp5.setHref("www.homepage.com");
tmp5.setCategory(UrlCategory.getHomePage());
contact.getUrls().add(tmp5);
EmailAddress tmp6 = new EmailAddress();
tmp6.setAddress("Frank.Lin@Abc.com");
tmp6.setDisplayName("Frank Lin");
tmp6.setCategory(EmailAddressCategory.getEmail1());

// Set contact's Email address
contact.getEmailAddresses().add(tmp6);

try {
    client.createContact(contact);
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

연락처 업데이트

연락처 정보는 Microsoft Outlook을 사용하여 업데이트할 수 있습니다. Aspose.Email은 Exchange Web Service(EWS)를 사용하여 Exchange Server의 연락처 정보를 업데이트할 수도 있습니다. IEWSClient’s updateContact() 이 메서드는 Exchange Server에서 연락처 정보를 업데이트할 수 있습니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// List all the contacts and Loop through all contacts
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
Contact contact = contacts[0];
System.out.println("Name: " + contact.getDisplayName());
contact.setDisplayName("David Ch");
client.updateContact(contact);

연락처 삭제

다음은 EWSClient class는 다음을 제공합니다 deleteItem Exchange Server의 연락처 폴더에 액세스하고 연락처를 삭제합니다. 이 메서드는 연락처 ID를 입력 매개변수로 사용합니다.

Exchange Server에서 연락처를 삭제하려면:

주소와 자격 증명을 사용하여 ExchangeWebServiceClient를 초기화합니다.
ID를 사용하여 연락처를 삭제합니다.

다음 코드 스니펫은 Exchange Web Service를 사용하여 Exchange Server에서 연락처를 삭제하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

String strContactToDelete = "John Teddy";
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
for (Contact contact : contacts) {
    if (contact.getDisplayName().equals(strContactToDelete))
        client.deleteItem(contact.getId().getEWSId(), DeletionOptions.getDeletePermanently());

}
client.dispose();

Java: Exchange Server에서 배포 목록 작업

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

배포 목록 작업

Aspose.Email API는 Exchange 서버에서 배포 목록을 생성하고 읽을 수 있는 기능을 제공합니다. 배포 목록은 서버에서 생성될 수 있으며, 멤버는 이를 사용하여 추가될 수 있습니다. IEWSClient. 이 문서는 Exchange 서버에서 배포 목록을 작업하는 방법을 보여줍니다.

배포 목록 생성

다음 코드 조각은 배포 목록을 생성하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setDisplayName("test private list");
MailAddressCollection members = new MailAddressCollection();
members.add("address1@host.com");
members.add("address2@host.com");
members.add("address3@host.com");
client.createDistributionList(distributionList, members);

개인 배포 목록 가져오기

다음 코드 조각은 개인 배포 목록을 가져오는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
for (ExchangeDistributionList distributionList : distributionLists) {
    MailAddressCollection members = client.fetchDistributionList(distributionList);
    for (MailAddress member : (Iterable<MailAddress>) members) {
        System.out.println(member.getAddress());
    }
}

공개 배포 목록 확장

다음 코드 조각은 공개 배포 목록을 확장하는 방법을 보여줍니다.

MailAddressCollection members = client.expandDistributionList(new MailAddress("public.distribution.list@host.com"));
for (MailAddress member : (Iterable<MailAddress>) members) {
    System.out.println(member.getAddress());
}

멤버 추가

개인 배포 목록에 멤버 추가

다음 코드 조각은 개인 배포 목록에 멤버를 추가하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddressCollection newMembers = new MailAddressCollection();
newMembers.add("address4@host.com");
newMembers.add("address5@host.com");
client.addToDistributionList(distributionLists[0], newMembers);

목록 없이 멤버 추가

다음 코드 조각은 목록 없이 멤버를 추가하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
distributionList.setChangeKey("list's change key");
MailAddressCollection newMembers = new MailAddressCollection();
newMembers.add("address6@host.com");
client.addToDistributionList(distributionList, newMembers);

개인 배포 목록에 전송

다음 코드 조각은 개인 배포 목록에 메시지를 보내는 방법을 보여줍니다.

ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddress distributionListAddress = distributionLists[0].toMailAddress();
MailMessage message = new MailMessage(new MailAddress("from@host.com"), distributionListAddress);
message.setSubject("sendToPrivateDistributionList");
client.send(message);

멤버 삭제

개인 배포 목록에서 멤버 삭제

다음 코드 조각은 개인 배포 목록에서 멤버를 삭제하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
MailAddressCollection members = client.fetchDistributionList(distributionLists[0]);
MailAddressCollection membersToDelete = new MailAddressCollection();
membersToDelete.addMailAddress(members.get_Item(0));
membersToDelete.addMailAddress(members.get_Item(1));
client.deleteFromDistributionList(distributionLists[0], membersToDelete);

목록 없이 멤버 삭제

다음 코드 조각은 목록 없이 멤버를 삭제하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
distributionList.setChangeKey("list's change key");
MailAddressCollection membersToDelete = new MailAddressCollection();
MailAddress addressToDelete = new MailAddress("address", true);
// addressToDelete.Id.EWSId = "member's id";
membersToDelete.addMailAddress(addressToDelete);
client.addToDistributionList(distributionList, membersToDelete);

개인 배포 목록 삭제

다음 코드 조각은 개인 배포 목록을 삭제하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList[] distributionLists = client.listDistributionLists();
client.deleteDistributionList(distributionLists[0], true);

목록 없이 삭제

다음 코드 조각은 목록 없이 삭제하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
ExchangeDistributionList distributionList = new ExchangeDistributionList();
distributionList.setId("list's id");
client.deleteDistributionList(distributionList, true);

Java: Exchange Server에서 폴더 작업

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

서버에서 모든 폴더 나열

Aspose.Email API는 Exchange Server에 연결하고 모든 폴더 및 하위 폴더를 나열할 수 있는 기능을 제공합니다. 또한 각 폴더에서 하위 폴더를 재귀적으로 가져올 수 있습니다. Exchange Web Service(EWS)를 사용하여 Exchange 클라이언트에서 페이징을 사용해 폴더를 나열하는 기능도 제공합니다. 이 문서는 Exchange 서버에서 모든 하위 폴더를 검색하고 페이징으로 폴더를 검색하는 방법을 보여줍니다.

다음 코드 스니펫은 Exchange Server에서 폴더를 나열하는 방법을 보여줍니다.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static void run() {
    try {
        IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
        System.out.println("Downloading all messages from Inbox....");

        ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
        System.out.println("Mailbox URI: " + mailboxInfo.getMailboxUri());
        String rootUri = client.getMailboxInfo().getRootUri();
        // List all the folders from Exchange server
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(rootUri);
        for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            // Call the recursive method to read messages and get sub-folders
            listSubFolders(client, folderInfo);
        }

        System.out.println("All messages downloaded.");
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void listSubFolders(IEWSClient client, ExchangeFolderInfo folderInfo) {
    // Create the folder in disk (same name as on IMAP server)
    System.out.println(folderInfo.getDisplayName());
    try {
        // If this folder has sub-folders, call this method recursively to get messages
        ExchangeFolderInfoCollection folderInfoCollection = client.listSubFolders(folderInfo.getUri());
        for (ExchangeFolderInfo subfolderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCollection) {
            listSubFolders(client, subfolderInfo);
        }
    } catch (java.lang.RuntimeException e) {
    }
}

EWS를 사용한 폴더 유형 정보 가져오기

다음은 FolderType 에 의해 제공되는 속성 ExchangeFolderInfo 클래스를 사용하여 폴더 유형에 대한 정보를 가져올 수 있습니다. 아래 코드 샘플에 나와 있습니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeFolderInfoCollection folderInfoCol = client.listSubFolders(client.getMailboxInfo().getRootUri());
for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folderInfoCol) {
    switch (folderInfo.getFolderType()) {
    case ExchangeFolderType.Appointment:
        // handle Appointment
        break;
    case ExchangeFolderType.Contact:
        // handle Contact
        break;
    case ExchangeFolderType.Task:
        // handle Task
        break;
    case ExchangeFolderType.Note:
        // handle email message
        break;
    case ExchangeFolderType.StickyNote:
        // handle StickyNote
        break;
    case ExchangeFolderType.Journal:
        // handle Journal
        break;
    default:
        break;
    }
}

EWS를 사용한 페이징 지원 폴더 나열

다음 코드 조각은 EWS를 사용한 페이징 지원 사용 방법을 보여줍니다.

// Create instance of ExchangeWebServiceClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "UserName", "Password");

// Call ListMessages method to list messages info from Inbox
ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());
int itemsPerPage = 5;
List<PageInfo> pages = new ArrayList<PageInfo>();
PageInfo pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
pages.add(pagedMessageInfoCol);
while (!pagedMessageInfoCol.getLastPage()) {
    pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
    pages.add(pagedMessageInfoCol);
}
pagedMessageInfoCol = client.listMessagesByPage(client.getMailboxInfo().getInboxUri(), itemsPerPage);
while (!pagedMessageInfoCol.getLastPage()) {
    client.listMessages(client.getMailboxInfo().getInboxUri());
}

메일함 사용자 정의 폴더 또는 하위 폴더 접근

IEWSClient 개발자가 메일함에서 모든 사용자 정의 폴더 또는 하위 폴더에 액세스할 수 있도록 합니다. folderExists() 함수 IEWSClient 지정된 사용자 정의 폴더/하위 폴더의 URI를 반환하며, 이를 사용하여 대상 폴더에 액세스할 수 있습니다. 다음 예에서는 INBOX 아래에 생성된 "TestInbox"라는 사용자 정의 폴더에 액세스하고 해당 폴더의 모든 메시지를 표시합니다. 이 작업을 수행하려면 다음 단계가 필요합니다:

유효한 자격 증명을 제공하여 IEWSClient 객체를 초기화합니다.
기본 메일함에 액세스합니다.
예제에서는 상위 폴더인 INBOX에 액세스합니다. 이 상위 폴더는 자체적으로 사용자 정의 폴더가 될 수도 있습니다.
folderExists()를 사용하여 지정된 사용자 정의 하위 폴더를 검색합니다(예: "TestInbox"). 이는 "TestInbox"의 URI를 반환합니다.
이 URI를 사용하여 해당 사용자 정의 폴더의 모든 메시지에 액세스합니다.

다음 코드 조각은 EWS를 사용하여 메일함 사용자 정의 폴더 또는 하위 폴더에 액세스하는 방법을 보여줍니다.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create ExchangeMailboxInfo, ExchangeMessageInfoCollection instance
ExchangeMailboxInfo mailbox = client.getMailboxInfo();
ExchangeMessageInfoCollection messages = null;
ExchangeFolderInfo subfolderInfo = new ExchangeFolderInfo();

// Check if specified custom folder exisits and Get all the messages info from the target Uri
ExchangeFolderInfo[] referenceToSubfolderInfo = { subfolderInfo };
client.folderExists(mailbox.getInboxUri(), "TestInbox", /* out */ referenceToSubfolderInfo);
subfolderInfo = referenceToSubfolderInfo[0];

// if custom folder exists
if (subfolderInfo != null) {
    messages = client.listMessages(subfolderInfo.getUri());

    // Parse all the messages info collection
    for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) messages) {
        String strMessageURI = info.getUniqueUri();
        // now get the message details using FetchMessage()
        MailMessage msg = client.fetchMessage(strMessageURI);
        System.out.println("Subject: " + msg.getSubject());
    }
} else {
    System.out.println("No folder with this name found.");
}

공개 폴더 나열

Microsoft Exchange Server는 사용자가 공개 폴더를 만들고 그 안에 메시지를 게시하도록 허용합니다. 애플리케이션을 통해 이를 수행하려면 Aspose.Email을 사용하십시오. EWSClient Exchange Server에 연결하고 공개 폴더에서 메시지와 게시물을 읽고 다운로드하는 클래스입니다. 다음 코드 조각은 모든 공개 폴더와 하위 폴더를 읽고, 해당 폴더에서 찾은 모든 메시지를 나열하고 다운로드하는 방법을 보여줍니다. 이 예제는 EWS를 지원하는 Microsoft Exchange Server 2007 이상에서만 작동합니다.

public static void run() {
    try {
        readPublicFolders();
    } catch (java.lang.RuntimeException ex) {
        System.out.println(ex.getMessage());
    }
}

private static void readPublicFolders() {
    NetworkCredential credential = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

    ExchangeFolderInfoCollection folders = client.listPublicFolders();
    for (ExchangeFolderInfo publicFolder : (Iterable<ExchangeFolderInfo>) folders) {
        System.out.println("Name: " + publicFolder.getDisplayName());
        System.out.println("Subfolders count: " + publicFolder.getChildFolderCount());
        listMessagesFromSubFolder(publicFolder, client);

    }
}

private static void listMessagesFromSubFolder(ExchangeFolderInfo publicFolder, IEWSClient client) {
    System.out.println("Folder Name: " + publicFolder.getDisplayName());
    ExchangeMessageInfoCollection msgInfoCollection = client.listMessagesFromPublicFolder(publicFolder);
    for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) msgInfoCollection) {
        MailMessage msg = client.fetchMessage(messageInfo.getUniqueUri());
        System.out.println(msg.getSubject());
        msg.save(dataDir + msg.getSubject() + ".msg", SaveOptions.getDefaultMsgUnicode());
    }

    // Call this method recursively for any subfolders
    if (publicFolder.getChildFolderCount() > 0) {
        ExchangeFolderInfoCollection subfolders = client.listSubFolders(publicFolder);
        for (ExchangeFolderInfo subfolder : (Iterable<ExchangeFolderInfo>) subfolders) {
            listMessagesFromSubFolder(subfolder, client);
        }
    }
}

메시지를 다른 폴더로 복사

Aspose.Email API는 다음을 사용하여 메시지를 한 폴더에서 다른 폴더로 복사할 수 있습니다. copyItem 메서드. 이 메서드의 오버로드된 버전은 이 문서에 표시된 복사된 메시지의 고유 URI를 반환합니다.

try {
    // Create instance of EWSClient class by giving credentials
    IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
    MailMessage message = new MailMessage("from@domain.com", "to@domain.com", "EMAILNET-34997 - " + UUID.randomUUID().toString(),
            "EMAILNET-34997 Exchange: Copy a message and get reference to the new Copy item");
    String messageUri = client.appendMessage(message);
    String newMessageUri = client.copyItem(messageUri, client.getMailboxInfo().getDeletedItemsUri());
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

폴더 항목 동기화

Aspose.Email for Java API IEWSClient Exchange 폴더의 내용을 동기화하는 기능을 제공합니다. syncFolder 에 의해 노출된 메서드 IEWSClient 클래스를 사용하여 지정된 폴더에서 폴더 동기화 정보를 수행할 수 있습니다. 다음 코드 조각은 Exchange 폴더 정보를 동기화하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
MailMessage message1 = new MailMessage("user@domain.com", "user@domain.com", "EMAILNET-34738 - " + UUID.randomUUID().toString(), "EMAILNET-34738 Sync Folder Items");
client.send(message1);

MailMessage message2 = new MailMessage("user@domain.com", "user@domain.com", "EMAILNET-34738 - " + UUID.randomUUID().toString(), "EMAILNET-34738 Sync Folder Items");
client.send(message2);

ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
SyncFolderResult result = client.syncFolder(client.getMailboxInfo().getInboxUri(), null);
System.out.println(result.getNewItems().size());
System.out.println(result.getChangedItems().size());
System.out.println(result.getReadFlagChanged().size());
System.out.println(result.getDeletedItems().length);

Exchange 폴더의 권한 검색

사용자는 Exchange Server의 공개 폴더에 대한 권한이 할당되며, 이는 사용자가 해당 폴더에 액세스할 수 있는 수준을 제한/결정합니다. ExchangeFolderPermission 클래스는 다음과 같은 Exchange 폴더에 대한 일련의 권한 속성을 제공합니다. PermissionLevel, 그들이 할 수 있는지 여부 canCreateItems, deleteItems, 그리고 권한 속성에 지정된 다른 작업을 수행합니다. 권한은 다음을 사용하여 검색할 수 있습니다. getFolderPermissions() 메서드 IEWSClient. 이 문서에서는 공유 폴더에 액세스할 수 있는 모든 사용자를 위해 공개 폴더에 적용된 권한을 검색하는 방법을 보여줍니다.

이 작업을 수행하려면:

EWSClient를 초기화합니다.
listPublicFolders를 사용하여 모든 공개 폴더 목록을 가져옵니다.
getFolderPermissions() 메서드를 사용하여 폴더와 연결된 권한을 검색합니다.

다음 코드 스니펫은 사용 방법을 보여줍니다. EWSClient 폴더에 적용된 권한을 검색하는 클래스.

String folderName = "DesiredFolderName";

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

ExchangeFolderInfoCollection folders = client.listPublicFolders();
ExchangeFolderPermissionCollection permissions = new ExchangeFolderPermissionCollection();

ExchangeFolderInfo publicFolder = null;
try {
    for (ExchangeFolderInfo folderInfo : (Iterable<ExchangeFolderInfo>) folders)
        if (folderInfo.getDisplayName().equals(folderName))
            publicFolder = folderInfo;

    if (publicFolder == null)
        System.out.println("public folder was not created in the root public folder");

    ExchangePermissionCollection folderPermissionCol = client.getFolderPermissions(publicFolder.getUri());
    for (ExchangeBasePermission perm : (Iterable<ExchangeBasePermission>) folderPermissionCol) {
        if (perm instanceof ExchangeFolderPermission)
            System.out.println("Permission is null.");
        else {
            ExchangeFolderPermission permission = (ExchangeFolderPermission) perm;

            System.out.println("User's primary smtp address: " + permission.getUserInfo().getPrimarySmtpAddress());
            System.out.println("User can create Items: " + permission.canCreateItems());
            System.out.println("User can delete Items: " + permission.getDeleteItems());
            System.out.println("Is Folder Visible: " + permission.isFolderVisible());
            System.out.println("Is User owner of this folder: " + permission.isFolderOwner());
            System.out.println("User can read items: " + permission.getReadItems());
        }
    }
    ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
    // Get the Permissions for the Contacts and Calendar Folder
    ExchangePermissionCollection contactsPermissionCol = client.getFolderPermissions(mailboxInfo.getContactsUri());
    ExchangePermissionCollection calendarPermissionCol = client.getFolderPermissions(mailboxInfo.getCalendarUri());
} finally {
    // Do the needfull
}

폴더 및 하위 폴더 만들기

Aspose.Email API는 Exchange 메일함에 폴더를 생성하는 기능을 제공합니다. CreateFolder 메서드 IEWSClient 이 목적에 사용할 수 있습니다. Exchange 서버 메일함에 폴더를 생성하려면 다음 단계를 사용할 수 있습니다.

IEWSClient 인스턴스를 생성합니다.
UseSlashAsFolderSeparator 속성을 필요에 따라 설정하십시오. true로 설정하면 애플리케이션은 "슬래시"를 폴더 구분자로 간주하고 슬래시 뒤에 하위 폴더를 생성합니다.
createFolder 메서드를 사용하여 폴더를 생성합니다.

다음 코드 스니펫은 폴더와 하위 폴더를 생성하는 방법을 보여줍니다.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

String inbox = client.getMailboxInfo().getInboxUri();
String folderName1 = "EMAILNET-35054";
String subFolderName0 = "2015";
String folderName2 = folderName1 + "/" + subFolderName0;
String folderName3 = folderName1 + " / 2015";
ExchangeFolderInfo rootFolderInfo = null;
ExchangeFolderInfo folderInfo = null;

try {
    client.setUseSlashAsFolderSeparator(true);
    client.createFolder(client.getMailboxInfo().getInboxUri(), folderName1);
    client.createFolder(client.getMailboxInfo().getInboxUri(), folderName2);
} finally {
    ExchangeFolderInfo[] referenceToRootFolderInfo = { rootFolderInfo };
    boolean outRefCondition0 = client.folderExists(inbox, folderName1, /* out */ referenceToRootFolderInfo);
    rootFolderInfo = referenceToRootFolderInfo[0];
    if (outRefCondition0) {
        ExchangeFolderInfo[] referenceToFolderInfo = { folderInfo };
        boolean outRefCondition1 = client.folderExists(inbox, folderName2, /* out */ referenceToFolderInfo);
        folderInfo = referenceToFolderInfo[0];
        if (outRefCondition1)
            client.deleteFolder(folderInfo.getUri(), true);
        client.deleteFolder(rootFolderInfo.getUri(), true);
    }
}

Exchange 폴더를 PST로 백업

사용자는 종종 모든 메일함 폴더 또는 일부 폴더를 백업하고 싶어합니다. Aspose.Email은 모든 또는 지정된 Exchange 메일함 폴더를 PST로 백업할 수 있는 기능을 제공합니다. 이 문서는 샘플 코드를 통해 Exchange 폴더를 PST로 백업하는 방법을 설명합니다. Exchange 서버 폴더를 백업하려면 다음 단계를 따르세요.

사용자 자격 증명으로 IEWSClient를 초기화합니다
필요한 폴더 정보를 ExchangeFolderInfoCollection에 추가합니다
클라이언트의 백업 메서드를 사용하여 폴더 내용을 PST로 내보냅니다

다음 코드 스니펫은 Exchange 폴더를 PST로 백업하는 방법을 보여줍니다.

String dataDir = "data/";
// Create instance of IEWSClient class by providing credentials
final String mailboxUri = "https://ews.domain.com/ews/Exchange.asmx";
final String domain = "";
final String username = "username";
final String password = "password";
NetworkCredential credential = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

// Get Exchange mailbox info of other email account
ExchangeMailboxInfo mailboxInfo = client.getMailboxInfo();
ExchangeFolderInfo info = client.getFolderInfo(mailboxInfo.getInboxUri());
ExchangeFolderInfoCollection fc = new ExchangeFolderInfoCollection();
fc.addItem(info);
client.backup(fc, dataDir + "Backup_out.pst", BackupOptions.None);

Java: Exchange Server에서 규칙 작업

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

규칙 관리

Aspose.Email for Java는 다음을 사용하여 Exchange Server에서 규칙을 관리할 수 있습니다 EWSClient 클래스. 이 클래스는 Exchange Server 2007 및 이후 릴리스에서 사용할 수 있는 Exchange Web Services (EWS)를 사용합니다. 규칙 관리 방법을 보여주기 위해 이 문서는 다음을 설명합니다:

서버에 이미 존재하는 규칙을 읽습니다.
새 규칙 생성.
기존 규칙 업데이트.

이 문서에 설명된 모든 기능에는 Microsoft Exchange Server 2010 Service Pack 1이 필요합니다.

규칙 읽기

Exchange Server에서 모든 규칙을 가져오려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
모든 규칙을 가져오려면 IEWSClient.getInboxRules() 메서드를 호출하십시오.
foreach 루프에서 모든 규칙을 탐색하고 조건, 동작 및 이름과 같은 규칙 속성을 표시합니다.

다음 코드 스니펫은 규칙을 읽는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

// Get all Inbox Rules
InboxRule[] inboxRules = client.getInboxRules();

// Display information about each rule
for (InboxRule inboxRule : inboxRules) {
    System.out.println("Display Name: " + inboxRule.getDisplayName());

    // Check if there is a "From Address" condition
    if (inboxRule.getConditions().getFromAddresses().size() > 0) {
        for (MailAddress fromAddress : (Iterable<MailAddress>) inboxRule.getConditions().getFromAddresses()) {
            System.out.println("From: " + fromAddress.getDisplayName() + " - " + fromAddress.getAddress());
        }
    }
    // Check if there is a "Subject Contains" condition
    if (inboxRule.getConditions().containsSubjectStrings().size() > 0) {
        // foreach to while statements conversion
        for (String subject : inboxRule.getConditions().containsSubjectStrings()) {
            System.out.println("Subject contains: " + subject);
        }
    }
    // Check if there is a "Move to Folder" action
    if (inboxRule.getActions().getMoveToFolder().length() > 0) {
        System.out.println("Move message to folder: " + inboxRule.getActions().getMoveToFolder());
    }
}

새 규칙 생성

Exchange Server에 새 규칙을 생성하려면 다음 단계를 수행하십시오:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
InboxRule 클래스의 새 인스턴스를 생성하고 다음 필수 속성을 설정하십시오:
1. 표시 이름
2. 조건
3. 동작
규칙을 생성하려면 IEWSClient.createInboxRule() 메서드를 호출하십시오.

다음 코드 스니펫은 새 규칙을 생성하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

InboxRule rule = new InboxRule();
rule.setDisplayName("Message from client ABC");

// Add conditions
RulePredicates newRules = new RulePredicates();
// Set Subject contains string "ABC" and Add the conditions
newRules.containsSubjectStrings().addItem("ABC");
newRules.getFromAddresses().addMailAddress(new MailAddress("administrator@ex2010.local", true));
rule.setConditions(newRules);

// Add Actions and Move the message to a folder
RuleActions newActions = new RuleActions();
newActions.setMoveToFolder("120:AAMkADFjMjNjMmNjLWE3NzgtNGIzNC05OGIyLTAwNTgzNjRhN2EzNgAuAAAAAABbwP+Tkhs0TKx1GMf0D/cPAQD2lptUqri0QqRtJVHwOKJDAAACL5KNAAA=AQAAAA==");
rule.setActions(newActions);
client.createInboxRule(rule);

규칙 업데이트

Exchange Server에서 규칙을 업데이트하려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
모든 규칙을 가져오려면 IEWSClient.getInboxRules() 메서드를 호출하십시오.
foreach 루프에서 모든 규칙을 탐색하고 조건에서 DisplayName을 일치시켜 변경하려는 규칙을 가져옵니다.
규칙 속성 업데이트
규칙을 업데이트하려면 IEWSClient.updateInboxRule() 메서드를 호출하십시오.

다음 코드 스니펫은 규칙을 업데이트하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxURI, credential);

System.out.println("Connected to Exchange server");

// Get all Inbox Rules
InboxRule[] inboxRules = client.getInboxRules();

// Loop through each rule
for (InboxRule inboxRule : inboxRules) {
    System.out.println("Display Name: " + inboxRule.getDisplayName());
    if ("Message from client ABC".equals(inboxRule.getDisplayName())) {
        System.out.println("Updating the rule....");
        inboxRule.getConditions().getFromAddresses().set_Item(0, new MailAddress("administrator@ex2010.local", true));
        client.updateInboxRule(inboxRule);
    }
}

Java: Exchange Server에서 작업 다루기

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

작업 다루기

Aspose.Email는 Exchange에서 작업을 처리하는 것을 지원합니다. ExchangeTask 클래스. 다양한 속성이 노출됩니다. ExchangeTask, 같은 Subject, 상태, 마감일, 그리고 우선순위, Exchange에서 작업을 구성하는 데 사용할 수 있습니다. EWSClient 클래스는 다음과 같은 기능을 제공합니다: createTask, updateTask, 그리고 deleteTask Exchange에서 작업을 처리하는 데 사용됩니다. 이 문서에서는 다음과 같은 방법을 보여줍니다:

새 작업을 생성합니다.
작업의 시간대를 설정합니다.
작업을 업데이트합니다.
작업을 삭제합니다.
작업 요청 보내기
작업을 디스크에 저장

새 작업 만들기

다음 코드 스니펫은 새로운 작업을 만드는 방법을 보여줍니다.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Create Exchange task object
ExchangeTask task = new ExchangeTask();

// Set task subject and status to In progress
task.setSubject("New-Test");
task.setStatus(ExchangeTaskStatus.InProgress);
client.createTask(client.getMailboxInfo().getTasksUri(), task);

시간대 지정

다음은 IEWSClient 인터페이스 및 ExchangeTask 작업을 생성할 때 시간대 정보를 설정하기 위해 TimeZoneId 속성을 제공합니다. 다음 코드 스니펫은 시간대를 지정하는 방법을 보여줍니다.

client.setTimezoneId("Central Europe Standard Time");

작업 업데이트

다음 코드 스니펫은 Exchange 서버에서 작업을 업데이트하는 방법을 보여줍니다.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Update the task status to NotStarted
    task.setStatus(ExchangeTaskStatus.NotStarted);

    // Set the task due date
    SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
    task.setDueDate(sdf.parse("26/02/2013 00:00:00"));

    // Set task priority
    task.setPriority(MailPriority.Low.getValue());

    // Update task on exchange
    client.updateTask(task);
}

작업 삭제

다음 코드 스니펫은 Exchange 서버에서 작업을 삭제하는 방법을 보여줍니다.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Get all tasks info collection from exchange
ExchangeMessageInfoCollection tasks = client.listMessages(client.getMailboxInfo().getTasksUri());

// Parse all the tasks info in the list
for (ExchangeMessageInfo info : (Iterable<ExchangeMessageInfo>) tasks) {
    // Fetch task from exchange using current task info
    ExchangeTask task = client.fetchTask(info.getUniqueUri());

    // Check if the current task fulfills the search criteria
    if (task.getSubject().equals("test")) {
        // Delete task from exchange
        client.deleteItem(task.getUniqueUri(), DeletionOptions.getDeletePermanently());
    }
}

작업 요청 전송

Aspose.Email Exchange 서비스는 Outlook과 유사하게 작업 요청을 보낼 수 있는 기능을 제공합니다. 다음 코드 스니펫은 디스크에서 작업 요청 메시지를 로드하고 이를 사용하여 보내는 방법을 보여줍니다. IEWSClient.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

MsgLoadOptions options = new MsgLoadOptions();
options.setPreserveTnefAttachments(true);

// load task from .msg file
MailMessage eml = MailMessage.load(dataDir + "task.msg", options);
eml.setFrom(MailAddress.to_MailAddress("firstname.lastname@domain.com"));
eml.getTo().clear();
eml.getTo().addMailAddress(new MailAddress("firstname.lastname@domain.com"));
client.send(eml);

작업을 디스크에 저장

Aspose.Email은 Exchange 작업을 Outlook MSG 형식으로 디스크에 저장할 수도 있습니다. 다음 코드 스니펫은 작업을 디스크에 저장하는 방법을 보여줍니다.

ExchangeTask task = new ExchangeTask();
task.setSubject("TASK-ID - " + UUID.randomUUID());
task.setStatus(ExchangeTaskStatus.InProgress);

Calendar cal = Calendar.getInstance();
task.setStartDate(cal.getTime());
cal.add(Calendar.DATE, 3);
task.setDueDate(cal.getTime());
task.save(dstEmail);

Exchange Server에서 작업 목록 조회

IEWSClient 제공합니다 listTasks Exchange Web Service에서 작업을 가져오는 데 사용할 수 있는 메서드입니다. 특정 폴더에서 작업 목록을 가져오거나 검색 기준을 사용하여 가져오는 여러 오버로드가 있습니다. 아래 코드 샘플은 Tasks 폴더에서 모든 작업 또는 특정 작업을 가져오는 예시를 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Listing Tasks from Server
client.setTimezoneId("Central Europe Standard Time");
TaskCollection taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri());

// print retrieved tasks' details
int iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

// Listing Tasks from server based on Query - Completed and In-Progress
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };
ExchangeQueryBuilder queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
MailQuery query = queryBuilder.getQuery();

taskCollection = client.listTasks(client.getMailboxInfo().getTasksUri(), query);

// print retrieved tasks' details
iTasksCount = taskCollection.size();
for (int i = 0; i < iTasksCount; i++) {
    ExchangeTask task = (ExchangeTask) taskCollection.get_Item(i);
    System.out.println(task.getSubject());
    System.out.println(task.getStartDate());
    System.out.println(task.getDueDate());
}

Exchange Server에서 작업 필터링

Aspose.Email은 서버에서 모든 작업을 가져오는 대신 특정 작업만 검색할 수 있는 기능을 제공합니다. API를 사용하면 Completed, Deferred, In Progress, Not started, Waiting on others와 같은 작업 상태별로 작업을 검색할 수 있습니다. ExchangeQueryBuilder 클래스는 Status 속성을 사용하여 원하는 기준을 지정할 수 있습니다. 또한 Exchange Server에서 원하는 작업을 검색하기 위해 여러 조건을 지정할 수 있습니다. 다음 코드 샘플이 이를 보여줍니다.

// Create instance of ExchangeClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// Set timezone for tasks
client.setTimezoneId("Central Europe Standard Time");

// We use these status values for specifying in queries
Integer[] values = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.Deferred, ExchangeTaskStatus.InProgress, ExchangeTaskStatus.NotStarted,
        ExchangeTaskStatus.WaitingOnOthers };

messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri());

// Now retrieve the tasks with specific statuses
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().equals(status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
    fetchedTask = client.fetchTask(messageInfoCol.get_Item(0).getUniqueUri());
}

// retrieve all other than specified
for (int status : values) {
    queryBuilder = new ExchangeQueryBuilder();
    queryBuilder.getTaskStatus().notEquals((int) status);
    query = queryBuilder.getQuery();
    messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);
}

// specifying multiple criterion
Integer[] selectedStatuses = new Integer[] { ExchangeTaskStatus.Completed, ExchangeTaskStatus.InProgress };

queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().in(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

// list all those which are not in our specified statuses
queryBuilder = new ExchangeQueryBuilder();
queryBuilder.getTaskStatus().notIn(Arrays.asList(selectedStatuses));
query = queryBuilder.getQuery();
messageInfoCol = client.listMessages(client.getMailboxInfo().getTasksUri(), query);

Java: 서버에서 사용자 구성 작업

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

사용자 구성 관리

Aspose.Email for Java는 Exchange Server에서 사용자 구성을 관리하는 데 사용할 수 있습니다. EWSClient 클래스. 이 클래스는 Exchange Server 2007 이후 버전에서만 사용할 수 있는 Exchange Web Services를 사용합니다. 이 문서에서는 Exchange Server 2010에서 사용자 구성을 읽고, 만들고, 업데이트하고, 삭제하는 방법을 살펴봅니다. 이 문서에 설명된 모든 기능을 사용하려면 Microsoft Exchange Server 2010 Service Pack 1이 필요합니다. 다음 코드 조각은 이 문서의 모든 예제에서 Exchange Server 2010에 연결하는 방법을 보여줍니다.

private static IEWSClient getExchangeEWSClient() {
    final String mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
    final String domain = "";
    final String username = "username@ASE305.onmicrosoft.com";
    final String password = "password";
    NetworkCredential credentials = new NetworkCredential(username, password, domain);
    IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
    return client;
}

사용자 구성 읽기

Exchange Server에서 특정 폴더의 사용자 구성 정보를 가져오려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
폴더에 대한 사용자 구성을 가져오려면 IEWSClient.getUserConfiguration() 메서드를 호출합니다.
ID, 이름 및 사전 항목을 키-값 쌍으로 표시하는 등 사용자 구성 속성을 표시합니다.

다음 코드 조각은 사용자 구성을 읽는 방법을 보여줍니다.

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Get the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);

System.out.println("Configuration Id: " + userConfig.getId());
System.out.println("Configuration Name: " + userConfig.getUserConfigurationName().getName());
System.out.println("Key value pairs:");
// foreach to while statements conversion
for (Object key : userConfig.getDictionary().keySet()) {
    System.out.println(key + ": " + userConfig.getDictionary().get(key).toString());
}

사용자 구성 생성

Exchange Server의 특정 폴더에 대한 사용자 구성을 생성하려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
폴더에 대한 사용자 구성을 생성하려면 IEWSClient.createUserConfiguration() 메서드를 호출합니다.

다음 코드 조각은 사용자 구성을 생성하는 방법을 보여줍니다.

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = new UserConfiguration(userConfigName);
userConfig.getDictionary().put("key1", "value1");
userConfig.getDictionary().put("key2", "value2");
userConfig.getDictionary().put("key3", "value3");
client.createUserConfiguration(userConfig);

사용자 구성 업데이트

Exchange Server에서 특정 폴더에 대한 사용자 구성을 업데이트하려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
폴더에 대한 사용자 구성을 업데이트하려면 IEWSClient.updateUserConfiguration() 메서드를 호출합니다.

다음 코드 조각은 사용자 구성을 업데이트하는 방법을 보여줍니다.

IEWSClient client = getExchangeEWSClient();
System.out.println("Connected to Exchange 2010");

// Create the User Configuration for Inbox folder
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
UserConfiguration userConfig = client.getUserConfiguration(userConfigName);
userConfig.setId(null);

// Update User Configuration
userConfig.getDictionary().put("key1", "new-value1");
client.updateUserConfiguration(userConfig);

사용자 구성 삭제

Exchange Server에서 특정 폴더에 대한 사용자 구성을 삭제하려면:

IEWSClient 클래스를 사용하여 Exchange Server에 연결합니다.
폴더에 대한 사용자 구성을 삭제하려면 IEWSClient.deleteUserConfiguration() 메서드를 호출합니다.

다음 코드 조각은 사용자 구성을 삭제하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);
System.out.println("Connected to Exchange 2010");

// Delete User Configuration
UserConfigurationName userConfigName = new UserConfigurationName("inbox.config", client.getMailboxInfo().getInboxUri());
client.deleteUserConfiguration(userConfigName);

Java: 유틸리티 기능

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

투표 옵션이 있는 메시지 전송

Microsoft Outlook은 새 메시지를 작성할 때 설문 조사를 만들 수 있게 합니다. 이는 Yes, No, Maybe 등과 같은 투표 옵션을 포함시켜 수행됩니다. Aspose.Email이 제공하는 FollowUpOptions 클래스는 투표 옵션 값을 설정하거나 가져올 수 있는 VotingButtons 속성을 제공합니다. 이 문서는 설문 조사를 만들기 위해 투표 옵션이 포함된 MapiMessage를 생성하고, 이를 Exchange Web Service (EWS) 클라이언트를 사용하여 전송하는 자세한 예제를 제공합니다.

투표 옵션이 포함된 메시지 생성 및 전송

다음 코드 조각은 새 메시지를 생성하고 투표 옵션과 함께 전송하는 방법을 보여줍니다.

String address = "firstname.lastname@aspose.com";

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
MailMessage message = createTestMessage(address);

// Set FollowUpOptions Buttons
FollowUpOptions options = new FollowUpOptions();
options.setVotingButtons("Yes;No;Maybe;Exactly!");

client.send(message, options);

예제에 사용된 샘플 메서드

다음 코드 조각은 위 예제에서 사용된 메서드들을 사용하는 방법을 보여줍니다.

private static MailMessage createTestMessage(String address) {
    MailMessage eml = new MailMessage(address, address, "Flagged message",
            "Make it nice and short, but descriptive. The description may appear in search engines' search results pages...");

    return eml;
}

MSG 파일에서 RE 및 FW 메시지 생성

IEWSClient 개발자가 원본 메시지에서 RE(Reply/Reply All) 및 FW(Forward) 메시지를 생성하도록 합니다. 원본 메시지는 특정 ExchangeMessageInfo 출처 ExchangeMessageInfoCollection IEWSClient.listMessages()에 의해 얻어집니다. 다른 인수는 실제 MailMessage RE 또는 FW 메시지로 전송됩니다. 다음 코드 조각은 샘플 계정을 생성하여 메시지를 전송하고, 그 샘플 메시지에 대해 회신 및 전달 기능을 시연하는 방법을 보여줍니다. 이 작업을 수행하려면:

유효한 자격 증명을 제공하여 IEWSClient 객체를 초기화합니다.
몇 개의 샘플 메시지를 전송합니다.
IEWSClient.reply(), IEWSClient.replyAll() 및 IEWSClient.forward() 함수를 호출하여 메시지를 전송합니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);

try {
    MailMessage message = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");

    client.send(message);

    ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
    if (messageInfoCol.size() == 1)
        System.out.println("1 message in Inbox");
    else
        System.out.println("Error! No message in Inbox");

    MailMessage message1 = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");

    client.send(message1);
    messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());

    if (messageInfoCol.size() == 2)
        System.out.println("2 messages in Inbox");
    else
        System.out.println("Error! No new message in Inbox");

    MailMessage message2 = new MailMessage("user@domain.com", "user@domain.com", "TestMailRefw - " + UUID.randomUUID().toString(),
            "TestMailRefw Implement ability to create RE and FW messages from source MSG file");
    message2.getAttachments().addItem(Attachment.createAttachmentFromString("Test attachment 1", "Attachment Name 1"));
    message2.getAttachments().addItem(Attachment.createAttachmentFromString("Test attachment 2", "Attachment Name 2"));

    // Reply, Replay All and forward Message
    client.reply(message2, messageInfoCol.get_Item(0));
    client.replyAll(message2, messageInfoCol.get_Item(0));
    client.forward(message2, messageInfoCol.get_Item(0));
} catch (java.lang.RuntimeException ex) {
    System.out.println("Error in program" + ex.getMessage());
}

Office 365용 EWS OAuth 지원

Aspose.Email API는 Office 365와 함께 Exchange Web Service (EWS)를 지원합니다. API의 EWSClient 인터페이스는 다음을 제공하는 오버로드 메서드를 제공합니다. OAuthNetworkCredential OAuth를 통해 Exchange 계정에 액세스하기 위한 입력으로 사용됩니다. 사용자는 이 기능을 사용하려면 Authority, Client Id, Client App Uri 및 Resource 매개변수를 제공해야 합니다. 다음 코드 조각은 Office 365와 함께 사용하는 EWS에 대한 OAuth 지원을 보여줍니다.

// token provider
/*ITokenProvider provider = new ITokenProvider() {

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        return null;
    }
};

NetworkCredential credentials = new OAuthNetworkCredential(provider);*/

// accessToken
NetworkCredential credentials = new OAuthNetworkCredential("accessToken");

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", credentials);
client.listMessages();

Exchange 클라이언트 로깅 지원

Aspose.Email API는 Exchange Web Service 클라이언트에 대한 로깅 기능을 제공합니다.

EWS 클라이언트 로깅

client.setLogFileName("logs/ews");
// OR
EWSClient.setCommonLogFileName("logs/ews");

EWS 요청에 헤더 추가

Aspose.Email API를 사용하면 Exchange 요청에 헤더를 추가할 수 있습니다. 이는 다양한 목적에 사용되는 헤더를 EWS 요청에 추가하는 데 활용될 수 있습니다. 예를 들어 Exchange 서버의 제한 문제를 관리하는 데 사용되는 X-AnchorMailbox 헤더를 추가할 수 있습니다. 아래 코드 조각과 같이 IEWSClient의 addHeader 메서드를 사용하여 EWS 요청에 헤더를 추가합니다.

final IEWSClient client = EWSClient.getEWSClient("exchange.domain.com/ews/Exchange.asmx", "username", "password", "");
try {
    client.addHeader("X-AnchorMailbox", "username@domain.com");
    ExchangeMessageInfoCollection messageInfoCol = client.listMessages(client.getMailboxInfo().getInboxUri());
} finally {
    client.dispose();
}

헤더에 클라이언트 요청 ID 반환

다음은 return-client-request-id 헤더가 요청에 전송되고 서버가 여부를 판단하는 데 사용됩니다. client-request-id 클라이언트가 지정한 헤더는 서버 응답에 반환되어야 합니다. 이 작업에 사용되는 메서드는 다음과 같습니다:

getReturnClientRequestId()
setReturnClientRequestId(boolean 값) - 클라이언트가 서버 측에서 요청 ID를 반환하도록 요구하는지 여부를 나타내는 플래그를 가져오거나 설정합니다.

try (IEWSClient client = createEWSClient())
{
    // Client will create random id and pass it to the server.
    // The server should include this id in request-id header of all responses.
    client.setReturnClientRequestId(true);
    
    client.setLogFileName("ews.log");
    client.getMailboxInfo();
}

통합 메시징 작업

Aspose.Email는 Exchange Server 2010에서 통합 메시징 정보를 검색할 수 있습니다. 현재 지원되는 통합 메시징에는 구성 정보 가져오기, 외부 호출 시작, 호출 ID로 전화 통화 정보 검색 및 ID로 전화 끊기가 포함됩니다. 다음 코드 샘플은 Microsoft Exchange Server 2010에서 통합 메시징 구성 정보를 검색하는 방법을 보여줍니다.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credential);
UnifiedMessagingConfiguration umConf = client.getUMConfiguration();

메일 팁 받기

Microsoft Exchange Server는 Exchange Server 2010 및 2013에서 여러 새로운 기능을 추가했습니다. 그 중 하나는 사용자가 이메일을 작성할 때 메일 팁을 제공하는 기능입니다. 이 팁은 이메일이 전송되기 전에 정보를 제공하므로 매우 유용합니다. 예를 들어 수신자 목록에 잘못된 이메일 주소가 있으면 팁이 표시되어 주소가 유효하지 않음을 알려줍니다. 메일 팁을 통해 이메일을 보내기 전에 부재 중 자동 회신을 확인할 수 있습니다: 수신자 중 하나 이상이 부재 중 회신을 설정한 경우 Exchange Server(2010 & 2013)는 이메일 작성 중에 메일 팁을 보냅니다. 이 문서에 시연된 모든 기능을 사용하려면 Microsoft Exchange Server 2010 Service Pack 1이 필요합니다. 다음 코드 조각은 이를 사용하는 방법을 보여줍니다. EWSClient Microsoft Exchange Server 2007 이후 버전에서 사용할 수 있는 Exchange Web Services를 사용하는 클래스.

// Create instance of EWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
System.out.println("Connected to Exchange server...");
// Provide mail tips options
MailAddressCollection addrColl = new MailAddressCollection();
addrColl.addMailAddress(new MailAddress("test.exchange@ex2010.local", true));
addrColl.addMailAddress(new MailAddress("invalid.recipient@ex2010.local", true));
GetMailTipsOptions options = new GetMailTipsOptions(MailAddress.to_MailAddress("administrator@ex2010.local"), addrColl, MailTipsType.All);

// Get Mail Tips
MailTips[] tips = client.getMailTips(options);

// Display information about each Mail Tip
for (MailTips tip : tips) {
    // Display Out of office message, if present
    if (tip.getOutOfOffice() != null) {
        System.out.println("Out of office: " + tip.getOutOfOffice().getReplyBody().getMessage());
    }

    // Display the invalid email address in recipient, if present
    if (tip.getInvalidRecipient() == true) {
        System.out.println("The recipient address is invalid: " + tip.getRecipientAddress());
    }
}

Exchange 인페르소네이션

Exchange 인페르소네이션은 사용자가 다른 계정을 가장하여 해당 계정의 권한으로 작업을 수행하도록 허용합니다. 위임이 다른 사용자를 대신해 행동하게 하는 반면, 인페르소네이션은 다른 사용자인 것처럼 행동하게 합니다. Aspose.Email는 Exchange 인페르소네이션을 지원합니다. EWSClient 이 클래스는 ImpersonateUser 및 ResetImpersonation 메서드를 제공하여 이 기능을 지원합니다.

이 작업을 수행하려면:

사용자 1에 대한 ExchangeWebServiceClient를 초기화합니다.
사용자 2에 대한 ExchangeWebServiceClient를 초기화합니다.
계정에 테스트 메시지를 추가합니다.
Impersonation 활성화.
Impersonation 재설정.

다음 코드 스니펫은 사용 방법을 보여줍니다. EWSClient Impersonation 기능을 구현하기 위한 클래스.

// Create instance's of EWSClient class by giving credentials
IEWSClient client1 = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser1", "pwd", "domain");
IEWSClient client2 = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser2", "pwd", "domain");
{
    String folder = "Drafts";
    try {
        for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client1.listMessages(folder))
            client1.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        String subj1 = "NETWORKNET_33354 User User1";
        client1.appendMessage(folder, new MailMessage("User1@exchange.conholdate.local", "To@aspsoe.com", subj1, ""));

        for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client2.listMessages(folder))
            client2.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        String subj2 = "NETWORKNET_33354 User User2";
        client2.appendMessage(folder, new MailMessage("User2@exchange.conholdate.local", "To@aspose.com", subj2, ""));

        ExchangeMessageInfoCollection messInfoColl = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl.Count);
        // Assert.AreEqual(subj1, messInfoColl[0].Subject);

        client1.impersonateUser(ItemChoice.PrimarySmtpAddress, "User2@exchange.conholdate.local");
        ExchangeMessageInfoCollection messInfoColl1 = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl1.Count);
        // Assert.AreEqual(subj2, messInfoColl1[0].Subject);

        client1.resetImpersonation();
        ExchangeMessageInfoCollection messInfoColl2 = client1.listMessages(folder);
        // Assert.AreEqual(1, messInfoColl2.Count);
        // Assert.AreEqual(subj1, messInfoColl2[0].Subject);
    } finally {
        try {
            for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client1.listMessages(folder))
                client1.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
            for (ExchangeMessageInfo messageInfo : (Iterable<ExchangeMessageInfo>) client2.listMessages(folder))
                client2.deleteItem(messageInfo.getUniqueUri(), DeletionOptions.getDeletePermanently());
        } catch (java.lang.RuntimeException e) {
        }
    }
}

EWS를 이용한 자동 검색 기능

Aspose.Email API를 사용하면 EWS 클라이언트를 통해 Exchange 서버 설정을 검색할 수 있습니다.

AutodiscoverService svc = new AutodiscoverService();
svc.setCredentials(new NetworkCredential(email, password));

IGenericDictionary</* UserSettingName */Integer, Object> userSettings = svc.getUserSettings(email, UserSettingName.ExternalEwsUrl).getSettings();
String ewsUrl = (String) userSettings.get_Item(UserSettingName.ExternalEwsUrl);
System.out.println("Auto discovered EWS Url: " + ewsUrl);

Exchange 서버에서 PST 복원 중단 작업

Aspose.Email API를 사용하면 PST 파일을 Exchange 서버로 복원할 수 있습니다. 그러나 PST 파일이 크게 인해 작업이 오래 걸리는 경우 작업을 중단하기 위한 기준을 지정해야 할 수 있습니다. 이는 아래 예제 코드와 같이 API를 사용하여 구현할 수 있습니다.

final IEWSClient client = EWSClient.getEWSClient("https://exchange.office365.com/ews/exchange.asmx", "username", "password");
try {
    final long startTime = System.currentTimeMillis();
    final AtomicInteger processedItems = new AtomicInteger(0);
    final long S15 = 15 * 1000;

    BeforeItemCallback callback = new BeforeItemCallback() {
        public void invoke(ItemCallbackArgs item) {
            if (System.currentTimeMillis() - startTime > S15) {
                throw new AbortRestoreException();
            }

            processedItems.incrementAndGet();
        }
    };

    try {
        // create a test pst and add some test messages to it
        PersonalStorage pst = PersonalStorage.create(new ByteArrayOutputStream(), FileFormatVersion.Unicode);
        FolderInfo folder = pst.getRootFolder().addSubFolder("My test folder");
        for (int i = 0; i < 20; i++) {
            MapiMessage message = new MapiMessage("from@gmail.com", "to@gmail.com", "subj", "body");
            folder.addMessage(message);
        }
        RestoreSettings rs = new RestoreSettings();
        rs.setBeforeItemCallback(callback);

        // now restore the PST with callback
        client.restore(pst, rs);
        System.out.println("Success!");
    } catch (AbortRestoreException e) {
        System.out.println("Timeout! " + processedItems.get());
    }
} finally {
    client.dispose();
}

Java: Exchange Server에서 약속 필터링

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

EWS를 사용한 약속 필터링

다음은 IEWSClient Exchange 서버에서 약속을 필터링하는 기능을 제공합니다 ExchangeQueryBuilder. 약속은 다음을 기준으로 필터링할 수 있습니다:

날짜
반복

날짜별 약속 필터링

IEWSClient client = EWSClient.getEWSClient(mailboxUri, username, password, domain);

SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy HH:mm:ss");
Date startTime = sdf.parse("15/09/2017 00:00:00");
Date endTime = sdf.parse("10/10/2017 00:00:00");
ExchangeQueryBuilder builder = new ExchangeQueryBuilder();
builder.getAppointment().getStart().since(startTime);
builder.getAppointment().getEnd().beforeOrEqual(endTime);
MailQuery query = builder.getQuery();
Appointment[] appointments = client.listAppointments(query);

반복 이벤트로 약속 필터링

builder = new ExchangeQueryBuilder();
builder.getAppointment().isRecurring().equals(false);
query = builder.getQuery();
appointments = client.listAppointments(query);

Java: Exchange 항목의 확장 속성 작업

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

Aspose.Email API를 사용하면 API의 EWS 클라이언트를 통해 메시지의 확장 속성을 생성, 검색 및 업데이트할 수 있습니다. 다음 코드 샘플은 확장 속성을 생성하고 서버의 메시지에 추가한 다음 메시지를 다음과 같이 검색하는 예를 보여줍니다. MapiMessage 클라이언트의 fetchItem.

// Define a PidTagBodyContentId extended property
PropertyDescriptor extendedProperty = KnownPropertyList.BODY_CONTENT_ID;

// Create a message and set an extended property value
MapiMessage msg = new MapiMessage("from@from.com", "to@to.com",
        "Test message", "This is a test message");
msg.setProperty(extendedProperty, "03454432-6230-4e4b-887f-a498ea223599");

// Append message
String uri = ewsClient.appendMessage(ewsClient.getMailboxInfo().getInboxUri(), msg, true);

// Fetch appended item. Pass the extended property descriptor as method parameter.
MapiMessage fetchedMsg = ewsClient.fetchItem(uri, Arrays.asList(new PropertyDescriptor[] { extendedProperty }));

// Print the extended property value
System.out.println(fetchedMsg.getProperties().get_Item(extendedProperty).getString());

Java: 인플레이스 아카이브 작업

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

Office 365의 인플레이스 아카이브

Office 365의 인플레이스 아카이브는 사용자에게 추가 저장 공간을 제공합니다. 아카이브 사서함이 활성화되면 사용자는 Microsoft Outlook 및 Outlook on the Web을 사용하여 아카이브 사서함에 접근하고 메시지를 저장할 수 있습니다. 인플레이스 아카이브가 활성화된 사서함을 Outlook에서 열면 아카이브 사서함이 별도의 사서함으로 표시됩니다.

인플레이스 아카이브로 항목 이동

Aspose.Email API는 사용자의 아카이브 사서함으로 항목을 이동하는 데 사용할 수 있습니다. IEWSClient.archiveItem 메서드. IEWSClient.archiveItem 이 메서드는 아래에 나열된 네 가지 오버로드를 제공합니다.

archiveItem(String sourceFolderUri, Appointment appointment)
archiveItem(String sourceFolderUri, ExchangeTask task)
archiveItem(String sourceFolderUri, MapiMessageItemBase item)]
archiveItem(String sourceFolderUri, String uniqueId)

아래 코드 예제는 사용을 보여줍니다. IEWSClient.archiveItem UniqueUri를 사용하여 이메일을 아카이브 사서함으로 이동하는 메서드.

NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

ExchangeMessageInfoCollection msgCollection = client.listMessages(client.getMailboxInfo().getInboxUri());

for (ExchangeMessageInfo msgInfo : (Iterable<ExchangeMessageInfo>) msgCollection) {
    System.out.println("Subject:" + msgInfo.getSubject());
    client.archiveItem(client.getMailboxInfo().getInboxUri(), msgInfo.getUniqueUri());
}
client.dispose();

Java: 공유 사서함에서 메시지 가져오기

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

Aspose.Email는 공유 사서함에서 메시지에 접근하는 것을 지원합니다. 이를 위해 기본 사서함에 연결합니다. EWSClient 클래스. 공유 사서함에서 메시지에 접근하려면, 공유 사서함을 문자열 매개변수로 전달합니다. listMessages 또는 listItems 메서드.

다음 코드 샘플은 공유 사서함에서 메시지에 접근하는 방법을 보여줍니다. listItems 메서드.

final String mailboxUri = "<HOST>";
final String domain = "";
final String username = "<EMAIL ADDRESS>";
final String password = "<PASSWORD>";
final String sharedEmail = "<SHARED EMAIL ADDRESS>";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

String[] items = client.listItems(sharedEmail, "Inbox");

for (String item : items) {
    MapiMessage msg = client.fetchItem(item);
    System.out.println("Subject:" + msg.getSubject());
}
client.dispose();

Java: TLS 1.2 및 AutodiscoverService 지원

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

Aspose.Email for Java는 이제 SAAJ API를 사용하여 TLS 1.2를 지원합니다. EWSClient 정적 속성을 제공합니다 useSAAJAPI TLS 1.2 사용을 위해 true로 설정할 수 있습니다. Aspose.Email for Java는 또한 지원합니다 AutodiscoverService TLS 1.2용. 다음 코드 샘플은 SAAJ API 및 AutodiscoverService TLS 1.2용.

SAAJ API 사용

SAAJAPI 모드와 함께 사용되는 Java EE SOAP 클라이언트 - https://docs.oracle.com/cd/E19651-01/817-2151-10/wsgjaxm.html.

다음 코드 샘플은 SAAJ API를 설정하여 사용하는 방법을 보여줍니다. EWSClient.useSAAJAPI 속성을 true로 설정합니다.

다음 코드 스니펫에서 Basic 인증 헤더가 할당됩니다:

EWSClient.useSAAJAPI(true);
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testuser", "pw", "domain");
client.listMessages();

다음 코드 스니펫에서 OAUTH2 인증 헤더가 할당됩니다:

EWSClient.useSAAJAPI(true);
// token provider
/*ITokenProvider provider = new ITokenProvider() {

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        return null;
    }
};

NetworkCredential credentials = new OAuthNetworkCredential(provider);*/

// accessToken
NetworkCredential credentials = new OAuthNetworkCredential("accessToken");

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", credentials);
client.listMessages();

주의: 이 모드에서는 API가 NTLM 인증 프로세스를 제어하지 않습니다. NTLM 인증을 위해 Java Authenticator가 필요합니다.

Java 8용 NTLM 인증 코드 스니펫:

import java.net.Authenticator;
import java.net.PasswordAuthentication;
import java.net.URL;

static Authenticator getAuthenticator(String user, String pw, String domain) {
    final String username = domain + "\\" + user;
    final String password = pw;
    System.out.println("New Credentials " + username);
    return new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            System.out.println("Authenticate " + username);
            return new PasswordAuthentication(username, password.toCharArray());
        }
    };
}

EWSClient.useSAAJAPI(true);
System.setProperty("http.auth.preference", "NTLM");
Authenticator.setDefault(getAuthenticator("user", "pw", ""));
IEWSClient client = EWSClient.getEWSClient(new URL("https://domain.com/ews/Exchange.asmx"));

static Authenticator getAuthenticator() {

    // This block is written for suppressing a bug in sun implementation.
    // In Sun Impl client doesn't authenticate user for each connection,
    // uses cached credentials instead.
    sun.net.www.protocol.http.AuthCacheValue.setAuthCache(new sun.net.www.protocol.http.AuthCache() {
        public void remove(String pkey, sun.net.www.protocol.http.AuthCacheValue entry) {
        }
        public void put(String pkey, sun.net.www.protocol.http.AuthCacheValue value) {
        }
        public sun.net.www.protocol.http.AuthCacheValue get(String pkey, String skey) {
            return null;
        }
    });

    return new Authenticator() {
        protected PasswordAuthentication getPasswordAuthentication() {
            return getEmbeddedCredentials(getRequestingURL());
        }

        PasswordAuthentication getEmbeddedCredentials(URL url) {
            if (url == null) {
                return null;
            }
            String userInfo = url.getUserInfo();
            int colon = userInfo == null ? -1 : userInfo.indexOf(":");
            if (colon == -1) {
                return null;
            } else {
                String userName = userInfo.substring(0, colon);
                String pass;
                try {
                    pass = URLDecoder.decode(userInfo.substring(colon + 1), "UTF-8");
                } catch (UnsupportedEncodingException e) {
                    pass = "";
                }
                System.out.println("Authenticate " + userInfo);
                return new PasswordAuthentication("\\" + userName, pass.toCharArray());
            }
        }
    };
}

static URL getURL(String url, String user, String pw, String domain) throws Exception {
    String host = new URL(url).getHost();
    URL endpoint = new URL(url.replace(host, user + ":" + URLEncoder.encode(pw, "UTF-8") + "@" + host));

    return endpoint;
}

EWSClient.useSAAJAPI(true);
Authenticator.setDefault(getAuthenticator());

System.setProperty("http.auth.preference", "NTLM");
IEWSClient client1 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user1", "pw", "domain"));
IEWSClient client2 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user2", "pw", "domain"));

Java 9부터 Authenticator를 연결에 설정할 수 있습니다:

static Map<String, Authenticator> authInfo = new HashMap<String, Authenticator>();
static URL getURL(String url, final String user, final String pw, final String domain) throws MalformedURLException {
    URL endpoint = new URL(new URL(url), "", new URLStreamHandler() {
        protected URLConnection openConnection(URL url) throws IOException {
            URL target = new URL(url.toString());
            HttpURLConnection connection = (HttpURLConnection) target.openConnection();
            // Cache for User@Url
            Authenticator auth = authInfo.get(user + "@" + url);
            if (auth == null) {
                auth = new Authenticator() {
                    protected PasswordAuthentication getPasswordAuthentication() {
                        System.out.println("Authenticate " + user);
                        return new PasswordAuthentication(domain + "\\" + user, pw.toCharArray());
                    }
                };
                authInfo.put(user + "@" + url, auth);
            }
            connection.setAuthenticator(auth);

            return connection;
        }
    });

    return endpoint;
}

EWSClient.useSAAJAPI(true);
System.setProperty("http.auth.preference", "NTLM");
IEWSClient client1 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user1", "pw", "domain"));
IEWSClient client2 = EWSClient.getEWSClient(getURL("https://domain.com/ews/Exchange.asmx", "user2", "pw", "domain"));

참고: JAXB API는 Java EE API로 간주되며, 따라서 Java SE 9에서는 기본 클래스 경로에 포함되지 않습니다.

Maven JAXB 의존성:

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
</dependency>
<dependency>
    <groupId>com.sun.xml.messaging.saaj</groupId>
    <artifactId>saaj-impl</artifactId>
</dependency>

AutodiscoverService 사용

다음 코드 샘플은 사용 방법을 보여줍니다. AutodiscoverService TLS 1.2용

AutodiscoverService service = new AutodiscoverService();
service.setCredentials(new NetworkCredential("user", "password"));
GetUserSettingsResponse response = service.getUserSettings("userSmtpAddress", UserSettingName.ExternalEwsUrl, UserSettingName.UserDisplayName);