Documentation – Microsoft Graph 클라이언트 사용

Java: Aspose.Email for Java에서 Microsoft Graph 사용하기

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

Aspose.Email for Java는 Microsoft Graph와의 신뢰할 수 있는 통합을 제공하여 개발자가 메시지, 폴더, 연락처, 캘린더 및 작업과 같은 사서함 데이터를 액세스하고 관리할 수 있게 합니다. 다음을 사용하여 IGraphClient API를 사용하면 Java 애플리케이션에서 직접 Microsoft 365 계정에 인증하고, 쿼리하고, 작업을 수행할 수 있습니다.

다음 섹션에서는 Aspose.Email for Java에서 Microsoft Graph와 작업하는 다양한 측면을 다룹니다:

Microsoft Graph 인증

Microsoft Graph에서 OData 쿼리 사용

Microsoft Graph 연락처 관리

Microsoft Graph 캘린더 관리

Microsoft Graph 작업 관리

각 페이지에는 자세한 설명, 사용 가능한 API 메서드 및 코드 예제가 포함됩니다.

Java: Azure AD 설정 및 Microsoft Graph 인증 - Aspose.Email for Java

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

Aspose.Email for Java는 Microsoft Graph와 완전하게 통합되어 개발자가 Microsoft 365 계정의 메일, 연락처, 캘린더 및 작업을 관리할 수 있게 합니다. 이 가이드는 Azure AD 애플리케이션 생성 및 인증 구성 과정을 안내하여 Aspose.Email으로 코딩을 시작하도록 돕습니다. GraphClient.

Aspose.Email와 Microsoft Graph API를 사용하기 전에 Azure Active Directory(Azure AD)에 애플리케이션을 등록하고 인증을 구성해야 합니다. 이 페이지에서는 다음을 다룹니다:

Azure AD 애플리케이션(프로젝트) 만들기.
필요한 Microsoft Graph 권한 할당.
자격 증명 생성 (클라이언트 ID, 클라이언트 시크릿, 테넌트 ID).
Aspose.Email 토큰 공급자를 사용하여 Java에서 인증하기.

완료되면 Java 애플리케이션에서 Microsoft Graph와 상호 작용할 준비가 됩니다.

1. Azure AD 애플리케이션 만들기

Azure 포털에서 애플리케이션을 등록하려면 다음 단계를 따르십시오:

다음에 로그인하십시오 Azure 포털.
Azure Active Directory → App Registrations → New Registration 로 이동하십시오.

애플리케이션에 Name을 입력하십시오 (예: AsposeEmailGraphApp).
지원되는 계정 유형을 선택하십시오:
- 단일 테넌트 (귀사만 사용할 경우)
- 멀티테넌트 (여러 조직이 액세스 필요 시)
선택적으로 Redirect URI를 설정하십시오 (대화형 또는 웹 인증에 필요).
Register를 클릭하십시오.

2. 클라이언트 시크릿 생성

등록 후 Certificates & Secrets → New Client Secret 로 이동하십시오.
설명 및 만료 기간을 추가하십시오.

생성된 시크릿 값을 복사하십시오 - 다시는 볼 수 없습니다.

client secret을 안전하게 보관하십시오; 보안 클라이언트 인증에 필요합니다.

새로 등록된 애플리케이션 블레이드가 표시됩니다.

3. Microsoft Graph 권한 구성

API Permissions → Add a Permission → Microsoft Graph 로 이동하십시오.
시나리오에 따라 Delegated 또는 Application 권한 유형을 선택하십시오.
Aspose.Email 작업에 필요한 권한을 추가하십시오:
- Contacts.ReadWrite – 연락처를 관리하기 위해
- Calendars.ReadWrite – 캘린더를 관리하기 위해
- Mail.ReadWrite – 메일을 읽고 보낼 수 있도록
- Tasks.ReadWrite – 작업을 관리하기 위해
필요한 경우 Grant Admin Consent를 클릭하십시오.

4. 퍼블릭 클라이언트 흐름 허용

앱이 퍼블릭 클라이언트인지 지정하십시오. 리디렉션 URI를 사용하지 않는 토큰 부여 흐름을 사용하는 앱에 적합합니다.

5. Microsoft Graph 인증

Aspose.Email에서 지원되는 인증 방법

보안 클라이언트 사용 인증

다음 사용 AzureConfidentialTokenProvider 클라이언트 ID, 클라이언트 시크릿 및 테넌트 ID가 있을 때 인증하려면:

AzureConfidentialTokenProvider provider = new AzureConfidentialTokenProvider(
    tenantId,
    clientId,
    clientSecret
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

이렇게 하면 Microsoft Graph와 상호 작용할 준비가 된 완전 인증된 IGraphClient가 설정됩니다.

ROPC(사용자 이름 및 비밀번호) 인증

사용자 이름과 비밀번호가 있는 경우, 다음을 사용하십시오 AzureROPCConfiguration:

AzureROPCConfiguration ropcConfig = new AzureROPCConfiguration(
    tenantId,
    clientId,
    clientSecret,
    username,
    password
);

IGraphClient client = GraphClient.getClient(ropcConfig, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

Microsoft Graph용 사용자 지정 토큰 공급자

Aspose.Email for Java는 다음을 통해 Microsoft Graph와 통합됩니다. IGraphClient 인터페이스. 요청을 인증하려면, 다음 구현이 필요합니다. ITokenProvider 가 필요합니다. 대부분의 개발자는 기본 인증 제공자를 사용하지만, 예를 들어 Resource Owner Password Credentials (ROPC) 흐름을 사용할 때와 같이 자체 공급자를 만들고 싶을 수 있는 상황이 있습니다.

1. AzureROPCTokenProvider를 사용하여 ITokenProvider 구현

이 클래스는 다음에 대한 구현을 제공합니다. ITokenProvider Azure Resource Owner Password Credentials (ROPC) 흐름을 사용합니다. 다음 예제는 데모 용도이며, 실제 운영에서는 클라이언트 자격 증명이나 PKCE가 포함된 인증 코드와 같은 보다 안전한 흐름을 사용할 것을 권장합니다.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = getToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> getToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

2. ITokenProvider 객체 생성

다음은 IGraphClient 인터페이스는 요청을 구성하고 Microsoft Graph에 전송하며 응답을 처리하는 책임이 있습니다. 인스턴스를 만들려면 IGraphClient, 구현을 제공해야 합니다 ITokenProvider. 토큰 공급자는 유효한 OAuth 액세스 토큰을 제공하여 요청을 인증합니다.

다음 코드 샘플은 기본 인라인 구현을 만드는 방법을 보여줍니다. ITokenProvider 인터페이스이며, Microsoft Graph 요청 인증에 필요합니다:

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
        // Clean up resources if necessary
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Retrieve an OAuth access token.
        // If ignoreExistingToken is true, always request a new token.
        // Otherwise, return the existing token if it is valid, or request a new one.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Return a valid OAuth token.
        // If no valid token exists, request a new one.
        return new OAuthToken("token", expirationDate);
    }
};

3. 사용자 지정 토큰 공급자 사용

일단 ITokenProvider 설정이 완료되면, 다음을 생성할 수 있습니다. GraphClient 인스턴스. 이 클라이언트는 Microsoft Graph 호출 시 제공된 토큰 공급자를 사용하여 인증합니다.

ITokenProvider provider = new AzureROPCTokenProvider(
        tenantId,
        clientId,
        clientSecret,
        userName,
        password,
        new String[] {"https://graph.microsoft.com/.default"}
);

IGraphClient client = GraphClient.getClient(provider, tenantId);
client.setResource(ResourceType.Users);
client.setResourceId(userName);
client.setEndpoint("https://graph.microsoft.com");

// Now you can call Microsoft Graph APIs
var folders = client.listFolders(null);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

클라이언트를 생성하고 인증한 후에는 Microsoft Graph 서비스에 요청을 시작할 수 있습니다.

Java: Microsoft Graph 유틸리티 기능

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

Azure Active Directory 관리 센터에서 프로젝트 생성

MS Office 계정을 가진 사용자를 위해 Azure Active Directory 관리 센터에서 프로젝트를 생성합니다.

Azure Active Directory 관리 센터에서 프로젝트 만들기 단계

다음은 Azure Active Directory 관리 센터에서 프로젝트를 만드는 단계별 튜토리얼입니다.

1. Azure Active Directory로 이동하여 MS Office 자격 증명으로 로그인하십시오.

Azure Active Directory 링크 - https://aad.portal.azure.com/

2. 테넌트에 Azure AD 애플리케이션 만들기.

왼쪽 패널에서 Azure Active Directory 레이블을 클릭하십시오. 그러면 Azure Active Directory 블레이드가 열립니다. 해당 화면에서 App registrations 레이블을 볼 수 있습니다. 이것이 Azure AD 애플리케이션을 등록하는 시작점이며, 이 블레이드에서 Azure AD용 새 애플리케이션을 만들 수 있습니다.

New registration 버튼을 클릭하여 새 애플리케이션을 생성하십시오.

3. 이제 새로운 애플리케이션 등록 블레이드가 표시됩니다.

Name 애플리케이션 이름이 됩니다.
Supported account types 이 섹션은 액세스를 제한합니다.

Register 버튼을 클릭하십시오.

4. 새로 등록된 애플리케이션 블레이드가 표시됩니다.

Application (client) ID 애플리케이션 ID.
Directory (tenant) ID Azure AD 테넌트 ID.

5. Microsoft Graph API 권한 허용.

API permissions 레이블을 클릭하십시오.

Azure는 이미 애플리케이션에 User.Read 위임 권한을 부여했습니다. 이 권한을 통해 로그인한 사용자의 정보를 읽을 수 있습니다. 이는 Microsoft Graph API 권한이며, 다른 말로 Scopes라고 부를 수 있습니다.

Microsoft Graph API의 전체 범위 목록 - https://docs.microsoft.com/en-us/graph/permissions-reference.

+ Add a permission 버튼을 클릭하고 Microsoft Graph를 선택하십시오.

Delegated permissions를 클릭하십시오. 이제 Microsoft Graph API에서 사용할 수 있는 권한 목록이 표시됩니다.

필요한 권한을 선택하고 Add permissions 버튼을 클릭하십시오.

Grant admin consent 버튼을 클릭하십시오.

6. 퍼블릭 클라이언트 흐름 허용.

