Documentation – Làm việc với Microsoft Graph Client

Java: Các tính năng tiện ích Microsoft Graph

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

Tạo dự án trong Azure Active Directory Admin Center

Một dự án sẽ được tạo trên trung tâm quản trị Azure Active Directory cho người dùng có tài khoản MS Office.

Các bước để Tạo dự án trong Azure Active Directory Admin Center

Dưới đây là hướng dẫn bước từng bước để tạo dự án trong trung tâm quản trị Azure Active Directory.

1. Đi tới Azure Active Directory và đăng nhập bằng thông tin tài khoản MS Office của bạn.

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

2. Tạo một Ứng dụng Azure AD trong tenant của bạn.

Trong bảng bên trái, nhấp vào nhãn Azure Active Directory. Điều này sẽ mở blade cho Azure Active Directory. Trong màn hình đó, bạn sẽ thấy nhãn App registrations. Đây là điểm khởi đầu để đăng ký một Ứng dụng Azure AD. Blade này sẽ cho phép bạn tạo một ứng dụng mới cho Azure AD.

Nhấn nút New registration để tạo một ứng dụng mới.

3. Bây giờ bạn sẽ thấy blade đăng ký ứng dụng mới.

Name Đây sẽ là tên của ứng dụng của bạn.
Supported account types Phần này sẽ giới hạn quyền truy cập.

Nhấn nút Register.

4. Bạn sẽ thấy blade các ứng dụng vừa đăng ký.

Application (client) ID Id của ứng dụng của bạn.
Directory (tenant) ID Id của tenant Azure AD.

5. Cấp quyền cho Microsoft Graph API.

Nhấn vào nhãn API permissions.

Azure đã cấp cho bạn quyền User.Read được ủy quyền cho ứng dụng của bạn. Quyền này sẽ cho phép chúng ta đọc thông tin người dùng đã đăng nhập. Đây là các quyền Microsoft Graph API, hay còn gọi là Scopes.

Danh sách đầy đủ các phạm vi (scopes) cho Microsoft Graph API - https://docs.microsoft.com/en-us/graph/permissions-reference.

Nhấn nút + Add a permission và chọn Microsoft Graph.

Nhấn vào Delegated permissions. Bây giờ bạn sẽ thấy danh sách các quyền có sẵn cho Microsoft Graph API.

Chọn các quyền cần thiết, nhấn nút Add permissions.

Nhấn nút Grant admin consent.

6. Cho phép luồng client công cộng.

Xác định liệu ứng dụng là client công cộng hay không. Thích hợp cho các ứng dụng sử dụng luồng cấp token mà không dùng redirect URI.

7. Tạo khóa cho ứng dụng

Các Lớp Trợ Giúp

Các lớp trợ giúp sau đây cần thiết để chạy mã trong phần này. Những lớp này chỉ để đơn giản hoá việc minh họa.

Lớp AzureROPCTokenProvider

Một thể hiện của IGraphClient lớp xử lý việc xây dựng yêu cầu, gửi chúng tới Microsoft Graph API và xử lý các phản hồi. Để tạo một thể hiện mới của lớp này, bạn cần cung cấp một thể hiện của ITokenProvider, có thể xác thực các yêu cầu tới 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: Cài đặt Azure AD & Xác thực Microsoft Graph - Aspose.Email cho Java

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

Aspose.Email for Java cung cấp tích hợp đầy đủ với Microsoft Graph, cho phép các nhà phát triển quản lý tin nhắn, danh bạ, lịch và nhiệm vụ từ tài khoản Microsoft 365. Hướng dẫn này sẽ chỉ cho bạn cách tạo một ứng dụng Azure AD và cấu hình xác thực để bắt đầu lập trình với Aspose.Email GraphClient.

Trước khi sử dụng các API Microsoft Graph với Aspose.Email, bạn cần đăng ký một ứng dụng trong Azure Active Directory (Azure AD) và cấu hình xác thực. Trang này bao gồm:

Tạo một ứng dụng Azure AD (dự án).
Gán các quyền Microsoft Graph cần thiết.
Tạo thông tin xác thực (client ID, client secret, tenant ID).
Xác thực trong Java bằng các nhà cung cấp token Aspose.Email.

Khi hoàn thành, bạn sẽ sẵn sàng tương tác với Microsoft Graph từ ứng dụng Java của mình.

1. Tạo một Ứng dụng Azure AD

Thực hiện các bước sau để đăng ký ứng dụng của bạn trong Azure portal:

Đăng nhập vào Cổng Azure.
Đi tới Azure Active Directory → App Registrations → New Registration.

Nhập Tên cho ứng dụng của bạn (ví dụ: AsposeEmailGraphApp).
Chọn các loại tài khoản được hỗ trợ:
- Thuê đơn (nếu chỉ tổ chức của bạn sẽ sử dụng)
- Đa thuê (nếu nhiều tổ chức cần truy cập)
Tùy chọn, thiết lập Redirect URI (cần cho xác thực tương tác hoặc web).
Nhấn Register.

2. Tạo Client Secret

Sau khi đăng ký, vào Certificates & Secrets → New Client Secret.
Thêm mô tả và thời gian hết hạn.

Sao chép giá trị secret đã tạo - bạn sẽ không thể xem lại.

Giữ client secret an toàn; nó cần thiết cho xác thực client bí mật.

Bạn sẽ thấy blade các ứng dụng vừa đăng ký.

3. Cấu hình Quyền Microsoft Graph

Đi tới API Permissions → Add a Permission → Microsoft Graph.
Chọn loại quyền: Delegated hoặc Application, tùy thuộc vào kịch bản của bạn.
Thêm các quyền cần thiết cho các hoạt động của Aspose.Email:
- Contacts.ReadWrite – để quản lý danh bạ
- Calendars.ReadWrite – để quản lý lịch
- Mail.ReadWrite – để đọc và gửi tin nhắn
- Tasks.ReadWrite – để quản lý tác vụ
Nhấn Grant Admin Consent nếu cần.

4. Cho phép luồng client công cộng

Chỉ định liệu ứng dụng là client công cộng hay không. Thích hợp cho các ứng dụng sử dụng luồng cấp token mà không sử dụng redirect URI.

5. Xác thực Microsoft Graph

Các phương thức xác thực được hỗ trợ trong Aspose.Email

Xác thực bằng Client Bí mật

Sử dụng AzureConfidentialTokenProvider để xác thực khi bạn có client ID, client secret và tenant 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");

Điều này thiết lập một IGraphClient đã được xác thực đầy đủ, sẵn sàng tương tác với Microsoft Graph.

Xác thực bằng ROPC (Tên người dùng & Mật khẩu)

Đối với các trường hợp có tên người dùng và mật khẩu, sử dụng 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");

Nhà cung cấp Token Tùy chỉnh cho Microsoft Graph

Aspose.Email for Java tích hợp với Microsoft Graph thông qua IGraphClient giao diện. Để xác thực yêu cầu, một triển khai của ITokenProvider được yêu cầu. Trong khi hầu hết các nhà phát triển sẽ sử dụng các nhà cung cấp xác thực tích hợp, vẫn có những trường hợp bạn muốn tự tạo nhà cung cấp của mình, ví dụ khi làm việc với luồng Resource Owner Password Credentials (ROPC).

1. Triển khai ITokenProvider bằng AzureROPCTokenProvider

Lớp này cung cấp một triển khai của ITokenProvider sử dụng luồng Azure Resource Owner Password Credentials (ROPC). Ví dụ dưới đây chỉ mang tính minh họa. Trong môi trường sản xuất, chúng tôi đề nghị sử dụng các luồng an toàn hơn như client credentials hoặc authorization code với 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. Tạo Đối tượng ITokenProvider

Cái IGraphClient giao diện chịu trách nhiệm xây dựng các yêu cầu, gửi chúng tới Microsoft Graph và xử lý các phản hồi. Để tạo một thể hiện của IGraphClient, bạn phải cung cấp một triển khai của ITokenProvider. Nhà cung cấp token xác thực các yêu cầu bằng cách cung cấp một token truy cập OAuth hợp lệ.