애플리케이션이 퍼블릭 클라이언트인지 지정합니다. 리디렉션 URI를 사용하지 않는 토큰 부여 흐름을 사용하는 앱에 적합합니다.

7. 애플리케이션용 키 생성

도우미 클래스

다음 보조 클래스들이 이 섹션의 코드를 실행하는 데 필요합니다. 이 클래스들은 데모를 단순화하기 위해 제공됩니다.

AzureROPCTokenProvider 클래스

다음의 인스턴스: IGraphClient 클래스는 요청을 구성하고 Microsoft Graph API에 전송하며 응답을 처리합니다. 이 클래스의 새 인스턴스를 만들려면 다음 인스턴스를 제공해야 합니다. ITokenProvider, Microsoft Graph에 대한 요청을 인증할 수 있습니다.

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.io.UnsupportedEncodingException;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

/**
 * <p>
 * Azure resource owner password credential (ROPC) token provider
 * https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
 * https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-authenticate-an-ews-application-by-using-oauth
 * https://portal.azure.com
 * https://developer.microsoft.com/en-us/graph/graph-explorer/#
 * token parser https://jwt.io
 * </p>
 */
class AzureROPCTokenProvider implements ITokenProvider {

    private static final String GRANT_TYPE = "password";

    private final String clientId;
    private final String clientSecret;
    private final String userName;
    private final String password;
    private final String tenant;
    private final String scope;

    private OAuthToken token;

    public AzureROPCTokenProvider(String tenant, String clientId, String clientSecret,
                                  String userName, String password, String[] scopeAr) {
        this.tenant = tenant;
        this.clientId = clientId;
        this.clientSecret = clientSecret;
        this.userName = userName;
        this.password = password;
        this.scope = joinToStr(scopeAr, " ");
    }

    public synchronized OAuthToken getAccessToken(boolean ignoreExistingToken) {
        if (this.token != null && !this.token.getExpired() && !ignoreExistingToken)
            return this.token;
        token = null;

        Map<String, String> tokenArgs = geToken();

        java.util.Calendar c = java.util.Calendar.getInstance();
        c.add(java.util.Calendar.SECOND, Integer.parseInt(tokenArgs.get("expires_in")));
        token = new OAuthToken(tokenArgs.get("access_token"), TokenType.AccessToken, c.getTime());
        return token;
    }

    public final OAuthToken getAccessToken() {
        return getAccessToken(false);
    }

    public void dispose() {
    }

    private String getEncodedParameters() {
        return "client_id=" + urlEncode(clientId) + "&scope=" + urlEncode(scope) + "&username=" + urlEncode(userName)
                + "&password=" + urlEncode(password) + "&grant_type="
                + urlEncode(GRANT_TYPE);
    }

    private String getUri() {
        if (tenant == null || tenant.trim().isEmpty())
            return "https://login.microsoftonline.com/common/oauth2/v2.0/token";
        else
            return "https://login.microsoftonline.com/" + tenant + "/oauth2/v2.0/token";
    }