Đoạn mã mẫu dưới đây minh họa cách tạo một triển khai nội tuyến cơ bản của ITokenProvider giao diện, cần thiết để xác thực các yêu cầu 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. Sử dụng Nhà cung cấp Token Tùy chỉnh

Khi ITokenProvider đã được thiết lập, bạn có thể tạo một GraphClient đối tượng. Khách hàng này sẽ sử dụng token provider được cung cấp để xác thực khi gọi 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());
}

Sau khi khách hàng được tạo và xác thực, bạn có thể bắt đầu gửi yêu cầu tới dịch vụ Microsoft Graph.

Java: Làm việc với Microsoft Graph trong Aspose.Email for Java

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

Aspose.Email for Java cung cấp tích hợp đáng tin cậy với Microsoft Graph, cho phép các nhà phát triển truy cập và quản lý dữ liệu hộp thư như tin nhắn, thư mục, liên hệ, lịch và nhiệm vụ. Sử dụng IGraphClient API, bạn có thể xác thực, truy vấn và thực hiện các thao tác trên các tài khoản Microsoft 365 trực tiếp từ các ứng dụng Java của bạn.

Các phần sau đây bao gồm các khía cạnh khác nhau của việc làm việc với Microsoft Graph trong Aspose.Email cho Java:

Xác thực với Microsoft Graph

Sử dụng Truy vấn OData trong Microsoft Graph

Quản lý Liên hệ Microsoft Graph

Quản lý Lịch Microsoft Graph

Quản lý Nhiệm vụ Microsoft Graph

Mỗi trang bao gồm các giải thích chi tiết, các phương thức API khả dụng và các ví dụ mã.

Java: Cách sử dụng GraphClient cho Microsoft Graph

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

Làm việc với GraphClient

Một thể hiện của IGraphClient lớp xử lý việc xây dựng các yêu cầu, gửi chúng tới Microsoft Graph API và xử lý các phản hồi.

Tạo một Đối tượng ITokenProvider

Để tạo một thể hiện mới của IGraphClient lớp, bạn cần cung cấp một thể hiện của ITokenProvider, có thể xác thực các yêu cầu tới 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);
    }
};

Lấy một đối tượng GraphClient

Sau khi bạn đã thiết lập TokenProvider, bạn phải lấy một IGraphClient đối tượng để thực hiện yêu cầu tới dịch vụ. Sau khi bạn có một IGraphClient khi đã được xác thực, bạn có thể bắt đầu thực hiện các cuộc gọi tới dịch vụ.

IGraphClient client = GraphClient.getClient(tokenProvider);

Làm việc với Thư mục bằng Microsoft Graph

Liệt kê thư mục

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

Liệt kê thư mục con từ thư mục Inbox

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

Tạo Thư mục Gốc

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

Tạo Thư mục Con

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

Lấy thư mục

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

Cập nhật thư mục

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

Sao chép Thư mục và Nội dung

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

Di chuyển Thư mục và Nội dung

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

Xóa thư mục

client.delete(testFolder.getItemId());

Liệt kê Tin nhắn bằng Microsoft Graph

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

Liệt kê Tin nhắn theo Ngày Gửi

Cái OrderBy tính năng này được sử dụng để chỉ ra rằng các tin nhắn nên được sắp xếp tăng dần theo ngày gửi. Điều này cho phép client truy xuất danh sách tin nhắn từ GraphKnownFolders.Inbox thư mục theo một thứ tự cụ thể, trong trường hợp này, dựa trên

Mẫu mã sau đây minh họa cách tạo một truy vấn chỉ định việc sắp xếp tin nhắn theo ngày gửi, sau đó sử dụng truy vấn này để lấy một trang tin nhắn từ thư mục Hộp đến bằng Graph API:

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

Lấy Tin nhắn

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

Phân trang trong danh sách Tin nhắn