    private Map<String, String> geToken() {
        try {
            HttpURLConnection connection = (HttpURLConnection) new URL(getUri()).openConnection();
            connection.setRequestMethod("POST");

            byte[] requestData = getEncodedParameters().getBytes(StandardCharsets.UTF_8);

            connection.setUseCaches(false);
            connection.setDoInput(true);
            connection.setDoOutput(true);
            connection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            connection.setRequestProperty("Content-Length", "" + requestData.length);

            final OutputStream st = connection.getOutputStream();
            try {
                st.write(requestData, 0, requestData.length);
            } finally {
                st.flush();
                st.close();
            }

            connection.connect();

            if (connection.getResponseCode() >= HttpURLConnection.HTTP_BAD_REQUEST) {
                throw new IllegalAccessError("Operation failed: " + connection.getResponseCode() + "/" +
                        connection.getResponseMessage() + "\r\nDetails:\r\n{2}"
                        + readInputStream(connection.getErrorStream()));
            }

            String responseText = readInputStream(connection.getInputStream());

            Map<String, String> result = new HashMap<>();
            String[] fromJsonToKeyValue = responseText.replace("{", "").replace("}", "")
                    .replace("\"", "").replace("\r", "")
                    .replace("\n", "").split(",");
            for (String keyValue : fromJsonToKeyValue) {
                String[] pair = keyValue.split(":");
                String name = pair[0].trim().toLowerCase();
                String value = urlDecode(pair[1].trim());
                result.put(name, value);
            }

            return result;
        } catch (IOException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlEncode(String value) {
        try {
            return URLEncoder.encode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String urlDecode(String value) {
        try {
            return URLDecoder.decode(value, StandardCharsets.UTF_8.toString());
        } catch (UnsupportedEncodingException e) {
            throw new IllegalAccessError(e.getMessage());
        }
    }

    static String readInputStream(InputStream is) {
        if (is == null)
            return "";

        BufferedReader reader = new BufferedReader(new InputStreamReader(is));
        StringBuilder result = new StringBuilder();
        String line;
        try {
            while ((line = reader.readLine()) != null) {
                result.append(line);
            }
        } catch (IOException e) {
            // ignore
        }
        return result.toString();
    }

    static String joinToStr(String[] arr, String sep) {
        StringBuilder sb = new StringBuilder();
        for (int i = 0; i < arr.length; i++) {
            if (i > 0)
                sb.append(sep);
            sb.append(arr[i]);
        }
        return sb.toString();
    }
}

Java: Aspose.Email for Java로 Microsoft Graph에서 연락처 관리

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

참조 Azure AD 설정 및 Microsoft Graph 인증 Microsoft Graph와 애플리케이션을 통합하는 방법을 배우는 기사.

Aspose.Email for Java는 Microsoft Graph를 통해 연락처 관리를 지원합니다. 연락처 폴더에서 직접 연락처를 나열하고, 검색하고, 생성하며, 업데이트할 수 있습니다.

아래 코드 샘플은 라이브러리의 다음 메서드를 사용하여 연락처 항목을 관리하는 방법을 보여줍니다.

listContacts(String id) — 지정된 폴더에서 연락처 컬렉션을 검색합니다.
fetchContact(String id) — ID로 연락처를 검색합니다.
createContact(String folderId, MapiContact contact) — 폴더에 새 연락처를 생성합니다.
updateContact(MapiContact contact) — 기존 연락처를 업데이트합니다.

IGraphClient graphClient = null;

// List Contacts
MapiContactCollection contacts = graphClient.listContacts("contactFolderId");

// Fetch Contact
MapiContact contact = graphClient.fetchContact("contactId");

// Create Contact
MapiContact newContact = new MapiContact("Jane Smith", "jane.smith@example.com", "XYZ Corporation", "777-888-999");
MapiContact createdContact = graphClient.createContact("contactFolderId", newContact);

// Update Contact
createdContact.getTelephones().setPrimaryTelephoneNumber("888-888-999");
MapiContact updatedContact = graphClient.updateContact(createdContact);

Java: Aspose.Email for Java로 Microsoft Graph에서 작업 관리

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

참조 Azure AD 설정 및 Microsoft Graph 인증 Microsoft Graph와 애플리케이션을 통합하는 방법을 배우는 기사.

Aspose.Email for Java는 Microsoft Graph를 통해 작업 관리 지원을 제공합니다. 작업 리스트를 열거하고, 생성하거나 삭제하며, 유연한 업데이트 옵션으로 작업을 관리할 수 있습니다.

아래 코드 샘플은 다음 메서드를 사용하여 작업 리스트와 작업을 관리하는 방법을 보여줍니다. GraphClient 클래스:

listTaskLists() — 모든 작업 리스트를 검색합니다.
getTaskList(String id) — 특정 작업 리스트를 검색합니다.
deleteTaskList(String id) — 작업 리스트를 삭제합니다.
listTasks(String id) — 지정된 작업 리스트의 작업들을 검색합니다.
fetchTask(String id) — ID로 작업을 검색합니다.
createTask(MapiTask task, String taskListUri) — 특정 작업 리스트에 작업을 생성합니다.
updateTask(MapiTask task) — 기존 작업을 업데이트합니다.
updateTask(MapiTask task, UpdateSettings updateSettings) — 특정 업데이트 설정으로 작업을 업데이트합니다.

// List Task Lists
GraphTaskListInfoCollection taskLists = graphClient.listTaskLists();
for (GraphTaskListInfo tList : taskLists) {
    System.out.println("Task List: " + tList.getDisplayName());
}

// Get Task List
GraphTaskListInfo taskList = graphClient.getTaskList("taskListId");

// Delete Task List
graphClient.deleteTaskList("taskListId");

// List Tasks in a Task List
MapiTaskCollection tasks = graphClient.listTasks("taskListId");

// Fetch Task
MapiTask task = graphClient.fetchTask("taskId");

// Create Task
MapiTask newTask = new MapiTask();
newTask.setSubject("New Task");
newTask.setDueDate(new Date());
newTask.setStatus(MapiTaskStatus.NotStarted);

MapiTask createdTask = graphClient.createTask(newTask, "taskListUri");

// Update Task
createdTask.setSubject("Updated Task Subject");
MapiTask updatedTask = graphClient.updateTask(createdTask);

// Update Task with UpdateSettings
UpdateSettings updateSettings = new UpdateSettings();
updateSettings.setSkipAttachments(true);
MapiTask updatedTaskWithSettings = graphClient.updateTask(createdTask, updateSettings);

Java: Microsoft Graph를 사용한 메시지 작업

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

Aspose.Email for Java는 Microsoft Graph를 통한 메시지 관리를 위한 풍부한 API 세트를 제공합니다. 메시지를 목록화, 가져오기, 생성, 업데이트, 이동, 복사 및 삭제할 수 있으며, 페이지 매김 및 첨부 파일도 처리할 수 있습니다. 아래 코드 샘플은 가장 일반적인 작업 예시입니다.

메시지 목록

Inbox와 같은 특정 폴더에서 메시지를 검색하고 전체 내용을 가져올 수 있습니다:

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

보낸 날짜별 메시지 목록

보낸 날짜를 오름차순으로 정렬하려면 다음을 사용할 수 있습니다: OrderBy 특징 GraphQueryBuilder:

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

메시지 가져오기

메시지 참조를 얻으면 전체 내용을 가져올 수 있습니다:

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

메시지 업데이트

메시지를 가져온 후 내용을 수정하고 서버에 업데이트할 수 있습니다:

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

메시지 목록 페이지 매김

대용량 사서함을 사용할 때 페이지 매김을 통해 메시지를 청크 단위로 가져올 수 있습니다. 아래 예제는 읽지 않은 메시지를 한 페이지에 두 개씩 나열하는 방법을 보여줍니다:

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

메시지 만들기

제목, 본문 및 속성을 포함한 새 메시지를 만들 수 있습니다:

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

메시지 보내기

메시지를 직접 보낼 수 있습니다:

client.send(message);

또는 초안 폴더에서 초안을 만든 후 초안 메시지를 보낼 수 있습니다:

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

메시지 복사 및 이동

메시지는 폴더 간에 복사하거나 이동할 수 있습니다:

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());
MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

첨부 파일 관리

메시지의 첨부 파일을 나열하고 제거하려면 다음 코드 샘플을 사용하십시오:

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

메시지 삭제

마지막으로, 메시지를 영구 삭제할 수 있습니다:

client.delete(message.getItemId());

Java: Microsoft Graph를 사용한 폴더 작업

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

Aspose.Email for Java는 Microsoft Graph에서 폴더 나열, 생성, 업데이트, 복사, 이동 및 삭제와 같은 다양한 폴더 작업을 수행할 수 있도록 합니다. 아래는 일반적인 시나리오 예시입니다.

폴더 목록

다음 예제는 모든 폴더를 검색하고 표시 이름과 속성을 출력합니다:

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

받은 편지함 하위 폴더 나열

특정 폴더(예: 받은 편지함) 아래의 하위 폴더를 나열할 수도 있습니다:

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

폴더 만들기

루트 레벨 폴더와 하위 폴더를 모두 만들 수 있습니다.

루트 폴더 만들기

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

하위 폴더 만들기

다음 코드 샘플은 받은 편지함 아래에 하위 폴더를 만드는 방법을 보여줍니다:

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

폴더 가져오기

다음 코드 샘플은 보낸 편지함과 같이 특정 폴더를 검색하는 방법을 보여줍니다:

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

폴더 업데이트

예를 들어 폴더 속성, 표시 이름을 업데이트할 수 있습니다:

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

폴더 및 내용 복사

다음 예제는 하위 폴더와 메시지를 포함하여 폴더를 복사하는 방법을 보여줍니다:

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

폴더 및 내용 이동

전체 내용을 포함한 폴더를 다른 위치로 이동할 수도 있습니다:

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

폴더 삭제

다음 코드 샘플을 사용하여 폴더를 영구적으로 제거하십시오:

client.delete(testFolder.getItemId());

Java: Microsoft Graph를 이용한 사서함 관리

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

메시지, 폴더 및 첨부 파일 작업 외에도 Aspose.Email for Java는 카테고리, 집중된 인박스 Overrides 및 규칙과 같은 사서함 수준 기능을 관리할 수 있게 합니다. 리소스 컨텍스트를 전환하여 다중 사서함을 작업할 수도 있습니다. 이러한 작업은 Graph API 통합을 통해 사용할 수 있습니다.

Outlook 카테고리 사용 방법

Outlook의 카테고리를 사용하면 메시지를 그룹화하고 라벨을 지정하여 조직을 쉽게 할 수 있습니다. Aspose.Email를 사용하면 프로그래밍 방식으로 카테고리를 생성, 가져오기, 업데이트, 목록화 및 삭제할 수 있습니다.

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;

// create a new category
OutlookCategory category = client.createCategory(categoryName, preset);

// fetch a category
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

// list categories
List<OutlookCategory> categories = client.listCategories();

// update a category
fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

// delete a category
client.delete(category.getId());

Overrides 사용 방법

Overrides는 특정 발신자의 메시지가 집중된 인박스에서 어떻게 처리되는지를 제어합니다. 예를 들어, 특정 발신자의 메시지를 항상 집중된 보기에 표시하도록 강제할 수 있습니다.

int focusedType = ClassificationType.Focused;

// create or update an override for a sender
ClassificationOverride override = client.createOrUpdateOverride(
    new MailAddress("testUser@host.com", "testUser"), focusedType
);

// list overrides
List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

// update override classification
ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");
ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

// reset classification
fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

// delete override
client.delete(updatedOverride.getId());

Outlook 규칙 사용 방법

사서함 규칙을 사용하면 조건에 따라 메시지를 전달하거나 필터링하는 등 자동화 작업을 수행할 수 있습니다. Graph API를 통해 인박스 규칙을 생성, 가져오기, 업데이트, 목록화 및 삭제할 수 있습니다.

// create a new rule
InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");

// define actions
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients()
    .addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

// list rules
List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

// fetch and update a rule
InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());
createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

// delete rule
client.delete(createdRule.getRuleId());

다중 사서함 작업 - 사서함 컨텍스트 전환

기본적으로 작업은 현재 사용자의 사서함에 대해 수행됩니다. 리소스 유형과 리소스 ID를 설정하면 다른 사서함(예: 공유 사서함의 메시지를 목록화)으로 컨텍스트를 전환할 수 있습니다.

// switch to another mailbox
client.setResource(ResourceType.Users);
client.setResourceId("mailbox");
client.listMessages("mailfolder");

// switch back to the current user mailbox
client.setResource(ResourceType.Me);

Microsoft Graph와 OData 쿼리

Aspose.Email for Java는 Microsoft Graph와 작업할 때 OData 쿼리를 지원합니다. 폴더, 메시지, 연락처 및 캘린더 항목과 같은 리소스를 검색할 때 고급 필터링, 정렬, 선택, 페이지 매김 및 확장을 수행할 수 있습니다. ODataQueryBuilder 클래스는 쿼리 문자열을 수동으로 작성하는 대신 구조화되고 재사용 가능한 방식으로 OData 쿼리 매개변수를 구성할 수 있게 해줍니다. 다음 메서드는 대규모 데이터 세트에 대한 카운트 및 검색에 적용할 수 있습니다:

Select 필요한 속성만 가져오기 위해.
Filter 필터를 적용하기 위해.
OrderBy 결과를 정렬하기 위해.
Top 및 Skip 페이지 매김을 위해.
Expand 단일 쿼리에서 관련 엔터티를 확장합니다.

여러 GraphClient 메서드는 선택적 ODataQueryBuilder OData 쿼리를 적용하기 위한 매개변수, 포함:

listFolders
listMessages
listContacts
listCalendarItems
listAttachments
listCategories
listOverrides
listRules
listTaskLists
listTasks
listNotebooks

다음 코드 샘플은 사용 방법을 보여줍니다 ODataQueryBuilder 폴더를 쿼리하고 고급 필터와 페이지 매김으로 메시지를 가져오기 위해:

IGraphClient client = GraphClient.GetClient();

client.setResource(ResourceType.Users);
client.setResourceId(username);
client.setEndpoint("https://graph.microsoft.com");

// Example 1: List folders ordered by name
ODataQueryBuilder builder = new ODataQueryBuilder();
builder.setOrderBy("name asc");

GraphFolderInfoCollection folders = client.listFolders(builder);
for (GraphFolderInfo folder : folders) {
    System.out.println(folder.getDisplayName());
}

String folderId = folders.get(0).getItemId();

// Example 2: Retrieve filtered and paged messages
builder = new ODataQueryBuilder();
{
    builder.setFilter("startswith(name,'A')");
    builder.setOrderBy("name asc");
    builder.setTop(10);
    builder.setSkip(5);
    builder.setSelect(new String[]{"name", "age"});
    builder.setExpand(new String[]{"children", "parents"});
    builder.setCount(true);
    builder.setSearch("\"John Doe\"");
    builder.setFormat("json");
};

GraphMessageInfoCollection msgs = client.listMessages(folderId, builder);
for (GraphMessageInfo msg : msgs) {
    System.out.println(msg.getSubject());
}

Java: Microsoft Graph에서 캘린더 항목 관리

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

참조 Azure AD 설정 및 Microsoft Graph 인증 Microsoft Graph와 애플리케이션을 통합하는 방법을 배우는 기사.

Aspose.Email for Java는 Microsoft Graph를 통해 캘린더 항목을 관리하는 지원을 제공합니다. 캘린더를 나열하고, 캘린더 이벤트를 작업하며, 업데이트 설정 여부에 관계없이 항목을 업데이트할 수 있습니다.

아래 코드 샘플은 다음 메서드를 사용하여 캘린더 항목을 관리하는 방법을 보여줍니다. GraphClient 클래스:

listCalendars() — 사용 가능한 캘린더 컬렉션을 검색합니다.
listCalendarItems(String id) — 특정 캘린더의 항목을 검색합니다.
fetchCalendarItem(String id) — ID로 캘린더 항목을 검색합니다.
createCalendarItem(String calId, MapiCalendar mapiCalendar) — 새 캘린더 항목을 생성합니다.
updateCalendarItem(MapiCalendar mapiCalendar) — 기존 캘린더 항목을 업데이트합니다.
updateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) — 사용자 정의 업데이트 설정으로 캘린더 항목을 업데이트합니다.

// List Calendars
GraphCalendarInfoCollection calendars = graphClient.listCalendars();

// List Calendar Items
MapiCalendarCollection calendarItems = graphClient.listCalendarItems("calendarId");

// Fetch Calendar Item
MapiCalendar calendarItem = graphClient.fetchCalendarItem("calendarItemId");

// Create Calendar Item
MapiCalendar newCalendarItem = new MapiCalendar();
newCalendarItem.setLocation("Conference Room");
newCalendarItem.setSubject("Team Meeting");
newCalendarItem.setBody("Discuss project status and updates.");
newCalendarItem.setStartDate(startDate);
newCalendarItem.setEndDate(endDate);

MapiCalendar createdCalendarItem = graphClient.createCalendarItem("calendarId", newCalendarItem);

// Update Calendar Item
createdCalendarItem.setLocation("Zoom Meeting");
MapiCalendar updatedCalendarItem = graphClient.updateCalendarItem(createdCalendarItem);

Java: Microsoft Graph용 GraphClient 사용 방법

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

GraphClient 사용

다음의 인스턴스: IGraphClient 클래스는 요청을 구성하고 Microsoft Graph API에 전송하며 응답을 처리합니다.

ITokenProvider 객체 만들기

새 인스턴스를 만들려면 IGraphClient 클래스에서는 인스턴스를 제공해야 합니다 ITokenProvider, Microsoft Graph에 대한 요청을 인증할 수 있습니다.

ITokenProvider tokenProvider = new ITokenProvider() {
    Date expirationDate = null;

    @Override
    public void dispose() {
    }

    @Override
    public OAuthToken getAccessToken(boolean ignoreExistingToken) {
        // Gets oAuth access token.
        // If ignoreExistingToken is true, requests new token from a server. Otherwise behavior is depended on whether token exists or not.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return null;
    }

    @Override
    public OAuthToken getAccessToken() {
        // Gets oAuth access token.
        // If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        return new OAuthToken("token", expirationDate);
    }
};

GraphClient 객체 가져오기

TokenProvider를 설정한 후에는 객체를 가져와야 합니다. IGraphClient 객체를 사용하여 서비스에 요청을 보낼 수 있습니다. 이후 IGraphClient 인증이 되면 서비스에 대한 호출을 시작할 수 있습니다.

IGraphClient client = GraphClient.getClient(tokenProvider);

Microsoft Graph를 사용한 폴더 작업

폴더 목록

GraphFolderInfoCollection folders = client.listFolders();
for (GraphFolderInfo folderInfo : folders) {
    System.out.println(folderInfo.getDisplayName());
    for (KeyValuePair<Long, MapiProperty> prop : folderInfo.getProperties()) {
        System.out.println(prop.getValue().getDescriptor().toString() + " " + prop.getValue().getString());
    }
}

받은 편지함 하위 폴더 나열

GraphFolderInfoCollection inboxFolders = client.listFolders(GraphKnownFolders.Inbox);

루트 폴더 만들기

GraphFolderInfo newFolder = client.createFolder("TEST_FOLDER");

하위 폴더 만들기

GraphFolderInfo inboxTestSubFolder1 = client.createFolder(GraphKnownFolders.Inbox, "TEST_SUBFOLDER_1");
GraphFolderInfo inboxTestSubFolder2 = client.createFolder(newFolder.getItemId(), "TEST_SUBFOLDER_2");

폴더 가져오기

GraphFolderInfo sentItemsFolder = client.getFolder(GraphKnownFolders.SentItems);

폴더 업데이트

GraphFolderInfo originalFolder = client.createFolder("TEST_FOLDER");
originalFolder.setDisplayName("NEW_TEST_FOLDER");
GraphFolderInfo updatedFolder = client.updateFolder(originalFolder);

폴더 및 내용 복사

GraphFolderInfo parentFolder = client.createFolder("PARENT_FOLDER");
GraphFolderInfo testFolder = client.createFolder("TEST_FOLDER");
GraphFolderInfo testSubFolder = client.createFolder(testFolder.getItemId(), "TEST_SUBFOLDER");

MapiMessage message = new MapiMessage();
message.setSubject("Test subject");
message.setBody("Test body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");
MapiMessage createdMessage = client.createMessage(testSubFolder.getItemId(), message);

GraphFolderInfo folderCopy = client.copyFolder(parentFolder.getItemId(), testFolder.getItemId());

GraphFolderInfoCollection folderColl = client.listFolders(parentFolder.getItemId());
// TEST_FOLDER
System.out.println(folderColl.get(0).getDisplayName());

folderColl = client.listFolders(folderColl.get(0).getItemId());
// TEST_SUBFOLDER
System.out.println(folderColl.get(0).getDisplayName());

GraphMessageInfoCollection listMessages = client.listMessages(folderColl.get(0).getItemId());
// Test subject
System.out.println(listMessages.get(0).getSubject());

폴더 및 내용 이동

GraphFolderInfo folder = client.moveFolder(parentFolder.getItemId(), testFolder.getItemId());

폴더 삭제

client.delete(testFolder.getItemId());

Microsoft Graph를 사용한 메시지 목록

GraphMessageInfoCollection messageInfoColl = client.listMessages(GraphKnownFolders.Inbox);
for (GraphMessageInfo messageInfo : messageInfoColl) {
    MapiMessage message = client.fetchMessage(messageInfo.getItemId());
}

보낸 날짜별 메시지 목록

다음은 OrderBy 이 기능은 메시지를 보낸 날짜 기준 오름차순으로 정렬하도록 지정하는 데 사용됩니다. 이를 통해 클라이언트는 메시지 목록을 GraphKnownFolders.Inbox 특정 순서대로 폴더를 정렬하는데, 여기서는 보낸 날짜를 기준으로 합니다.

다음 코드 샘플은 보낸 날짜별로 메시지를 정렬하도록 지정하는 쿼리를 만든 다음, 해당 쿼리를 사용하여 Graph API를 통해 Inbox 폴더에서 메시지 페이지를 가져오는 방법을 보여줍니다.

// create orderby messages query 'ASC'
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.getSentDate().orderBy(true);
MailQuery query = builder.getQuery();

GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(10), query);