API cung cấp hỗ trợ phân trang và lọc khi liệt kê tin nhắn. Điều này rất hữu ích khi một hộp thư có số lượng tin nhắn lớn và cần nhiều thời gian để lấy thông tin tóm tắt về chúng. Mẫu mã dưới đây sẽ chỉ cho bạn cách sử dụng phân trang cho các tập tin nhắn lớn khi liệt kê tin nhắn từ Exchange Server bằng IGraphClient:

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

Tạo Tin nhắn

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

Cập nhật Tin nhắn

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

Gửi Tin nhắn

client.send(message);

Gửi Tin nháp

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

Sao chép Tin nhắn

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

Di chuyển Tin nhắn

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

Tệp đính kèm Tin nhắn

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

Xóa Tin nhắn

client.delete(message.getItemId());

API Danh mục

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

API Overrides

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

API Quy tắc

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

Sử dụng Resource để Hỗ trợ Nhiều Hộp thư

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

Java: Làm việc với Thư mục bằng Microsoft Graph

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

Aspose.Email cho Java cho phép bạn thực hiện nhiều thao tác thư mục trong Microsoft Graph, như liệt kê, tạo, cập nhật, sao chép, di chuyển và xóa thư mục. Dưới đây là các ví dụ về các kịch bản thường gặp.

Liệt kê thư mục

Ví dụ sau lấy tất cả các thư mục và in ra tên hiển thị cùng các thuộc tính của chúng:

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

Liệt kê thư mục con từ thư mục Inbox

Bạn cũng có thể liệt kê các thư mục con dưới một thư mục cụ thể, chẳng hạn Inbox:

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

Tạo thư mục

Bạn có thể tạo cả thư mục cấp gốc và thư mục con.

Tạo thư mục gốc

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

Tạo thư mục con

Mẫu mã sau đây cho thấy cách tạo thư mục con dưới thư mục Inbox:

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

Lấy thư mục

Mẫu mã sau đây minh họa cách lấy một thư mục cụ thể, chẳng hạn Thư đã gửi:

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

Cập nhật thư mục

Bạn có thể cập nhật các thuộc tính của thư mục, ví dụ như tên hiển thị:

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

Sao chép thư mục và nội dung của nó

Ví dụ sau đây cho thấy cách sao chép một thư mục cùng các thư mục con và tin nhắn của nó:

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

Di chuyển thư mục và nội dung của nó

Bạn cũng có thể di chuyển một thư mục cùng toàn bộ nội dung tới vị trí khác:

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

Xóa thư mục

Sử dụng mẫu mã sau để xóa vĩnh viễn một thư mục:

client.delete(testFolder.getItemId());

Java: Làm việc với Tin nhắn bằng Microsoft Graph

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

Aspose.Email for Java cung cấp một bộ API phong phú để quản lý tin nhắn thông qua Microsoft Graph. Bạn có thể liệt kê, lấy, tạo, cập nhật, di chuyển, sao chép và xóa tin nhắn, cũng như xử lý phân trang và tệp đính kèm. Các mẫu mã dưới đây là các ví dụ về các thao tác phổ biến nhất.

Liệt kê Tin nhắn

Bạn có thể lấy tin nhắn từ một thư mục cụ thể, chẳng hạn như Hộp đến, và lấy toàn bộ nội dung của chúng:

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

Liệt kê Tin nhắn theo Ngày Gửi

Để sắp xếp tin nhắn theo ngày gửi tăng dần, bạn có thể sử dụng OrderBy tính năng của 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);

Lấy Tin nhắn

Khi bạn có tham chiếu tới một tin nhắn, bạn có thể lấy nội dung đầy đủ của nó:

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

Cập nhật Tin nhắn

Sau khi lấy một tin nhắn, bạn có thể sửa đổi nội dung của nó và cập nhật lên máy chủ:

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

Phân trang trong danh sách Tin nhắn

Khi làm việc với hộp thư lớn, bạn có thể sử dụng phân trang để truy xuất tin nhắn theo từng phần. Ví dụ dưới đây minh họa việc liệt kê các tin nhắn chưa đọc theo các trang, mỗi trang có hai mục:

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

Tạo Tin nhắn

Bạn có thể tạo tin nhắn mới với tiêu đề, nội dung và các thuộc tính:

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

Gửi Tin nhắn

Bạn có thể gửi tin nhắn trực tiếp:

client.send(message);

Hoặc gửi một tin nháp sau khi tạo nó trong thư mục Nháp:

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

Sao chép và Di chuyển Tin nhắn

Tin nhắn có thể được sao chép hoặc di chuyển giữa các thư mục:

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

Quản lý Đính kèm

Để liệt kê và xóa các tệp đính kèm từ một tin nhắn, sử dụng đoạn mã mẫu dưới đây:

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

Xóa một Tin nhắn

Cuối cùng, bạn có thể xóa một tin nhắn vĩnh viễn:

client.delete(message.getItemId());

Java: Quản lý danh bạ trong Microsoft Graph với Aspose.Email for Java

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

Tham khảo Cài đặt Azure AD và Xác thực Microsoft Graph bài viết để tìm hiểu cách tích hợp ứng dụng của bạn với Microsoft Graph.

Aspose.Email for Java cung cấp hỗ trợ quản lý danh bạ thông qua Microsoft Graph. Bạn có thể liệt kê, truy xuất, tạo và cập nhật danh bạ trực tiếp từ các thư mục danh bạ.

Mẫu mã dưới đây minh họa cách quản lý các mục danh bạ bằng cách sử dụng các phương thức sau của thư viện:

listContacts(String id) — Lấy một bộ sưu tập các danh bạ từ thư mục đã chỉ định.
fetchContact(String id) — Lấy một danh bạ theo ID của nó.
createContact(String folderId, MapiContact contact) — Tạo một danh bạ mới trong một thư mục.
updateContact(MapiContact contact) — Cập nhật một danh bạ hiện có.

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: Quản lý Hộp thư với Microsoft Graph

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

Không chỉ làm việc với tin nhắn, thư mục và tệp đính kèm, Aspose.Email cho Java còn cho phép bạn quản lý các tính năng cấp hộp thư như danh mục, overrides hộp đến tập trung và quy tắc. Bạn cũng có thể làm việc với nhiều hộp thư bằng cách chuyển đổi ngữ cảnh tài nguyên. Những thao tác này có sẵn thông qua tích hợp Graph API.

Cách làm việc với Danh mục Outlook

Danh mục trong Outlook cho phép bạn nhóm và gắn nhãn các tin nhắn để tổ chức dễ hơn. Với Aspose.Email, bạn có thể tạo, lấy, cập nhật, liệt kê và xóa danh mục một cách lập trình.

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

Cách làm việc với Overrides

Overrides kiểm soát cách các tin nhắn từ một số người gửi nhất định được xử lý trong Hộp đến Chủ động. Ví dụ, bạn có thể buộc các tin nhắn từ một người gửi cụ thể luôn xuất hiện trong chế độ xem chủ động.

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

Cách làm việc với Quy tắc Outlook

Quy tắc hộp thư cho phép bạn tự động hoá các hành động như chuyển tiếp tin nhắn hoặc lọc dựa trên các điều kiện. Graph API cho phép tạo, lấy, cập nhật, liệt kê và xóa các quy tắc hộp đến.

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

Làm việc với Nhiều Hộp thư - Chuyển đổi Ngữ cảnh Hộp thư

Mặc định, các thao tác được thực hiện trên hộp thư của người dùng hiện tại. Bạn có thể chuyển ngữ cảnh sang một hộp thư khác (ví dụ, để liệt kê tin nhắn từ hộp thư chia sẻ) bằng cách đặt loại tài nguyên và ID tài nguyên.

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

Truy vấn OData với Microsoft Graph