메시지 가져오기

GraphMessageInfo messageInfo = messageInfoColl.get(0);
MapiMessage fetchedMessage = client.fetchMessage(messageInfo.getItemId());

메시지 목록 페이지 매김

API는 메시지 목록에 대한 페이지 매김 및 필터링 지원을 제공합니다. 사서함에 많은 메시지가 있어 요약 정보를 가져오는 데 많은 시간이 걸릴 때 매우 유용합니다. 아래 코드 샘플은 IGraphClient를 사용하여 Exchange Server에서 메시지를 목록화할 때 대용량 메시지 집합에 페이지 매김을 적용하는 방법을 보여줍니다.

// send ping test messages
for (int i = 0; i < 5; i++) {
    MailMessage eml = new MailMessage(user.EMail, user.EMail, "ping" + i, "test body");
    client.send(MapiMessage.fromMailMessage(eml));
}
// waiting for inbox
Thread.sleep(10000);

// paging option
int itemsPerPage = 2;
// create unread messages filter
GraphQueryBuilder builder = new GraphQueryBuilder();
builder.isRead().equals(false);
MailQuery query = builder.getQuery();

// list messages
GraphMessagePageInfo pageInfo = client.listMessages(GraphKnownFolders.Inbox, new PageInfo(itemsPerPage), query);
GraphMessageInfoCollection messages = pageInfo.getItems();
while (!pageInfo.getLastPage())
{
    pageInfo = client.listMessages(GraphKnownFolders.Inbox, pageInfo.getNextPage(), query);
    // add next page items to common collection
    messages.addRange(pageInfo.getItems());
}

// set messages state as read
for (GraphMessageInfo message : messages) {
    client.setRead(message.getItemId());
}

메시지 생성

MapiMessage message = new MapiMessage();
message.setSubject("Subject");
message.setBody("Body");
message.setProperty(KnownPropertyList.DISPLAY_TO, "to@host.com");
message.setProperty(KnownPropertyList.SENDER_NAME, "from");
message.setProperty(KnownPropertyList.SENT_REPRESENTING_EMAIL_ADDRESS, "from@host.com");

MapiMessage createdMessage = client.createMessage(GraphKnownFolders.Inbox, message);

메시지 업데이트

fetchedMessage.setSubject("Update message");
MapiMessage updatedMessage = client.updateMessage(fetchedMessage);

메시지 보내기

client.send(message);

초안 메시지 전송

MapiMessage draftMessage = client.createMessage(GraphKnownFolders.Drafts, message);
client.send(draftMessage.getItemId());

메시지 복사

MapiMessage copiedMessage = client.copyMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

메시지 이동

MapiMessage movedMessage = client.moveMessage(GraphKnownFolders.Inbox, draftMessage.getItemId());

메시지 첨부 파일

MapiAttachmentCollection attachments = client.listAttachments(fetchedMessage.getItemId());
for (MapiAttachment att : attachments) {
    client.deleteAttachment(att.getItemId());
}