Aspose.Email cho Java cung cấp hỗ trợ cho các truy vấn OData khi làm việc với Microsoft Graph. Nó cho phép bạn thực hiện lọc nâng cao, sắp xếp, chọn, phân trang và mở rộng khi truy xuất các tài nguyên như thư mục, tin nhắn, liên hệ và mục lịch. Các ODataQueryBuilder lớp cho phép bạn xây dựng các tham số truy vấn OData một cách có cấu trúc và có thể tái sử dụng thay vì tự tay xây dựng chuỗi truy vấn. Các phương thức sau có thể được áp dụng để đếm và tìm kiếm trên các tập dữ liệu lớn:

Select để chỉ lấy các thuộc tính bạn cần.
Filter để áp dụng bộ lọc.
OrderBy để sắp xếp kết quả.
Top và Skip để phân trang.
Expand để mở rộng các thực thể liên quan trong một truy vấn duy nhất.

Một số GraphClient các phương thức chấp nhận một tùy chọn ODataQueryBuilder tham số để áp dụng các truy vấn OData, bao gồm:

listFolders
listMessages
listContacts
listCalendarItems
listAttachments
listCategories
listOverrides
listRules
listTaskLists
listTasks
listNotebooks

Mẫu mã dưới đây cho thấy cách sử dụng ODataQueryBuilder để truy vấn các thư mục và lấy tin nhắn với các bộ lọc và phân trang nâng cao:

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: Quản lý Mục Lịch trong Microsoft Graph

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

Tham khảo Cài đặt Azure AD và Xác thực Microsoft Graph bài viết để tìm hiểu cách tích hợp ứng dụng của bạn với Microsoft Graph.

Aspose.Email for Java cung cấp hỗ trợ quản lý các mục lịch thông qua Microsoft Graph. Bạn có thể liệt kê các lịch, làm việc với các sự kiện lịch và cập nhật các mục có hoặc không có cài đặt cập nhật.

Mẫu mã dưới đây minh họa cách quản lý các mục lịch bằng cách sử dụng các phương thức sau của GraphClient lớp:

listCalendars() — Lấy một bộ sưu tập các lịch có sẵn.
listCalendarItems(String id) — Lấy các mục lịch cho một lịch cụ thể.
fetchCalendarItem(String id) — Lấy một mục lịch theo ID của nó.
createCalendarItem(String calId, MapiCalendar mapiCalendar) — Tạo một mục lịch mới.
updateCalendarItem(MapiCalendar mapiCalendar) — Cập nhật một mục lịch hiện có.
updateCalendarItem(MapiCalendar mapiCalendar, UpdateSettings updateSettings) — Cập nhật một mục lịch với các cài đặt cập nhật tùy chỉnh.

// 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: Quản lý tác vụ trong Microsoft Graph với Aspose.Email for Java

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

Tham khảo Cài đặt Azure AD và Xác thực Microsoft Graph bài viết để tìm hiểu cách tích hợp ứng dụng của bạn với Microsoft Graph.

Aspose.Email for Java cung cấp hỗ trợ quản lý tác vụ thông qua Microsoft Graph. Bạn có thể liệt kê các danh sách tác vụ, tạo hoặc xóa chúng, và quản lý tác vụ với các tùy chọn cập nhật linh hoạt.

Mẫu mã dưới đây minh họa cách quản lý danh sách tác vụ và các tác vụ bằng cách sử dụng các phương thức sau của GraphClient lớp:

listTaskLists() — Lấy tất cả các danh sách tác vụ.
getTaskList(String id) — Lấy một danh sách tác vụ cụ thể.
deleteTaskList(String id) — Xóa một danh sách tác vụ.
listTasks(String id) — Lấy các tác vụ cho một danh sách tác vụ cho trước.
fetchTask(String id) — Lấy một tác vụ theo ID của nó.
createTask(MapiTask task, String taskListUri) — Tạo một tác vụ trong một danh sách tác vụ cụ thể.
updateTask(MapiTask task) — Cập nhật một tác vụ hiện có.
updateTask(MapiTask task, UpdateSettings updateSettings) — Cập nhật một tác vụ với các cài đặt cập nhật cụ thể.

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