메시지 삭제

client.delete(message.getItemId());

Categories API

String categoryName = "Test Category";
int preset = CategoryPreset.Preset10;
OutlookCategory category = client.createCategory(categoryName, preset);
OutlookCategory fetchedCategory = client.fetchCategory(category.getId());

List<OutlookCategory> categories = client.listCategories();

fetchedCategory.setDisplayName("Update Category");
fetchedCategory.setPreset(CategoryPreset.Preset11);
OutlookCategory updatedCategory = client.updateCategory(fetchedCategory);

client.delete(category.getId());

Overrides API

int focusedType = ClassificationType.Focused;
ClassificationOverride override = client.createOrUpdateOverride(new MailAddress("testUser@host.com", "testUser"), focusedType);

List<ClassificationOverride> list = client.listOverrides();
for (ClassificationOverride item : list)
    System.out.println(item.getSender().getAddress());

ClassificationOverride fetchedOverride = list.get(0);
fetchedOverride.setClassifyAs(ClassificationType.Other);
fetchedOverride.getSender().setDisplayName("testUser_1");

ClassificationOverride updatedOverride = client.createOrUpdateOverride(fetchedOverride);

fetchedOverride.setClassifyAs(ClassificationType.Focused);
updatedOverride = client.updateOverride(fetchedOverride);

client.delete(updatedOverride.getId());

Rules API

InboxRule rule = new InboxRule();
rule.setDisplayName("Test rule");
rule.setPriority(1);
rule.setEnabled(true);
rule.setConditions(new RulePredicates());
rule.getConditions().containsSenderStrings(new StringCollection());
rule.getConditions().containsSenderStrings().addItem("testUser");
rule.setActions(new RuleActions());
rule.getActions().setForwardToRecipients(new MailAddressCollection());
rule.getActions().getForwardToRecipients().addMailAddress(new MailAddress("testUser@host.com", "testUser", true));
rule.getActions().setStopProcessingRules(true);

InboxRule createdRule = client.createRule(rule);

List<InboxRule> listedRules = client.listRules();
for (InboxRule item : listedRules)
    System.out.println(item.getDisplayName());

InboxRule fetchedRule = client.fetchRule(createdRule.getRuleId());

createdRule.setDisplayName("Test rule 1");
createdRule.setEnabled(false);
InboxRule updatedRule = client.updateRule(createdRule);

client.delete(createdRule.getRuleId());

다중 사서함 지원을 위한 Resource 사용

сlient.setResource(ResourceType.Users);
сlient.setResourceId("mailbox");
сlient.listMessages("mailfolder")
// back to the current mailbox
сlient.setResource(ResourceType.Me);